GUIA DE CONFIGURACION DE MODULO SMS EN ELASTIX

CONFIGURACION DEL MODULO SMS EN ELASTIX
En esta guía se explica cómo instalar y configurar el modulo para el
envío masivo de mensajes SMS en Elastix.
En esta Guía se explica cómo Instalar y Configurar el modulo de SMS en Elastix
“El conocimiento no aplicado es conocimiento muerto”
Cursos de Entrenamiento en Telefonía IP y Call Center con Asterisk/Elastix
www.elastixtech.com – Derechos Reservados – Nefta Anaya (2013)
CONFIGURACION DEL MODULO SMS EN ELASTIX
El uso del envío de mensajes de texto SMS se ha convertido en una gran
herramienta para la generación de campañas de mercadeo, cobros y hasta en
campañas políticas, la garantía que el mensaje será recibido es casi del 100%.
Uno de los problemas del contacto por medio de una llamada telefónica 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 más
efectivo. Cuando el objetivo del mensaje es para un recordatorio o aviso, el SMS
es muy efectivo, lo mejor de todo a solo una fracción del costo de una llamada
telefónica.
Cuando el mismo mensaje se desea hacer llegar a varios cientos o miles de números celulares, hacerlo uno por uno
puede resultar muy tedioso y/o tomar demasiado tiempo, lo que no resulta nada práctico y funcional. El protocolo
utilizado para el envío de mensajes SMS en Elastix es SMPP.
Protocolo SMPP.
SMPP, Short Message Peer-to-peer Protocol, es un protocolo estándar 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 mensajería. Se utiliza normalmente
para permitir a terceros enviar mensajes (tales como pueden ser los proveedores de contenidos). Actualmente
las versiones más utilizadas, pues son las más comúnmente soportadas por los operadores, son por orden,
SMPP v3.3 y v3.4. Esta última soporta el modo transceiver (una misma conexión puede enviar y recibir al
‘mismo’ tiempo). La última versión disponible es la v5.0.
SMPP es un protocolo que permite a entidades no móviles (es decir, que no poseen conectividad de radio) que
utilizan los servicios de Operadores SMSC poder enviar o recibir sms. Estas entidades no móviles pueden ser
Proveedores VAS (servicios de valor añadido) o puede ser un sitio web que ofrece servicio sms web o puede ser
también un proveedor de SMS a granel.
Entrenamiento en Telefonía IP con Asterisk/Elastix
Página - 1
Derechos Reservados – Nefta Anaya (2013)
CONFIGURACION DEL MODULO SMS EN ELASTIX
Descripción 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 aplicación, 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 envío de SMS. Se pueden enviar un solo mensaje o múltiples. El
Cliente SMPP genera el mensaje SMS para luego enviarlo al servidor.
Las aplicaciones que envían mensajes cortos (SMS), usando el protocolo SMPP, pueden comunicarse con el centro de
SMS (SMSC) y transmitir mensajes muy rápido. Además, puede recibir de forma asincrónica, informes de entrega para
cada mensaje, para que pueda conocer el estado de cada SMS que envía, de forma automática. Conexión entre el
cliente y el servidor está siempre abierta y verificar periódicamente por el cliente.
Funcionalidades principales:
•
•
•
•
•
Enviar mensajes individual, o masivamente.
Crear listas de distribución para la realización recurrente de campañas SMS sobre los mismos números.
Crear diversos troncales para el envío de mensajes SMS
Crear campañas masivas a través de SMS
Crear listas de envio en formato CSV o tomándolos 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 versión Elastix 2.4.0.
Es necesario crear troncales con dispositivos que soporten protocolo SMPP.
No permite la recepción de mensajes.
Si el propósito es, únicamente el envio masivo de mensajes SMS, este modulo funciona a la perfección, muy fácil de
usar, se integra perfectamente dentro de la interfaz Web de Elastix, la configuración es relativamente rápida y sencilla,
el único problema en mi opinión 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 Telefonía IP con Asterisk/Elastix
Página - 2
Derechos Reservados – Nefta Anaya (2013)
CONFIGURACION DEL MODULO SMS EN ELASTIX
Procedimiento de Instalación y Configuración 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 instalación, en esta guía explico cómo
hacerlo en una versión de Elastix 2.4.0.
Pasos a seguir:
1.- Descargar modulo SMS
2.- Instalación de modulo SMS en Elastix
3.- Configuración del hardware GoIP
4.- Configurar troncal SMPP en Elastix
5.- Envio de mensajes individual
6.- Crear campañas para el envio masivo de mensajes
Para hacer la instalación en Elastix 2.4.0 es necesario realizar copias de archivos en diferentes directorios del servidor,
para esto recomiendo que descarguen la aplicación 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 Telefonía IP con Asterisk/Elastix
Página - 3
Derechos Reservados – Nefta Anaya (2013)
CONFIGURACION DEL MODULO SMS EN ELASTIX
2.- Instalación 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 instalación 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, además de integrar el menú SMS en el Dashboard de Administración 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 versión disponible, por alguna razón que ignoro no se
incorporo la opción Load Module, que es la que vamos a utilizar para este fin.
Desde la consola CLI del servidor o desde una sesión 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 conexión 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
opción Developer, damos Clic sobre la opción para proceder.
Entrenamiento en Telefonía IP con Asterisk/Elastix
Página - 4
Derechos Reservados – Nefta Anaya (2013)
CONFIGURACION DEL MODULO SMS EN ELASTIX
2.2.- Cargar modulo SMS
2.2.1.- Accedemos a la opción 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 ubicación dentro del disco duro.
I.
Damos Clic en Examinar, aparece la opción de buscar archivos.
II.
Buscamos el archivo elastix-sms-beta-0.3.tar.gz y lo seleccionamos.
Entrenamiento en Telefonía IP con Asterisk/Elastix
Página - 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 opción SMS, tal como lo muestra la siguiente imagen.
NOTA IMPORTANTE: Si damos Clic sobre la opción SMS aparecerá una pantalla en blanco, esto se debe a que por
alguna razón 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 continuación
En versiones de Elastix 2.0.x e inferiores lo anterior no sucede, la instalación finaliza con éxito sin ningún problema,
todas las opciones dentro del menú SMS funcionan correctamente, no es necesario realizar ningún paso adicional.
Entrenamiento en Telefonía IP con Asterisk/Elastix
Página - 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 aplicación 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 Telefonía IP con Asterisk/Elastix
Página - 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, deberán 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 Telefonía IP con Asterisk/Elastix
Página - 8
Derechos Reservados – Nefta Anaya (2013)
CONFIGURACION DEL MODULO SMS EN ELASTIX
3.- Configuración 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 envíos 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 configuración de una troncal SIP en Elastix podemos hacer y recibir llamadas a la red de
telefonía 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 Telefonía IP con Asterisk/Elastix
Página - 9
Derechos Reservados – Nefta Anaya (2013)
CONFIGURACION DEL MODULO SMS EN ELASTIX
Una vez tengamos acceso procedemos a configurar lo siguiente:
3.1.- Configuración de Servidor SMPP
Estos parámetros los vamos a utilizar en Elastix para configurar la troncal SMPP mas adelante.
Seleccionamos la opción Preferences. Los parámetros a configurar son:
SMPP SMSC = Enable (Habilita el servicio)
ID = 4040 (Corresponde al usuario, cualquier valor alfanumérico)
Password = 3535 (Corresponde a la clave, cualquier valor alfanumérico)
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 Telefonía IP con Asterisk/Elastix
Página - 10
Derechos Reservados – Nefta Anaya (2013)
CONFIGURACION DEL MODULO SMS EN ELASTIX
3.2.- Cambiar dirección IP
Este paso es opcional, si queremos colocar una dirección IP que corresponda a la red IP que estamos utilizando.
Seleccionamos la opción 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 opción 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 demás opciones se configuran solo si el
equipo se utilizara también con Gateway de voz por medio de una Troncal SIP en Elastix.
Para conectar el equipo GoIP a la red LAN deberán hacerlo por medio del puerto LAN.
Entrenamiento en Telefonía IP con Asterisk/Elastix
Página - 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
comunicación 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 dirección IP del equipo GoIP.
Para ingresar a la configuración 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 configuración.
Aparecerán los campos vacios que debemos llenar con los valores que se ingresaron al momento de configurar el
equipo GoIP.
Remitirse a la configuración del equipo GoIP para tomar nota de los valores a colocar, si no los tienen a la mano.
Entrenamiento en Telefonía IP con Asterisk/Elastix
Página - 12
Derechos Reservados – Nefta Anaya (2013)
CONFIGURACION DEL MODULO SMS EN ELASTIX
Los parámetros 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: Dirección IP del servidor SMPP (Es la dirección 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. Añadir código de país: Si lo activan toma el valor del código ingresado en Configuración
9. Tipo de sistema: Por lo general no se utiliza, se deja en blanco
10. Numero llamante: Corresponde al número que aparece en los sms enviados
11. Prioridad: Define la prioridad de la troncal, se utiliza cuando hay más de una troncal.
Los campos marcados con asterisco (*) son obligatorios, los demás 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 Telefonía IP con Asterisk/Elastix
Página - 13
Derechos Reservados – Nefta Anaya (2013)
CONFIGURACION DEL MODULO SMS EN ELASTIX
Configuración de Código de País y Numeración Móvil
Esta opción permite configurar los parámetros de la numeración de líneas móviles o celulares del país, en el ejemplo
muestro la configuración para Colombia.
El código de país de Colombia es 57, todas las líneas móviles en Colombia comienzan con 3, seguido por el número de
la línea de 9 dígitos, con una longitud total de 10 dígitos.
El código de país que se configura aquí, es tomado por la configuración de la troncal SMPP cuando se hace el envío de
los mensajes SMS.
Al finalizar de llenar todos los campos no olvidar dar Clic en Guardar.
Hasta aquí hemos finalizado la configuración de la troncal SMPP, para probar su funcionamiento, deberemos insertar
una SIM de una línea móvil al equipo GoIP, seleccionamos la opción Send (envío) desde donde podremos enviar
mensajes de manera individual a cualquier teléfono móvil.
A continuación explico cómo realizar el envío de mensajes SMS de manera individual y crear campañas para el envío
masivo de mensajes.
Entrenamiento en Telefonía IP con Asterisk/Elastix
Página - 14
Derechos Reservados – Nefta Anaya (2013)
CONFIGURACION DEL MODULO SMS EN ELASTIX
5.- Envío de mensajes individuales
Para el envío individual de mensajes, seleccionamos la opción Send (Enviar).
Entrenamiento en Telefonía IP con Asterisk/Elastix
Página - 15
Derechos Reservados – Nefta Anaya (2013)
CONFIGURACION DEL MODULO SMS EN ELASTIX
ESPACIO PARA NOTAS:
Entrenamiento en Telefonía IP con Asterisk/Elastix
Página - 16
Derechos Reservados – Nefta Anaya (2013)