API SMS HTTP, enviar SMS y envío masivo de SMS

API Enviar SMS y Envío masivo de SMS

1. Enviar SMS y SMS Masivo

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 Identificador de usuario Identificador de usuario en Descom SMS Alfanumérico
clave

Contraseña de acceso a la plataforma Contraseña del usuario en Descom SMS

Alfanumérico

idc

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 Números de teléfono destinatario del mensaje

Teléfono en formato:
acceso internacional + cod. país + teléfono Ejemplo: 0034666555444

Para enviar varios destinatarios, separa cada número por coma.

Ej: 0034666555444,0034666555441,0034666555442

Numérico
texto 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)
1 -> Sí envía notificación por email.

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á siendo protegida contra los robots de spam. Necesita tener JavaScript habilitado para poder verlo. 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
Un mensajes puede ser dividido en varios SMS si este supera los 160 caracteres 

 

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.
ERR->Envío fallido

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

Descarga nuestros ejemplos: ejemplo API SMS HTTP online

4. Gráfico

Enviar-SMS-InterfazHTTP