CONFIGURACION DEL MODULO SMS EN ELASTIX

En esta gua se explica cmo instalar y configurar el modulo para el

envo masivo de mensajes SMS en Elastix.

En esta Gua se explica cmo Instalar y Configurar el modulo de SMS en Elastix

El conocimiento no aplicado es conocimiento muerto

Cursos de Entrenamiento en Telefona IP y Call Center con Asterisk/Elastix

www.elastixtech.com Derechos Reservados Nefta Anaya (2013)

CONFIGURACION DEL MODULO SMS EN ELASTIX

El uso del envo de mensajes de texto SMS se ha convertido en una gran
herramienta para la generacin de campaas de mercadeo, cobros y hasta en
campaas polticas, la garanta que el mensaje ser recibido es casi del 100%.
Uno de los problemas del contacto por medio de una llamada telefnica es, que el
cliente puede o no contestar la llamada, esto reduce la efectividad en especial con
los procesos de cobros, un mensaje de texto en algunos casos puede ser ms
efectivo. Cuando el objetivo del mensaje es para un recordatorio o aviso, el SMS
es muy efectivo, lo mejor de todo a solo una fraccin del costo de una llamada
telefnica.
Cuando el mismo mensaje se desea hacer llegar a varios cientos o miles de nmeros celulares, hacerlo uno por uno
puede resultar muy tedioso y/o tomar demasiado tiempo, lo que no resulta nada prctico y funcional. El protocolo
utilizado para el envo de mensajes SMS en Elastix es SMPP.

Protocolo SMPP.
SMPP, Short Message Peer-to-peer Protocol, es un protocolo estndar de telecomunicaciones pensado para el
intercambio de mensajes SMS entre equipos que gestionan los mensajes como pueden ser los SMSC (Short
message service center) o los GSM USSD (Unstructured Supplementary Services Data server), y un sistema de
solicitud de SMS como puede ser un servidor WAP o cualquier gateway de mensajera. Se utiliza normalmente
para permitir a terceros enviar mensajes (tales como pueden ser los proveedores de contenidos). Actualmente
las versiones ms utilizadas, pues son las ms comnmente soportadas por los operadores, son por orden,
SMPP v3.3 y v3.4. Esta ltima soporta el modo transceiver (una misma conexin puede enviar y recibir al
mismo tiempo). La ltima versin disponible es la v5.0.
SMPP es un protocolo que permite a entidades no mviles (es decir, que no poseen conectividad de radio) que
utilizan los servicios de Operadores SMSC poder enviar o recibir sms. Estas entidades no mviles pueden ser
Proveedores VAS (servicios de valor aadido) o puede ser un sitio web que ofrece servicio sms web o puede ser
tambin un proveedor de SMS a granel.

Entrenamiento en Telefona IP con Asterisk/Elastix

Pgina - 1

Derechos Reservados Nefta Anaya (2013)

CONFIGURACION DEL MODULO SMS EN ELASTIX

Descripcin del modulo SMS de Elastix.
Es un modulo bajo licencia GNU desarrollado por Iberoxarxa que se instala en Elastix, el cual permite el envio de
mensajes SMS de manera individual o masiva.
Para enviar mensajes con el protocolo SMPP se debe tener una aplicacin, denominada cliente SMPP, en nuestro caso
este cliente esta incluido en el modulo SMS de Elastix. El Cliente SMPP se comunica con el servidor SMPP por medio
del protocolo SMPP, que es una forma nativa para el envo de SMS. Se pueden enviar un solo mensaje o mltiples. El
Cliente SMPP genera el mensaje SMS para luego enviarlo al servidor.

Las aplicaciones que envan mensajes cortos (SMS), usando el protocolo SMPP, pueden comunicarse con el centro de
SMS (SMSC) y transmitir mensajes muy rpido. Adems, puede recibir de forma asincrnica, informes de entrega para
cada mensaje, para que pueda conocer el estado de cada SMS que enva, de forma automtica. Conexin entre el
cliente y el servidor est siempre abierta y verificar peridicamente por el cliente.
Funcionalidades principales:

Enviar mensajes individual, o masivamente.

Crear listas de distribucin para la realizacin recurrente de campaas SMS sobre los mismos nmeros.
Crear diversos troncales para el envo de mensajes SMS
Crear campaas masivas a travs de SMS
Crear listas de envio en formato CSV o tomndolos del CDR de Elastix

Limitantes:

Por defecto nicamente se puede instalar en versiones anteriores a Elastix 2.0, pero haciendo un
procedimiento adicional se puede actualizar a la versin Elastix 2.4.0.
Es necesario crear troncales con dispositivos que soporten protocolo SMPP.
No permite la recepcin de mensajes.

Si el propsito es, nicamente el envio masivo de mensajes SMS, este modulo funciona a la perfeccin, muy fcil de
usar, se integra perfectamente dentro de la interfaz Web de Elastix, la configuracin es relativamente rpida y sencilla,
el nico problema en mi opinin es, que no funciona con cualquier hardware, requiere uno que tenga soporte para el
protocolo SMPP, existen en el mercado hardware GoIP (GSM over IP) que incorporan un servidor SMPP los cuales
trabajan perfectamente como Gateway SMS.

Entrenamiento en Telefona IP con Asterisk/Elastix

Pgina - 2

Derechos Reservados Nefta Anaya (2013)

CONFIGURACION DEL MODULO SMS EN ELASTIX

Procedimiento de Instalacin y Configuracin de Modulo SMS en Elastix.
Partimos del supuesto que se tiene un servidor Elastix con cualquiera de las siguiente versiones: 1.6.x y/o 2.0.x. Para
las versiones 2.3 y 2.4 se requiere realizar un procedimiento adicional para su instalacin, en esta gua explico cmo
hacerlo en una versin de Elastix 2.4.0.
Pasos a seguir:
1.- Descargar modulo SMS
2.- Instalacin de modulo SMS en Elastix
3.- Configuracin del hardware GoIP
4.- Configurar troncal SMPP en Elastix
5.- Envio de mensajes individual
6.- Crear campaas para el envio masivo de mensajes
Para hacer la instalacin en Elastix 2.4.0 es necesario realizar copias de archivos en diferentes directorios del servidor,
para esto recomiendo que descarguen la aplicacin WinSCP ===> http://winscp.net/eng/docs/lang:es

1.- Descargar modulo SMS

Procedemos a descargar el modulo desde el siguiente sitio: http://sourceforge.net/projects/elastix-sms/
El nombre del archivo descargado es: elastix-sms-beta-0.3.tar.gz.

Entrenamiento en Telefona IP con Asterisk/Elastix

Pgina - 3

Derechos Reservados Nefta Anaya (2013)

CONFIGURACION DEL MODULO SMS EN ELASTIX

2.- Instalacin de modulo SMS en Elastix 2.4.0 e inferiores.

NOTA: Para hacer este procedimiento el servidor Elastix deber tener acceso a Internet.
Antes de proceder con la instalacin del modulo SMS en Elastix, tenemos que realizar lo siguiente:
2.1.- Instalar el addon Elastix-Developer-v.2.0.0-4, este nos va permitir cargar el modulo SMS desde el archivo
descargado en el paso anterior, adems de integrar el men SMS en el Dashboard de Administracin Web.
IMPORTANTE: A pesar que el addon Developer se puede instalar desde la interfaz grafica, no recomiendo hacerlo
desde ah, debido a que por defecto se descarga la ltima versin disponible, por alguna razn que ignoro no se
incorporo la opcin Load Module, que es la que vamos a utilizar para este fin.
Desde la consola CLI del servidor o desde una sesin SSH (Putty) procedemos a ejecutar el siguiente comando:
yum install elastix-developer-2.0.0-4 -y

Iniciara la descarga del modulo developer.

Al finalizar la descarga aparece el siguiente mensaje:

Observen que aparezca el mensaje Complete! de no aparecer verificar la sintaxis del comando o la conexin del
servidor Elastix a Internet.
Ahora que ya se tiene instalado el modulo developer, ingresamos a la interfaz Web, deber aparecer en el men la
opcin Developer, damos Clic sobre la opcin para proceder.

Entrenamiento en Telefona IP con Asterisk/Elastix

Pgina - 4

Derechos Reservados Nefta Anaya (2013)

CONFIGURACION DEL MODULO SMS EN ELASTIX

2.2.- Cargar modulo SMS

2.2.1.- Accedemos a la opcin Developer tal como lo muestra la siguiente imagen:

2.2.2.- Aparecen 4 opciones vamos a dar Clic en Load Module

Desde aqu vamos a realizar la carga del archivo elastix-sms-beta-0.3.tar.gz del modulo SMS que se descargo
anteriormente, debemos tener claro la ubicacin dentro del disco duro.
I.

Damos Clic en Examinar, aparece la opcin de buscar archivos.

II.

Buscamos el archivo elastix-sms-beta-0.3.tar.gz y lo seleccionamos.

Entrenamiento en Telefona IP con Asterisk/Elastix

Pgina - 5

Derechos Reservados Nefta Anaya (2013)

CONFIGURACION DEL MODULO SMS EN ELASTIX

El nombre completo del archivo deber aparecer en el recuadro tal como lo muestra la siguiente imagen:
Posteriormente damos Clic en Save para ejecutar la carga del archivo elastix-sms-beta-0.3.tar.gz

De esta manera se ha ejecutado la carga del modulo SMS, refrescamos el navegador (Browser), deber aparecer en el
men principal la opcin SMS, tal como lo muestra la siguiente imagen.

NOTA IMPORTANTE: Si damos Clic sobre la opcin SMS aparecer una pantalla en blanco, esto se debe a que por
alguna razn de incompatibilidad que desconozco en las versiones de Elastix 2.3 y 2.4, no se copian todos los archivos
en sus respectivas ubicaciones, para esto se deber hacer un paso adicional que explico a continuacin
En versiones de Elastix 2.0.x e inferiores lo anterior no sucede, la instalacin finaliza con xito sin ningn problema,
todas las opciones dentro del men SMS funcionan correctamente, no es necesario realizar ningn paso adicional.

Entrenamiento en Telefona IP con Asterisk/Elastix

Pgina - 6

Derechos Reservados Nefta Anaya (2013)

CONFIGURACION DEL MODULO SMS EN ELASTIX

Copia de Archivos de modulo SMS en Elastix 2.4.0
Vamos a realizar la copia de los archivos hacia el servidor Elastix, utilizando la aplicacin WinSCP.
1.- Descomprimir y extraer todos los archivos de elastix-sms-beta-0.3.tar.gz, en un directorio, deber aparecer la
siguiente estructura:

2.- Copiamos los archivos del modulo SMS a los siguientes destinos:

Destino: /var/www/html/modules/
Copiamos los siguientes directorios completos:
- ixx_sms_campaign
- ixx_sms_config
- ixx_sms_list
- ixx_sms_send
- ixx_sms_trunk

Destino: /var/www/html/libs/
Copiamos todo el contenido que se encuentra dentro del directorio libs, (un directorio y un archivo).
-sms
-ixx.date.lib.php

Entrenamiento en Telefona IP con Asterisk/Elastix

Pgina - 7

Derechos Reservados Nefta Anaya (2013)

CONFIGURACION DEL MODULO SMS EN ELASTIX

Destino: /opt/elastix/
Copiamos todo el contenido que se encuentra dentro del directorio ixxsms/massive, (8 archivos).

Destino: /etc/logrotate.d/
Copiar archivo ixxsms.logrotate que est dentro del directorio installer, una vez copiado renombrarlo por ixxsms.

Destino: /etc/rc.d/init.d/
Copiar archivo ixxmassivesms que est dentro del directorio ixx_sms_process

Al terminar de hacer todo este procedimiento, damos Clic en SMS, debern aparecer todas las opciones, como lo
muestra la siguiente imagen:

Recomiendo ingresar a cada una de las opciones para verificar que todo est bien.

Entrenamiento en Telefona IP con Asterisk/Elastix

Pgina - 8

Derechos Reservados Nefta Anaya (2013)

CONFIGURACION DEL MODULO SMS EN ELASTIX

3.- Configuracin del Hardware GoIP

Estos dispositivos funcionan como Gateway entre la red GSM y Elastix, son de origen Chino a un precio bastante
accesible, vienen en modalidades de 1, 4 y 8 canales GSM, esto permite colocar SIM de diferentes proveedores, asi
poder hacer envos de SMS a diferentes redes. Traen instalado por defecto un servidor de SMPP, el cual permite el
envio masivo de mensajes, puede enviar en promedio entre 100 a 150 sms por minuto. Ademas funciona como base
Telular, por medio de la configuracin de una troncal SIP en Elastix podemos hacer y recibir llamadas a la red de
telefona Celular.

El equipo tiene 2 puertos Ethernet (LAN y PC), nos conectamos al puerto PC, la IP por defecto es 192.168.8.1.
Ingresamos via Web: http://192.168.8.1
Para ingresar al equipo las credenciales por defecto son las siguientes:
Usuario: admin
Clave: admin

Entrenamiento en Telefona IP con Asterisk/Elastix

Pgina - 9

Derechos Reservados Nefta Anaya (2013)

CONFIGURACION DEL MODULO SMS EN ELASTIX

Una vez tengamos acceso procedemos a configurar lo siguiente:
3.1.- Configuracin de Servidor SMPP
Estos parmetros los vamos a utilizar en Elastix para configurar la troncal SMPP mas adelante.
Seleccionamos la opcin Preferences. Los parmetros a configurar son:
SMPP SMSC = Enable (Habilita el servicio)
ID = 4040 (Corresponde al usuario, cualquier valor alfanumrico)
Password = 3535 (Corresponde a la clave, cualquier valor alfanumrico)
Port = 7777 (Numero del puerto TCP/UDP)
DTMF = 270 (Dejamos el valor por defecto)

Estos mismos valores los vamos a utilizar mas adelante para configurar la troncal SMPP en el servidor Elastix.

Entrenamiento en Telefona IP con Asterisk/Elastix

Pgina - 10

Derechos Reservados Nefta Anaya (2013)

CONFIGURACION DEL MODULO SMS EN ELASTIX

3.2.- Cambiar direccin IP
Este paso es opcional, si queremos colocar una direccin IP que corresponda a la red IP que estamos utilizando.
Seleccionamos la opcin Network.
Colocamos los valores que correspondan a la red IP utilizada.

Tomen en cuenta que los valores que vamos a colocar aqu, deben corresponder a la misma red IP donde se encuentra
el servidor Elastix.
Recomiendo colocar la opcin PC Port en Bridge mode (Modo puente). De esta manera ambos puertos Ethernet del
equipo LAN y PC se comportan como un Switch.
De esta manera hemos habilitado el servidor SMPP en el equipo GoIP, las dems opciones se configuran solo si el
equipo se utilizara tambin con Gateway de voz por medio de una Troncal SIP en Elastix.
Para conectar el equipo GoIP a la red LAN debern hacerlo por medio del puerto LAN.

Entrenamiento en Telefona IP con Asterisk/Elastix

Pgina - 11

Derechos Reservados Nefta Anaya (2013)

CONFIGURACION DEL MODULO SMS EN ELASTIX

4.- Configurar troncal SMPP en Elastix

Vamos a proceder a crear en Elastix, la troncal SMPP para el envi de mensajes, para esto es necesario que la
comunicacin entre el Servidor Elastix y el equipo GoIP este establecida, podemos comprobarlo ingresando a la
consola CLI de Elastix y hacer un ping a la direccin IP del equipo GoIP.
Para ingresar a la configuracin de la Troncal SMPP, damos Clic en Trunks, luego Clic en Mostrar Filtro

Luego Clic en Crear nuevo troncal, para que se despliegue el men de configuracin.

Aparecern los campos vacios que debemos llenar con los valores que se ingresaron al momento de configurar el
equipo GoIP.
Remitirse a la configuracin del equipo GoIP para tomar nota de los valores a colocar, si no los tienen a la mano.

Entrenamiento en Telefona IP con Asterisk/Elastix

Pgina - 12

Derechos Reservados Nefta Anaya (2013)

CONFIGURACION DEL MODULO SMS EN ELASTIX

Los parmetros que vamos a utilizar para configurar la troncal SMPP son:
1. Nombre: Nombre de la Troncal SMPP (Cualquier nombre que identifique la troncal SMPP)
2. Activo: Debe de estar marcada para poder utilizar la troncal SMPP.
3. Tipo de servicio: Seleccionamos SMPP Server (No seleccionar nada en el otro campo)}
4. Servidor: Direccin IP del servidor SMPP (Es la direccin IP que se coloco al equipo GoIP)
5. Usuario: Nombre de usuario que se configuro en el equipo GoIP
6. Password: Clave que se configuro en el equipo GoIP
7. Puerto: Numero de puerto TCP/UDP que se configuro en el equipo GoIP
8. Aadir cdigo de pas: Si lo activan toma el valor del cdigo ingresado en Configuracin
9. Tipo de sistema: Por lo general no se utiliza, se deja en blanco
10. Numero llamante: Corresponde al nmero que aparece en los sms enviados
11. Prioridad: Define la prioridad de la troncal, se utiliza cuando hay ms de una troncal.

Los campos marcados con asterisco (*) son obligatorios, los dems son opcionales, tomar en cuenta que el campo
Activo a pesar de no ser obligatorio es importante que la casilla este marcada de lo contrario, la troncal se creara pero
no podr ser utilizada para el envi de sms.
No olvidar dar Clic en Guardar al terminar de llenar todos los campos.

Entrenamiento en Telefona IP con Asterisk/Elastix

Pgina - 13

Derechos Reservados Nefta Anaya (2013)

CONFIGURACION DEL MODULO SMS EN ELASTIX

Configuracin de Cdigo de Pas y Numeracin Mvil

Esta opcin permite configurar los parmetros de la numeracin de lneas mviles o celulares del pas, en el ejemplo
muestro la configuracin para Colombia.
El cdigo de pas de Colombia es 57, todas las lneas mviles en Colombia comienzan con 3, seguido por el nmero de
la lnea de 9 dgitos, con una longitud total de 10 dgitos.
El cdigo de pas que se configura aqu, es tomado por la configuracin de la troncal SMPP cuando se hace el envo de
los mensajes SMS.

Al finalizar de llenar todos los campos no olvidar dar Clic en Guardar.

Hasta aqu hemos finalizado la configuracin de la troncal SMPP, para probar su funcionamiento, deberemos insertar
una SIM de una lnea mvil al equipo GoIP, seleccionamos la opcin Send (envo) desde donde podremos enviar
mensajes de manera individual a cualquier telfono mvil.
A continuacin explico cmo realizar el envo de mensajes SMS de manera individual y crear campaas para el envo
masivo de mensajes.

Entrenamiento en Telefona IP con Asterisk/Elastix

Pgina - 14

Derechos Reservados Nefta Anaya (2013)

CONFIGURACION DEL MODULO SMS EN ELASTIX

5.- Envo de mensajes individuales

Para el envo individual de mensajes, seleccionamos la opcin Send (Enviar).

Entrenamiento en Telefona IP con Asterisk/Elastix

Pgina - 15

Derechos Reservados Nefta Anaya (2013)

CONFIGURACION DEL MODULO SMS EN ELASTIX

ESPACIO PARA NOTAS:

Entrenamiento en Telefona IP con Asterisk/Elastix

Pgina - 16

Derechos Reservados Nefta Anaya (2013)