Uso de la API

Utilice nuestra API para el envío masivo de SMS y Whatsapp desde sus propios sistemas. Puede utilizar mútliples lenguajes de preogramación para conectarse con nuestro sistema,cuyo único requerimiento es la capacidad de enviar peticiones POST. Descargar ejemplo PHP


La API permite conectar otros sistemas al servicio de Delivery SMS. El sistema es sencillo, se debe enviar una petición POST a la url http://www.deliverysms.com/api cuyo contenido debe ser un XML válido que contenga la siguiente información para el envío de mensajes:




<enviosms>
<cabecera> 

<usuario>USUARIO</usuario> 

<pass>CONTRASEÑA</pass> 

</cabecera> 

<parametros> 

<programar> 

<fechahora>xx/xx/xxxx xx:xx:xx</fechahora> 

</programar> 

<tipo>0</tipo> <!--0 corto, 1 largo,2 Whatssapp -->

</parametros> 

<detalle> 

<sms> 

<numero>11xxxxxxxxx</numero> 

<telco>-detect.ar</telco> <personal.ar/cti.ar/movistar.ar/nextel.ar/detect.ar obligatorio solo si manda sms corto->

<texto>TEXTO</texto> 

</sms> 

</detalle> 

 </enviosms>
Tipo: debe ser un entero limitado a los siguientes valores:
0 para SMS de número corto
1 para SMS de número largo
2 para Whatsapp

Programar: Permite definir una fecha en formato dd/mm/aaaa hh:mm:ss hora para comenzar con el envío. Puede omitir el parametro completo si desea que el envpio sea inmediato :
En el tag Detalle puede incluir tantos mensajes como se desee, siempre respetando la estructura: <numero></numero> Siendo el telco solo necesario en caso que la campaña sea de tipo Corto

Respuesta de la API

<enviosms_response> 

<error_desc>No envió datos mediante POST</error_desc> 

<numero>11xxxxxxxxx</numero> 

<mensaje>Aquí el texto del mensaje enviado</mensaje> 

<telco>personal.ar</telco>  <!-- Telcos: personal.ar/cti.ar/movistar.ar/nextel.ar/detect.ar-->

<estado>1</estado> <!-- 1 cuando el envio es correcto, 0 cuando hay alguna falla-->

<estado_desc>OK</estado_desc>  <!-- Descripcion de texto correspondiente al número de estado del campo superior-->

</enviosms_response> 
El xml de respuesta trae un error genérico (en caso de existir) y en el detalle los errores específicos de cada envío. Los estados posibles son 1 y 0.
Códigos de Error posibles:
  • Error 5 La fecha de comienzo de envío de la campaña es inválida
  • Error 4 No envió mensajes válidos en el xml para ser procesados
  • Error 3 tipo de mensaje no definido( debe definir si es de numero corto , largo o whatsapp)
  • Error 3 usuario o contraseña inválidos
  • Error 2 No introdujo un nombre de usuario y/o contraseña
  • Error 1 El xml enviado no es válido o bien no envió mediante POST
  • Nota: La respuesta de errores será una por cada mensaje enviado y para cada uno un estado/error
Estado 1 cuando el envio es correcto
Estado 0 cuando hay alguna falla

Estado_desc: Descripcion de texto correspondiente al número de estado del campo superior :