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

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. 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. 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. Página - 1

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. Página - 2

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. Página - 3

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. Página - 4

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. Página - 5

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. Página - 6

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 Página - 7

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. Página - 8

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 Página - 9

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. Página - 10

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. Página - 11

4.- Configurar troncal SMPP en Elastix CONFIGURACION DEL MODULO SMS 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. Página - 12

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. Página - 13

Configuración de Código de País y Numeración Móvil CONFIGURACION DEL MODULO SMS EN ELASTIX 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. Página - 14

5.- Envío de mensajes individuales Para el envío individual de mensajes, seleccionamos la opción Send (Enviar). Página - 15

ESPACIO PARA NOTAS: Página - 16