Manual Técnico EcoPhone

Requisitos y Material

1 x Raspberry Pi Modelo B
2 x Tarjeta Micro SDHC 16GB o más
Conexión a Internet
1 x Yeastar TG100
N x Teléfono SIP
1 x Teléfono analógico
1 x Linksys SPA3000

Instalación de RasPBX

Nosotros usaremos una distro de Raspbian para Raspberry preparada con FreePBX, también podemos instalar Raspbian y seguir el siguiente manual.

https://wiket.esteveterradas.cat/index.php/FreePBX_en_Raspberry_Pi_3

Descargar las herramientas necesarias

Imagen RasPBX

RasPBX es una distro especializada en FreePBX para raspberry optimizado para mejorar su funcionalidad. Para obtener RasPBX debemos acceder al siguiente enlace.
Habrá que descomprimir el zip una vez descargado para poder usar el archivo con extensión .img

http://www.raspberry-asterisk.org/downloads/

SD Formatter

Una vez descargado necesitamos los programas adecuados para insertar la imagen en la MicroSD. El primer paso es formatear la MicroSD con SD Formatter descargándolo desde el siguiente enlace:

https://www.sdcard.org/downloads/formatter_4/

Win32DiskImager

Y por último para poder insertar la imagen en la MicroSD descargamos el programa Win32DiskImager desde el siguiente enlace:

https://sourceforge.net/projects/win32diskimager/

Aplicando las herramientas

SD Formatter

Escogemos cuidadosamente la unidad que queremos formatear, y sin tocar ninguna opción Format, esto nos preparará la SD para escribir la imagen:

Win32DiskImager

Cuando ejecutamos el programa nos deja escoger una unidad en la que marcaremos la MicroSD y debemos especificar la ruta donde se encuentra la imagen de RasPBX con extensión .img. Clic en Write y empezará a volcar la imagen en la tarjeta.

Una vez terminado el proceso, sacamos la MicroSD con seguridad y la insertamos en la raspberry.  

Configuración Inicial RaspPBX

Opción A - Para acceder a la raspberry debemos usar teclado y monitor.
Opción B - Acceder por Putty es posible ya que RasPBX viene con el puerto 22 abierto, la IP llegará por DHCP, se recomienda un sniffer para ver que IP tiene, por ejemplo Advanced IP Scanner.

Usuario y contraseña por defecto son:

User: root
Pw: raspberry

Si queremos seguir usando SSH de forma segura con nuestra raspberry lo mejor es crear un nuevo usuario con derechos de administrador y deshabilitar el usuario root del login en SSH.

Crear un usuario con permisos de administrador:

~# adduser super									

Le ponemos la contraseña, nombres y lo que queramos. Al terminar nos dirigimos al archivo /etc/sudoers y añadimos esta linea para que nuestro nuevo usuario también tenga permisos root.

Para denegar al usuario root de SSH modificamos el archivo /etc/ssh/sshd_config:

- En la línea que especifica si root puede hacer login ponemos que no, al terminar de editar el fichero lo guardamos y salimos. Paso seguido reiniciamos.

Tras terminar esta configuración y haber reiniciado, iniciamos sesión con el usuario creado anteriormente, y cambiamos de usuario a root con el comando su tras pasar el login para modificar archivos y evitar errores de configuración ya que todos los archivos pertenecen a root.

Tras hacer dichos cambios, FreePBX será accesible desde nuestra IP

Configuración del mail transfer agent (MTA)

En EcoPhone nos solicitaron poder conectarse a su servicio de correo externo y que el buzón de voz estuviese relacionado con ése correo. En ese caso configuramos Exim4 para nuestra FreePBX.

En primer lugar, como usamos Exim4, deberemos especificar que queremos reconfigurar el paquete con el comando:

~# dpkg-reconfigure exim4-config

Teniendo los datos de nuestro dominio necesitamos el nombre de dominio y el nombre del dominio de correo, en nuestro caso los datos son estos:

Nombre de dominio: miquelsis2.ml
Nombre del dominio de correo: mail.miquelsis2.ml

Y seguir los siguientes pasos:
- Paso 1, escoger la siguiente opción:

El correo se envía mediante un <<smarthost>>; Se recibe a través de SMTP o fetchmail.
- Paso 2, rellenamos con el nombre de dominio:
Introducimos miquelsis2.ml > Siguiente

- Paso 3, seguimos y nos preguntara que direcciones provenientes de conexiones SMTP va a escuchar, dejamos puesta la dirección loopback:

127.0.0.1

- Paso 4, en la sección que pregunta en qué otros destinos es aceptado el mail dejamos en blanco y seguimos adelante.
- Paso 5, en la siguiente sección nos pregunta si queremos seleccionar alguna maquina para replicar el mail, vamos a dejar en blanco esta sección.
- Paso 6, ponemos el nombre o IP de nuestro smarthost, y vamos a usar el puerto 587, en este caso es:

mail.miquelsis2.ml::587

- Paso 7, seleccionamos “No” en la sección de ocultar el local mail name.
- Paso 8, seleccionamos “No” en la sección Dial-on-demand.
- Paso 9, seleccionamos la opción “mbox format in /var/mail”
- Paso 10, seleccionamos “Si” en la sección de partir los archivos de correo en pequeños archivos.

Añadir Módulos a FreePBX

Entramos en FreePBX a través del navegador poniendo la dirección de nuestra RasPBX, y vamos a la sección de Module Admin, para agregar y gestionar los módulos de FreePBX.

Existen los módulos no comerciales y los que sí que son comerciales, para usar los módulos comerciales se debe tener una licencia de FreePBX, podemos ver las siguientes ofertas desde la página oficial de FreePBX.

https://www.freepbx.org/store/commercial-modules/

Gestor de modulos: Admin > Module Admin

Instalar módulos

Una vez dentro del module admin podemos ver todos los módulos de los que dispone FreePBX actualmente, para añadir nuevos módulos, vamos a la sección [Check Online] .Seleccionamos los módulos que queramos instalar.

Buscando el módulo que queramos, hacemos clic encima, y si es compatible nos dejará descargar el módulo e instalarlo haciendo clic en [Download and Install], cuando hayamos seleccionado los módulos que queramos instalar.

Seleccionamos [Process] para efectuar todos los cambios.

Actualizar módulos a su última versión

Para actualizar los módulos necesitamos ir a la sección de [Check Online] y seleccionar la opción [upgrade all] y seguidamente, [Process] , se actualizarán todos los módulos con actualizaciones pendientes.  

Lista de módulos necesarios

TTS Engines

Configuración del TTS Engine

TTS Engine, es un módulo de FreePBX que nos permite crear archivos de audio a partir de un fichero de texto, trabaja conjuntamente con el módulo Text To Speech.

Éste módulo viene con las siguientes TTS Engine funcionales:

- Flite (Festival)
- Texto To Wave
- Swift
- Pico

Nosotros vamos a usar GoogleTTS, una engine creada para que genere archivos de audio con la voz de google para Asterisk, ya que no nos gustan mucho las opciones que nos proporcionan.
Normalmente, el módulo de TTS Engine no fue diseñado para aceptar más que los engines que lleva por defecto. Pero se puede añadir por métodos convencionales, aquí la explicación.

- Primero debemos descargar el paquete de su repositorio en Github.

https://github.com/zaf/asterisk-googletts

Para que funcione correctamente necesitamos instalar las siguientes dependencias, vamos a instalarlas.

~# apt-get install libwww-perl libcrypt-ssleay-perl

- Una vez descargado deberemos poner los archivos googletts.agi y googletts-tiny.agi en la carpeta /var/lib/asterisk/agi-bin/

Y ponemos el archivo googletts-cli-tiny.pl y el googletts-cli.pl en directorio /usr/bin/googleTTS/, si no existe lo creamos manualmente. Dentro ubicamos los dos archivos, que a continuación utilizaremos.

Creación del IVR

El IVR es un terminal que indica opciones al usuario y le permite ir por diferentes caminos y ser redirigido a diferentes lugares de la centralita. Para crear uno nuevo vamos a Applications -> IVR y creamos los siguientes. Con esto lograremos un menú bilingue, pero aún faltan los TTS para poder ser terminados. Esperar a ver la siguiente seccioón para terminar de configurar estos IVR.

IVR Name: IVRbase
IVR Description:
Announcement: 
Enable Direct Dial: Yes No
Timeout: 5
Alert Info: 
Ringer Volume Override: 
Invalid Retries: 1
Invalid Retry Recording: 
Append Announcement to Invalid: Yes No
Return on Invalid: Yes No
Invalid Recording:  
Invalid Destination:  
Timeout Retries: 0
Append Announcement on Timeout: Yes No
Return on Timeout: Yes No
Timeout Recording:  
Timeout Destination: Terminate call -> Busy  
Return to IVR after VM Yes No
-----
IVR Entries
Digits	  Destination
1       Text To Speech -> welcome
2       Text To Speech -> Buenos Días

IVR Name: IVRcastellano
IVR Description:  
IVR DTMF Options:
Announcement:  
Enable Direct Dial: Yes No
Timeout: 10
Alert Info:  
Ringer Volume Override:  
Invalid Retries: 3
Invalid Retry Recording:  
Append Announcement to Invalid: Yes No
Return on Invalid: Yes No
Invalid Recording:  
Invalid Destination: Terminate Call -> Hangup  
Timeout Retries: 0
Append Announcement on Timeout: Yes No
Return on Timeout: Yes No
Timeout Recording:  
Timeout Destination: Extensions -> 103 Conserjería
Return to IVR after VM: Yes No
-----
IVR Entries
Digits	Destination
1       Extensions -> 102 Administración
2       Extensions -> 103 Conserjería
3       Voicemail -> 103 Conserjería (Busy Message)

IVR Name: IVRenglish
IVR Description:  
IVR DTMF Options:
Announcement:  
Enable Direct Dial: Yes No
Timeout: 10
Alert Info:  
Ringer Volume Override:  
Invalid Retries: 3
Invalid Retry Recording:  
Append Announcement to Invalid: Yes No
Return on Invalid: Yes No
Invalid Recording:  
Invalid Destination: Terminate Call -> Hangup  
Timeout Retries: 0
Append Announcement on Timeout: Yes No
Return on Timeout: Yes No
Timeout Recording:  
Timeout Destination: Extensions -> 103 Conserjería
Return to IVR after VM: Yes No
-----
IVR Entries
Digits	Destination
1       Extensions -> 102 Administración
2       Extensions -> 103 Conserjería
3       Voicemail -> 103 Conserjería (Busy Message)

Creación de las TTS Engines

Dentro del FreePBX seleccionamos la pestaña Settings > Text To Speech Engines

En la sección del módulo podemos ver todas las engines que tenemos activas, deberemos añadirla como una nueva engine.

Una vez dentro, en Engine Name colocamos la opción custom y le indicamos un nombre, en el Engine Path indicamos la ruta del los archivos google-tts.

/usr/bin/googleTTS/googletts-cli-tiny.pl 

Utilizaremos el tiny porque Raspberry tiene un espacio de almacenamiento muy limitado y no puede aguantar demasiada carga por lo que esta opción más ligera es mucho más recomendada.

Una vez creada la Engine no va a funcionar de primeras, deberemos editar el script que genera los TTS, para ello vamos a añadir un case por cada Engine custom de Google que hagamos, las siguientes líneas son las que vienen por defecto en el script. Pero añadimos dos case tras las engines que vienen por defecto.
Creamos dos TTS Engine, una llamada googleTTS que nos generará audios en español, y otra llamada googleTTSen que será en inglés.

Modificación del script

Editamos el fichero /var/www/html/admin/modules/tts/agi-bin/propolys-tts.agi

Las líneas en negrita son las añadidas en el fichero. Incluyo el resto de líneas para ubicar las líneas del script que tenemos que modificar.

if ( !file_exists($wavefile) ) {
       debug("Text to speech wave file doesnt exist, lets create it.", 1);
       if ( false === ($fh = fopen($textfile, "w")) ) {
               debug("ERROR: Cannot open the file: $textfile", 1);
               return 1;
       }
       if ( false === fwrite($fh, $text) ) {
               debug("ERROR: Cannot write to file: $textfile", 1);
               return 1;
       }
       fclose($fh);
       debug("Executing $engine", 1);
       switch ($engine) {
               case 'text2wave':
                       exec($enginebin." -f ".$format['rate']." -o $tmpwavefile $textfile");
               break;
               case 'flite':
                       exec($enginebin." -f $textfile -o $tmpwavefile");
               break;
               case 'swift':
                       exec($enginebin." -p audio/channels=1,audio/sampling-rate=".$format['rate']." -o $tmpwavefile -f $textfile");
               break;
               case 'pico':
                       exec($enginebin." -o $tmpwavefile ".escapeshellarg(file_get_contents($textfile)));
               break;
               case 'googleTTS':									                
                       exec($enginebin." -l es -f $textfile -r 8000 -o $wavefile");			
               break;										
               case 'googleTTSen':									
                       exec($enginebin." -l en -f $textfile -r 8000 -o $wavefile");			
               break;										
               default:											
                       debug("$engine is not a valid engine!", 1);							
               break;											
       }
}

Explicación del código

Éste script genera un fichero de audio con el comando que hay dentro de cada case, éste comprueba por nombre de engine, por lo que dándole el mismo nombre como engine, seguidamente crea un archivo de audio con el idioma seleccionado. En el repositiorio de Github del Engine TTS de Google se pueden ver listados todos los idiomas soportados.
Internamente va a buscar el .agi de la engine donde contiene todo el proceso de creación del archivo wav.

Por último usamos este comando:

chmod 550 /var/www/html/admin/modules/tts/agi-bin/propolys-tts.agi 

Ya que no queremos que cambie el contenido del fichero, nos ahorramos de que cambien las líneas en el script de arriba.

¡Al realizar los cambios, FreePBX nos avisará de que se ha modificado un fichero del módulo! No pasa nada por haberlo modificado. Hay que ignorar ese error.

Creacion de Text To Speech

Una vez hemos agregado la engine y está disponible para su uso, para crear un archivo de sonido y poder usarlo vamos a:
Applications -> Text To Speech

Name: Home-Idioma
Text: Hello, if you want to be attended in English, press 1
Choose an Engine: googleTTSen
Destintation: Text To Speech -> Home-Idioma2 

Name: Home-Idioma2
Text: Para seguir hablando castellano pulse 2.
Choose an Engine: googleTTS
Destintation: IVR -> IVR base

Name: buenos dias
Text: Buenos días, estás llamando a la red telefónica del Instituto Asteve Tarradas. Si quieres hablar con administración. Marque 1. Para hablar con conserjería. Marque 2. Para dejar un mensaje de voz marque 3 o espere.
Choose an Engine: googleTTS
Destintation: IVR -> IVRcastellano

Name: welcome
Text: Good morning, you're calling the Asteve Tarradas Institute telephone network. If you want to talk to management. Mark 1. To talk to a concierge. Mark  2. To leave a voice message. Mark 3 or just wait.
Choose an Engine: googleTTS
Destintation: IVR -> IVRenglish

Configuración de Time Conditions y Time Groups

Usando la guía a continuación podemos ver cómo funciona el módulo:

https://wiket.esteveterradas.cat/index.php/Time_Conditions_FreePBX

Configuración del Time Group

Con ésta configuración obtendremos un horario de las 8 de la mañana hasta las 21 de la tarde, todos los dias del mes, todos los meses y de lunes a viernes.

Time to Start: 8:00
Time to finish: 21:00
Week Day Start: Monday
Week Day finish: Friday
Month Day start: 1
Month Day finish: 31
Month start: January
Month finish: December

Configuración del Time Conditions

Time Condition name: Horario trabajo 
Override Code Pin: 
Invert BLF Hint Yes No
Change Override: Unchanged
Current: No Override
Time Zone: Europe/Madrid
Time Group: Horario Trabajo
Destination matches: Announcements -> Home
Destination non-matches: Voicemail -> Vozdesatan

Conectividad del sistema VoIP

Para que toda la infraestructura pueda comunicarse se necesitan establecer rutas estáticas tanto de salida como de entrada. Las rutas salientes necesitan un trunk para autenticar a los usuarios salientes por la ruta de salida.

El direccionamiento es el siguiente:

Raspberry – FreePBX: 10.27.3.110/16
Elastix : 10.27.100.9/16
Yeastar – Gateway: 10.27.3.165/16
Linksys SPA3000: 10.27.3.118/16

Una vez configurados todos los elementos, ya podemos empezar. Para editar la configuración LAN del Yeastar y Linksys, se puede ver mas abajo, en la sección de configuración de Yeastar TP100.

Inbound Routes

Creamos una Inbound Route de la siguiente manera:

https://wiket.esteveterradas.cat/index.php/Inbound_Routes_FreePBX

Y la hacemos de la siguiente manera:

Description: Operadora
DID Number: ANY
CallerID Number: ANY
CID Priority Route (Yes|No): Yes
Ringer Volume Override: None
CID name prefix:
Music On Hold: Default
Set Destination: Time Conditions -> Horario Trabajo

Trunks en FreePBX

A continuación muestro en una guía comos se crean trunks en FreePBX:

https://wiket.esteveterradas.cat/index.php/Trunks_VoIP

Creamos los siguientes trunks en nuestro FreePBX:

Trunk IAX hacia Elastix

General
Opción	Descripción
Disable Trunk: No	
Hide CallerID: No	
Trunk name: pbxlink	
CID Options: Allow any CID	
Maximum Channels:	
IAX Settings[Outgoing]
Opción	Descripción
Trunk name: pbxlink	
Peer Details
host=10.27.3.110
user=pbx2
secret=password
type=peer	
qualify: yes
IAX Settings[Incoming]
Opción	Descripción
User context: pbx1
Peer Details
secret=password
type=user
context=from-trunk

Trunk SIP hacia Yealink

General
Opción	Descripción
Disable Trunk: No
Hide CallerID: No	
Trunk name: Yealink	
CID Options: Allow any CID	
Maximum Channels:  1	
sip Settings[Outgoing]
Opción	Descripción
Trunk name: Yealink	
Peer Details
host=10.27.3.165
type=peer
qualify=yes
disallow=all
allow=gsm,ulaw,alaw	
Host: IP de nuestra gateway VoIP
qualify: yes

Trunk hacia Linksys SPA3000

Ahora con todos los datos añadidos en nuestro FXO necesitamos que conecte con FreePBX, para ello añadimos un nuevo trunk, le daremos el nombre “To_Linksys” y en sip Settings le damos la siguiente configuración:

General
Disable Trunk: No	
Hide CallerID: No	
Trunk name: To_Linksys
CID Options: Allow any CID
Maximum Channels:
sip Settings[Outgoing]
Trunk name: To_Linksys
Peer Details
host=10.27.3.118
type=friend
user=Linksys
secret=1
port=5060
qualify=yes
context=from-pstn
disallow=all
allow=gsm,ulaw,alaw

Outbound Routes FreePBX

Con la finalidad de que nuestro FreePBX deje salir las llamadas hacia fuera, le indicaremos en los siguientes parámetros quienes si y quienes no pueden salir y con que trunk conectará. Ruta hacia Yeastar TG100

Entramos a la sección Connectivity → Outbound Routes

Ruta hacia Yeastar TG100

Y configuramos la ruta de la siguiente manera:

Dial patterns

Ruta hacia Elastix

Creamos una nueva Outbound Route llamada PBX1_to_PBX2

Dial patterns

Ruta hacia Linksys SPA3000

Podemos utilizar la misma ruta de salida “PBX1_to_PBX2” ya que los usuarios conectados a través de Linksys SPA3000 son los usuarios de FreePBX. Colocaremos el trunk “To_Linksys” seguido del trunk “pbxlink”

Configuración de Elastix

Inbound Routes

Para acceder a las rutas de entrada debemos ir por el menú a la sección PBX

Seguidamente encontramos la sección en el menú lateral:

Con esta configuración decimos que cualquier CID pueda pasar por la ruta entrante.

Y especificamos que queremos que acceda al grupo de extensiones 1100.

Trunks de Elastix

Para crear líneas troncales en elastix, debemos dirigirnos al menú lateral de PBX y entramos en troncales.

Elastix hacia FreePBX

Creamos una línea troncal IAX hacia FreePBX relacionando el contexto de usuario y la contraseña.

General
Disable Trunk: No	
Hide CallerID: No	
Trunk name: pbxlink	
CID Options: Allow any CID	
Maximum Channels:	
Opciones salientes
Trunk name: pbxlink	
host=10.27.3.110
user=pbx1
secret=password
context=from-trunk
disallow=all
allow=gsm,ulaw,alaw
Opciones entrantes
User context: pbx1
Peer Details
secret=password
type=user
context=from-trunk

Trunk hacia Yeastar TG100

Para que los usuarios de elastix también puedan salir, haremos también un trunk SIP, de esta forma no tienen que hacer dos saltos, además de que hacer más de un salto en la configuración interna siempre trae confusiones.

General
Disable Trunk: No	
Hide CallerID: No	
Trunk name: Yealink	
CID Options: Allow any CID	
Maximum Channels:  1	
sip Settings[Outgoing]
Opción	Descripción
Trunk name: Yealink	
Peer Details
host=10.27.3.165
type=peer
qualify=yes
disallow=all
allow=gsm,ulaw,alaw	

Outbound Routes Elastix

Para crear rutas salientes nos dirijimos al menú lateral de PBX y seleccionamos rutas salientes:

Ruta hacia Yeastar TG100

Vamos a crear una ruta saliente para todo el trafico que vaya al exterior, y que para ello se conecte al Yeastar.

Añadimos el trunk “Yealink” previamente creado:

 

Ruta hacia FreePBX

Ahora toca crear la ruta que queda para interconectar FreePBX con Elastix y que sus usuarios puedan acceder al trunk y verse entre ellos. Copiar esta configuración.

Configuración de Yeastar TG100

Éste aparato nos permitirá acceder a las redes móviles desde la red interna para poder realizar llamadas al exterior. Necesita de una tarjeta SIM para conectarse a red PSTN, un cable de alimentación i conexión a la red de nuestro FreePBX.

La IP por defecto y credenciales para acceder a la configuración web son:

IP :192.168.5.150

Credenciales por defecto:

User: admin
Pw: password

Para modificar la IP es en la sección System → LAN Settings
Para modificar la password en System → System settings → Change password

Vamos a la sección System -> LAN Settings y modificamos los parámetros:

Configuración Trunk Yeastar TG100

Para que nuestro FreePBX se conecte a la red GSM traves de nuestra Gateway VoIP, hay que configurar un trunk de entrada de FreePBX.

En la sección Gateway → VoIP Settings → VoIP Trunk Seleccionamos Add VoIP Trunk y la siguiente ventana la configuramos de la siguiente manera:

Trunk Type: Service Provider
Type: SIP
Provider name: Asterisk
IP: 10.27.3.110:5060 (Nuestro FreePBX)

Creamos un Segundo trunk del tipo Service Provider, que es por el que se conectara nuestro segundo cliente, Elastix.

Trunk Type: Service Provider
Type: SIP
Provider name: Elastix
IP: 10.27.100.9:5060 (Nuestro Elastix)

Credenciales SIM

Después de configurar el trunk, deberemos proporcionar las credenciales básicas de nuestra tarjeta SIM, se pueden configurar varias cosas pero para que funcione solo se le tiene que especificar el numero PIN para que pueda acceder y autenticarse a la red externa.

Debemos ir a la sección Mobile list y pulsar el botón del lápiz de nuestra tarjeta SIM:

Una vez finalizado en status-->Trunk Status nos mostrará si funciona o no.