API HTTP: enviar SMS
1. Descripción
El Interfaz HTTP te permite enviar mensajes prácticamente desde cualquier plataforma.
Solo tienes que integrar la llamada a una URL en el lenguaje de programación que estés utilizando.
Podrás enviar mensajes desde una página Web con un simple formulario, una aplicación gráfica en Windows, un script en linea de comandos en Linux, etc...
La llamada a la URL se hace pasando como parámetros las credenciales de autenticación, el mensaje y los destinatarios.
2. Documentación
URL:
Encriptada:
https://www.descomsms.com/dmapi/dmsend.php
sin encriptar:
http://www.descomsms.com/dmapi/dmsend.php
Petición de envío
Para poder enviar mensajes, deberás acceder a la URL arriba indicada
proporcionando la siguiente información en formato POST:
| https://www.descomsms.com/dmapi/dmsend.php? usuario=xxx&clave=xxx&idc=xxx&dest=xxxxxx&texto=xxxxxx |
Parámetros POST:
Los valores ingresados deberán cumplir los siguientes valores, para ser enviados como parte de la petición:
| Nombre Parámetro |
Requerido | Descripción | Posibles Valores | Tipo de Dato |
| usuario | Sí | Identificador de usuario | Identificador de usuario en Descom SMS | Alfanumérico |
| clave |
Sí |
Contraseña de acceso a la plataforma | Contraseña del usuario en Descom SMS |
Alfanumérico |
| idc |
Sí |
Identificador de cliente | Identificador de cliente en Descom SMS | Numérico
|
| rem | Remitente personalizado* | Una cadena alfanumérica de hasta 11 caracteres | Alfanumérico | |
| dest | Sí | Números de teléfono destinatario del mensaje |
Teléfono en formato: Para enviar varios destinatarios, separa cada número por coma. Ej: 0034666555444,0034666555441,0034666555442 |
Numérico |
| texto | Sí | Texto del mensaje |
Texto del mensaje a enviar, URL codificado. |
Alfanumérico |
| max | Numero máximo de sms a dividir |
0 -> para no tener límite de SMS. (por defecto) Un número mayor que cero para indicar el máximo de SMS de un mensaje largo. |
Numérico | |
| aviso |
Envía un aviso de notificación por email para cada SMS enviado. |
0 -> No envía notificación por email (por defecto) |
Numérico | |
| idenvio | Identificador opcional del envío | Cadena de texto para identificar un grupo de mensajes (opcional) | Alfanumérico |
* Puedes personalizar el remitente de los SMS, con su número de móvil autorizado, en formato no internacional (ej: 609111222), o con una cadena de texto; en este caso, consulte antes con Esta dirección de correo electrónico está protegida contra spambots. Usted necesita tener Javascript activado para poder verla. para configurar su remitente.
Obtener saldo y comprobación de autenticación:
LLamada:
https://www.descomsms.com/dmapi/dmsend.php?usuario=xxx&clave=xxx&idc=xxx
Respuesta:
OK: IDENVIO: 0 MOK: 0 MERR: 0 SALDO: 30905
o en caso de error de autenticación
ERR: Descripcion del error de autenticación
Enviar un mensaje simple
LLamada:
https://www.descomsms.com/dmapi/dmsend.php?usuario=xxx&clave=xxx&idc=xxx&dest=00346xxxxxxxx&texto=Hola
Respuesta:
Envío correcto
OK: IDENVIO: 123456 MOK: 1 MERR: 0 SMSOK: 1 SMSERR: 0 CRED: 1 SALDO: xx
1:OK ID: 123 DEST: 00346xxxxxxxx RES: Mensaje Enviado
o en caso de error de envío
OK: IDENVIO: 123456 MOK: 0 MERR: 1 SMSOK: 0 SMSERR: 1 CRED: 0 SALDO: xx
1:ERR ID: 0 DEST: 00346xxxxxxxx RES: Mensaje No Enviado. Movil no valido
Enviar un mensaje múltiple
LLamada:
https://www.descomsms.com/dmapi/dmsend.php?usuario=xxx&clave=xxx&idc=xxx&dest=00346xxxxxxx1,00346xxxxxxx2,00346xxxxxxx3&texto=Hola
Respuesta:
Envío correcto
OK: IDENVIO: 123456 MOK: 3 MERR: 0 SMSOK: 3 SMSERR: 0 CRED: 3 SALDO: xx
1:OK ID: 123 DEST: 00346xxxxxxx1 RES: Mensaje Enviado
2:OK ID: 124 DEST: 00346xxxxxxx2 RES: Mensaje Enviado
3:OK ID: 125 DEST: 00346xxxxxxx3 RES: Mensaje Enviado
o en caso de error de envío
OK: IDENVIO: 123456 MOK: 1 MERR: 2 SMSOK: 1 SMSERR: 2 CRED: 1 SALDO: xx
1:ERR ID: 0 DEST: 00346xxxxxxxx RES: Mensaje No Enviado. Movil no valido
2:OK ID: 124 DEST: 00346xxxxxxx2 RES: Mensaje Enviado
3:ERR ID: 125 DEST: 00346xxxxxxx3 RES: Mensaje No Enviado. Movil no valido
Donde:
La primera línea devuelve el estado y resumen del envío.
| Nombre | Descripción | Valores | Tipo de Datos |
| IDENVIO | Identificador alfanumérico del envío. Este identificador te puede servir para obtener el reporte de envío asociado. |
Alfanumérico |
|
| MOK |
Número de mensajes enviados correctamente |
Numérico |
|
| MERR | Número de mensajes no enviados |
Numérico |
|
| SMSOK | Número de SMS enviados correctamente | Numérico | |
| SMSERR | Número de SMS no enviados | Numérico | |
| CRED | Crédito gastado en en enviar todos los mensajes | Numérico | |
| SALDO | Saldo actual en créditos después de realizar el envío | Numérico |
Por cada mensajes enviado se devuelve una línea indicando el estado del mensaje.
| Nombre | Descripción | Valores | Tipo de Datos |
| x: | Número de mensaje en el envío | 1,2,3... | Numérico |
| [OK,ERR] | Estado de envío del mensaje. |
OK -> Envío correcto. |
Texto |
| ID | Identificador único del mensaje en Descom SMS. Este identificador se puede usar para obtener el report en entrega. | Numérico | |
| DEST | Número de móvil al que se ha enviado el mensaje | Numérico | |
| RES | Texto descriptivo del envío correcto o incorrecto | Alfanumérico |
3. Ejemplos
4. Gráfico
Soporte Técnico:
 |
Esta dirección de correo electrónico está protegida contra spambots. Usted necesita tener Javascript activado para poder verla. |
Ahora puedes enviar también los mensajes SMS con Outlook, de forma fácil y segura.
[más info]
