Documentos de Académico
Documentos de Profesional
Documentos de Cultura
Elastix Sms Beta 0.2 Spanish
Elastix Sms Beta 0.2 Spanish
MDULO DE ENVO
DE SMS PARA
ELASTIX
http://www.iberoxarxa.es
Pgina 1
Contenido
1.Introduccin.......................................................................................................................................3
2.Funcionalidades principales..............................................................................................................3
3.Instalacin..........................................................................................................................................4
4.Troncales............................................................................................................................................6
5.Envo de un mensaje SMS.................................................................................................................8
5.1.Nmero de mensajes necesarios para enviar un SMS.............................................................10
6.Listas................................................................................................................................................15
6.1.Creacin de una lista mediante un fichero csv de nmeros.....................................................15
6.2.Creacin de una lista a partir del CDR....................................................................................18
6.3.Administracin de listas ya creadas.........................................................................................19
7.Campaas de envo masivo.............................................................................................................21
7.1.Preparacin del fichero csv para campaas.............................................................................25
8.Colas de mensajes............................................................................................................................26
9.Servicio de envo de mensajes.........................................................................................................26
http://www.iberoxarxa.es
Pgina 2
1. Introduccin
El presente documento describe las funcionalidades y el uso del mdulo de SMS para Elastix,
desarrollado por la empresa IBEROXARXA SERVICIOS INTEGRALES, S.L., en adelante
IBEROXARXA.
Este mdulo se distribuye gratuitamente mediante licencia GPL v.2., y por tanto se distribuye tal
cual y SIN NINGN TIPO DE GARANTA. Puede conocer ms acerca de esta licencia
consultando la URL http://www.opensource.org/licenses/gpl-license.php.
Actualmente este mdulo permite el envo de mensajes SMS a travs del protocolo SMPP, por lo
que su uso no est ligado a ningn proveedor concreto; nicamente usted necesita contratar el envo
de mensajes SMS a un proveedor que soporte este protocolo. Si est interesado IBEROXARXA
puede proporcionarle este servicio. Ms informacin en http://www.iberoxarxa.es/llamadasvoip.html, o enviando e-mail a contactar@iberoxarxa.es.
Tambin se permiten el envo de mensajes SMS mediante la ejecucin de un shell script, esto es, el
mdulo de SMS de IBEROXARXA invoca un shell script para enviar el mensaje SMS. Esta
posibilidad permite utilizar nuestro mdulo para enviar mensajes SMS a travs de medios an no
soportados por ste.
2. Funcionalidades principales
Con el mdulo de SMS de IBEROXARXA podr:
1. Enviar mensajes individualmente, o masivamente
2. Crear listas de distribucin para la realizacin recurrente de campaas SMS sobre los
mismos nmeros de telfono
3. Crear diversos troncales para el envo de mensajes SMS
4. Crear campaas masivas a travs de SMS
http://www.iberoxarxa.es
Pgina 3
3. Instalacin
Para instalar el mdulo de SMS de IBEROXARXA necesita disponer previamente de una PBX
Elastix, versin 1.6.x, o versin 2.0.x.. Las instrucciones que encontrar en este manual son para
Elastix versin 2.0.x..
Primero descargue el mdulo de SMS de IBEROXARXA y gurdelo en su disco local. La url para
la descarga es http://sourceforge.net/projects/elastix-sms/files. Descargue la versin ms reciente.
Antes de instalar el mdulo de SMS de IBEROXARXA debe instalar el Addon Developer de
Elastix:
http://www.iberoxarxa.es
Pgina 4
Una vez tenga instalado el Addon Developer, vaya a la opcin Load Module del men
Developer, seleccione el fichero que ha descargado anteriormente y haga clic en el botn
Save.
Posteriormente a esto si refresca la pantalla aparecer el men SMS del mdulo que acaba de
instalar:
http://www.iberoxarxa.es
Pgina 5
4. Configuracin
La configuracin nos permite entrar una serie de informacin necesaria para el correcto envo de los
SMS.
Country Code: es el cdigo de pas para nmeros locales. Para Espaa, por ejemplo, es el
34.
Minimun Mobile Length: nmero mnimo de cifras para un nmero de mvil vlido en
nuestro pas, sin contar el Country Code. Para Espaa 9.
Maximun Mobile Length: nmero mximo de cifras para un nmero de mvil vlido en
nuestro pas, sin contrar en Country Code. Para Espaa 9.
El Country Code, Minimun Mobile Length y Maximun Mobile Length son utilizados para enviar un
mensaje SMS. As, segn los datos del ejemplo:
En cambio los Mobile Prefixes son utilizados para obtener los nmeros de telfono mviles
presentes en el CDR de nuestra PBX.
http://www.iberoxarxa.es
Pgina 6
5. Troncales
Para poder enviar mensajes SMS deber crear los diferentes troncales por los que se enviarn los
mensajes SMS. Actualmente slo puede crear troncales hacia servidores SMPP y troncales Bash
Script que invocan un shell script para enviar el mensaje. Estamos trabajando para ofrecer
conectividad con otro tipo de proveedores, como por ejemplo Gateways Portech.
La opcin Trunks muestra primeramente los troncales que ya estn creados, los cuales puede
editar haciendo clic sobre la opcin show del troncal:
http://www.iberoxarxa.es
Pgina 7
Si desea activar o no el troncal (casilla Active). Si no est activo el troncal estar creado,
pero no se podr utilizar para enviar SMS.
Tipo de servicio (Service Type). Seleccionar SMPP. Al lado del tipo de servicio dispone
de un desplegable con la configuracin de diferentes proveedores del tipo de servicio
(actualmente slo Iberoxarxa SMS SMPP Platform); si selecciona uno de los proveedores
preconfigurados automticamente se rellenarn los campos servidor y puerto.
Servidor: direccin IP o nombre del servidor del tipo de servicio (proporcionado por su
proveedor).
Append Country Code. Si est activo se prefijar el nmero de destino con el cdigo de pas.
Nmero llamante (Caller ID): hasta 11 caracteres para cadena alfanumrica y hasta 14
caracteres para cadenas numricas. Los mensajes se sealizarn con ste nmero.
http://www.iberoxarxa.es
Pgina 8
La opcin Trunks muestra primeramente los troncales que ya estn creados, los cuales puede
editar haciendo clic sobre la opcin show del troncal.
http://www.iberoxarxa.es
Pgina 9
Si desea activar o no el troncal (casilla Active). Si no est activo el troncal estar creado,
pero no se podr utilizar para enviar SMS.
Script: nombre del script que se deber de invocar para el envo de cada uno de los SMS. Se
introducir slo el nombre del script, sin su path.
Append Country Code. Si est activo se prefijar el nmero de destino con el cdigo de pas.
Nmero llamante (Caller ID): hasta 11 caracteres para cadena alfanumrica y hasta 14
caracteres para cadenas numricas. Los mensajes se sealizarn con ste nmero, siempre y
cuando la tecnologa de envo de SMS implementada en el script lo permita.
http://www.iberoxarxa.es
Pgina 10
Nmero de telfono: el nmero de telfono mvil al que quiere enviar el mensaje. Puede
introducirlo manualmente o puede copiarlo desde el libro de direcciones de Elastix haciendo
clic sobre el enlace.
Tenga en cuenta lo explicado en 6.1. - Nmero de mensajes necesarios para enviar un SMS, ya que
en funcin de los caracteres utilizados en su mensaje (acentos, signos especiales, etc ), su SMS
ser enviado con 1 o ms mensajes.
El envo del mensaje se realizar segn la configuracin explicada en 4. - Configuracin.
http://www.iberoxarxa.es
Pgina 11
Posteriormente al envo del mensaje se le informar del xito o no de la operacin. Tenga en cuenta
que puede que el mensaje no se enve de forma instantnea, ya que ello depende del proveedor del
servicio que tenga usted contratado.
Si en lugar de enviar el mensaje directamente ha decidido encolarlo consulte 9. - Colas de mensajes
para conocer el funcionamiento de la cola de envo de mensajes del mdulo de SMS de
IBEROXARXA.
http://www.iberoxarxa.es
Pgina 12
En el caso de codificacin SMS el mensaje SMS se enva en unidades de 160 caracteres, de forma
que si el SMS est formado por 170 caracteres el mensaje se enviar utilizando 2 SMS.
En el caso de codificacin UNICODE el mensaje SMS se enva en unidades de 70 caracteres, de
forma que si el SMS est formado por 170 caracteres el mensaje se enviar utilizando 3 SMS.
En cualquier caso el mdulo de SMS de IBEROXARXA informa en todo momento del nmero de
mensajes que se utilizarn para enviar el SMS:
Alfabeto SMS:
Hex
Dec
Character name
Character
ISO-8859-1 DEC
0x00
COMMERCIAL AT
64
0x01
POUND SIGN
163
0x02
DOLLAR SIGN
36
0x03
YEN SIGN
165
0x04
232
0x05
233
0x06
249
0x07
236
0x08
242
0x09
199
http://www.iberoxarxa.es
Pgina 13
0x0A
10
LINE FEED
0x0B
11
216
0x0C
12
248
0x0D
13
CARRIAGE RETURN
0x0E
14
197
0x0F
15
229
0x10
16
0x11
17
LOW LINE
0x12
18
0x13
19
0x14
20
0x15
21
0x16
22
0x17
23
0x18
24
0x19
25
0x1A
26
0x1B
27
0x1B0A
27 10
FORM FEED
0x1B14
27 20
CIRCUMFLEX ACCENT
94
0x1B28
27 40
123
0x1B29
27 41
125
0x1B2F
27 47
92
0x1B3C
27 60
91
0x1B3D
27 61
TILDE
126
0x1B3E
27 62
93
0x1B40
27 64
VERTICAL BAR
124
0x1B65
27 101
EURO SIGN
164 (ISO-8859-15)
0x1C
28
198
0x1D
29
230
0x1E
30
223
0x1F
31
201
0x20
32
SPACE
0x21
33
EXCLAMATION MARK
10
13
95
12
32
!
33
http://www.iberoxarxa.es
Pgina 14
0x22
34
QUOTATION MARK
"
34
0x23
35
NUMBER SIGN
35
0x24
36
CURRENCY SIGN
164 (ISO-8859-1)
0x25
37
PERCENT SIGN
37
0x26
38
AMPERSAND
&
38
0x27
39
APOSTROPHE
'
39
0x28
40
LEFT PARENTHESIS
40
0x29
41
RIGHT PARENTHESIS
41
0x2A
42
ASTERISK
42
0x2B
43
PLUS SIGN
43
0x2C
44
COMMA
44
0x2D
45
HYPHEN-MINUS
45
0x2E
46
FULL STOP
46
0x2F
47
SOLIDUS (SLASH)
47
0x30
48
DIGIT ZERO
48
0x31
49
DIGIT ONE
49
0x32
50
DIGIT TWO
50
0x33
51
DIGIT THREE
51
0x34
52
DIGIT FOUR
52
0x35
53
DIGIT FIVE
53
0x36
54
DIGIT SIX
54
0x37
55
DIGIT SEVEN
55
0x38
56
DIGIT EIGHT
56
0x39
57
DIGIT NINE
57
0x3A
58
COLON
58
0x3B
59
SEMICOLON
59
0x3C
60
LESS-THAN SIGN
<
60
0x3D
61
EQUALS SIGN
61
0x3E
62
GREATER-THAN SIGN
>
62
0x3F
63
QUESTION MARK
63
0x40
64
161
0x41
65
65
0x42
66
66
0x43
67
67
http://www.iberoxarxa.es
Pgina 15
0x44
68
68
0x45
69
69
0x46
70
70
0x47
71
71
0x48
72
72
0x49
73
73
0x4A
74
74
0x4B
75
75
0x4C
76
76
0x4D
77
77
0x4E
78
78
0x4F
79
79
0x50
80
80
0x51
81
81
0x52
82
82
0x53
83
83
0x54
84
84
0x55
85
85
0x56
86
86
0x57
87
87
0x58
88
88
0x59
89
89
0x5A
90
90
0x5B
91
196
0x5C
92
214
0x5D
93
209
0x5E
94
220
0x5F
95
SECTION SIGN
167
0x60
96
191
0x61
97
97
0x62
98
98
0x63
99
99
0x64
100
100
0x65
101
101
http://www.iberoxarxa.es
Pgina 16
0x66
102
102
0x67
103
103
0x68
104
104
0x69
105
105
0x6A
106
106
0x6B
107
107
0x6C
108
108
0x6D
109
109
0x6E
110
110
0x6F
111
111
0x70
112
112
0x71
113
113
0x72
114
114
0x73
115
115
0x74
116
116
0x75
117
117
0x76
118
118
0x77
119
119
0x78
120
120
0x79
121
121
0x7A
122
122
0x7B
123
228
0x7C
124
246
0x7D
125
241
0x7E
126
252
0x7F
127
224
http://www.iberoxarxa.es
Pgina 17
7. Listas
El mdulo SMS de IBEROXARXA permite gestionar listas de nmeros. Estas listas de nmeros
son almacenadas en base de datos y pueden utilizarse para confeccionar campaas.
Usando las listas usted podr crear, por ejemplo, una lista con los nmeros de sus empleados y otra
con los nmeros de sus clientes ms importantes, y utilizar stas listas para realizar campaas de
comunicacin SMS hacia los nmeros que forman parte de estas listas.
Las listas son creadas a partir de un archivo csv (separado por comas) que contiene los nmeros de
telfono de la campaa o bien a partir de la informacin de nmeros mviles almacenados en el
CDR de la PBX.
Para gestionar las listas seleccione la opcin List del men SMS.
Al entrar en esta opcin primeramente se muestran las listas actualmente creadas en el sistema.
Puede ver los nmeros de una lista haciendo clic sobre el enlace Numbers de la lista, o puede
editarla haciendo clic sobre el enlace Show de la lista.
http://www.iberoxarxa.es
Pgina 18
http://www.iberoxarxa.es
Pgina 19
Introduzca el nombre que desea dar a la lista, seleccione el fichero csv con los nmeros que
formarn parte de la lista y haga clic sobre el botn Save.
La lista ya est creada y lista para ser usada. En el caso que el fichero csv contenga nmeros
duplicados stos se insertarn una sola vez en la lista.
http://www.iberoxarxa.es
Pgina 20
Introduzca el nombre que desea dar a la lista, marque la casilla Get list from CDR y haga clic
sobre el botn Save.
Este mtodo crea una lista de nmeros nicos a partir de los nmeros de telfonos mviles
contenidos en el CDR, segn la configuracin entrada en 4. - Configuracin.
http://www.iberoxarxa.es
Pgina 21
Puede excluir un nmero de la lista haciendo clic sobre el enlace exclude del nmero. Esto no
borra el nmero de la lista, nicamente se indica que el nmero no ser utilizado. Esta opcin es
til, por ejemplo, cuando un cliente nos indica que no quiere recibir ms avisos por SMS.
Puede incluir un nmero antes excluido de la lista haciendo clic sobre el enlace Include del
nmero.
Tambin puede localizar un nmero determinado introducindolo en el campo Filter y pulsando
despus Filter.
Puede incluir manualmente un nmero en la lista introducindolo en el campo Add number y
haciendo clic despus en el botn Add.
http://www.iberoxarxa.es
Pgina 22
Puede tambin editar una lista haciendo clic sobre el enlace Show de la lista:
Cuando edita una lista puede seleccionar un nuevo fichero csv, y los nmeros que contenga sern
aadidos a la lista. Si la lista contiene un nmero ya existente en la lista no ser aadido.
De la misma forma, puede incluir en la lista nuevos nmeros provenientes del registro CDR de la
PBX.
Tambin puede borrar la lista.
http://www.iberoxarxa.es
Pgina 23
Aunque no haya creado an ninguna campaa siempre aparecer la campaa Cola de Salida,
utilizada para el encolado de SMS. El sistema no permite borrar esta campaa. Puede conocer ms
sobre la cola de salida consultando 9. - Colas de mensajes.
Para crear una nueva campaa haga clic sobre el botn Create new campaign.
http://www.iberoxarxa.es
Pgina 24
Tambin debe indicar la fecha en que se iniciar la campaa y mientras dure la campaa la
hora inicial y final en que se puede ejecutar. Esto es importante, por ejemplo, para evitar que
se manden SMS a horas no recomendables, pudiendo por ejemplo, ejecutar la campaa slo
entre las 08:00 y las 20:00.
http://www.iberoxarxa.es
Pgina 25
es muy importante. En el caso que se encuentre marcada (opcin por defecto) se crear la
campaa en modo pausa, es decir, aunque las condiciones de fecha / hora se cumplan no
se ejecutar hasta que se lo indiquemos. En el caso que la casilla no se encuentre marcada la
campaa se crear en modo pendiente, de forma que si se cumplen las condiciones de
fecha / hora se ejecutar inmediatamente. Recomendamos crear las campaas en modo
pausa, es decir, con la casilla marcada, ya que de esta forma podremos realizar una
comprobacin previa de la campaa y realizar modificaciones en el caso que nos hayamos
equivocado.
Despus proporcionaremos un fichero csv con los nmeros a los que enviar la campaa, o
seleccionaremos una de las listas de nmeros creadas en el sistema. Puede consultar 8.1. Preparacin del fichero csv para campaas para saber ms sobre el formato del fichero csv.
Cuando haya entrado toda la informacin haga clic sobre el botn Save para guardar la
campaa.
Al guardar la campaa sta nos aparecer en la lista de campaas. Observe que en el ejemplo, la
campaa est detenida (ya que la hemos creado en modo pausa). Para lanzar la campaa haga clic
sobre el enlace Resume de la campaa.
Debe tener en cuenta que para que las campaas funcionen tiene que estar corriendo el proceso de
envo de mensajes en su PBX. Este proceso se encarga de obtener los nmeros de las campaas
activas y los entrega a su proveedor de envo de mensajes SMS. Para conocer ms sobre este
proceso, y cmo se activa, consulte 10. - Servicio de envo de mensajes.
Puede filtrar la lista de campaas por estado, seleccionando un valor de la lista desplegable
Status.
IBEROXARXA SERVICIOS INTEGRALES, S.L.
C.E.T.I.C. CITILAB. PL. CAN SURIS S/N, 2 PL.M1.
08940 - CORNELL DE LLOBREGAT - BARCELONA
e-mail: contactar@iberoxarxa.es
http://www.iberoxarxa.es
Pgina 26
En cualquier momento puede detener la ejecucin de una campaa clic sobre el enlace Stop.
En cualquier momento puede reanudar la ejecucin de una campaa detenida haciendo clic sobre
el enlace Resume.
Tambin puede ver el estado de envo de los nmeros de la campaa haciendo clic sobre el enlace
Numbers de la campaa:
http://www.iberoxarxa.es
Pgina 27
http://www.iberoxarxa.es
Pgina 28
9. Colas de mensajes
La cola de mensajes es un caso particular de campaa, que se utiliza para encolar peticiones de
envo de SMS desde 6. - Envo de un mensaje SMS.
Debe tener en cuenta que para que las colas funcionen tiene que estar corriendo el proceso de envo
de mensajes en su PBX. Para conocer ms sobre este proceso, y cmo se activa, consulte 10. Servicio de envo de mensajes.
10.
Una de las partes fundamentales del mdulo SMS de IBEROXARXA, es el servicio de envo de
mensajes SMS. Si este servicio no est arrancado no funcionan ni las colas de mensajes, ni las
campaas masivas de sms.
Para ejecutar el servicio escriba lo siguiente desde la consola del sistema operativo de su PBX:
service ixxmassivesms start
Si desea que el servicio de envo de mensajes arranque cada vez que se arranque su PBX, escriba lo
siguiente desde la consola del sistema operativo de su PBX:
chkconfig ixxmassivesms on
http://www.iberoxarxa.es
Pgina 29