• Objetivo
• Arquitectura de Referencia
• Características
• Guía Básica
• Resolución de Problemas
• Preguntas Frecuentes
• Documentación Corporativa
• Contacto
• Otros Recursos

Bienvenido a la página de Servicios SMS

Objetivo

Aquí encontrará detalles de cómo acceder a nuestros servicios de Mensajería Corta.

Arquitectura de Referencia

Vista arquitectónica.

Documentación Corporativa

Descripción de servicios.

Características

Guía Básica

1. Regístrese
2. Pruebe nuestros servicios de verificación de acceso:
   • Usando SoapUI:
     1. Descargue nuestro proyecto SoapUI² con ejemplos.
     2. Descomprima e importe el proyecto.
     3. De acuerdo al mecanismo seleccionado, modifique los valores de los ítemes username y password para que coincidan con las credenciales de su cuenta, a través de:
        • SMSPortBinding > Interface viewer > Service Endpoints or
        • https://sms.lanube.cl > Service Viewer > Service Endpoints
     4. Use los requerimientos de prueba para acceder los servicios echo o greet.
   • Usando cURL:
     1. Pruebe el servicio SOAP echo: [user@host ~]$ cat > echo_request.xml <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:web="http://web.services.sms.redvoiss.net/"> <soapenv:Header/> <soapenv:Body> <web:echo> <!--Optional:--> <arg0>Hello again!</arg0> </web:echo> </soapenv:Body> </soapenv:Envelope> [user@host ~]$ curl -u username -H "Content-Type: text/xml;charset=UTF-8" -d @echo_request.xml https://sms.lanube.cl/services/SMSService Enter host password for user 'username': <?xml version='1.0' encoding='UTF-8'?><S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/"><S:Body><ns2:echoResponse xmlns:ns2="http://web.services.sms.redvoiss.net/"><return>Message is: Hello again!.</return></ns2:echoResponse></S:Body></S:Envelope> [user@host ~]$
     2. Pruebe el recurso RESTful greet:
        • Interactivamente, p.e., usando el siguiente comando: [user@host ~]$ curl -u username -X GET https://sms.lanube.cl/services/rest/greet Enter host password for user 'username': Hello username! Local time is 2018-04-27 11:22:46.0 [user@host ~]$
        • Vía CLI (Esta opción es menos recomendada, aunque igual de válida. Podría eventualmente exponer las credenciales a un observador potencial, el que de todas maneras debería con acceso a la misma máquina desde donde se ejecuta este comando y debería contar con un nivel de privilegios apropiado para listar los comandos en ejecución): [user@host ~]$ curl -u username:password -X GET https://sms.lanube.cl/services/rest/greet Hello username! Local time is 2018-04-27 11:22:46.0 [user@host ~]$
3. Cargue saldo a su cuenta.
4. Envíe mensajes:
   • Usando SoapUI:
     1. SOAP: modifique el requerimiento de ejemplo disponible para la operación sendBulkMessage
     2. RESTful: modifique el requerimiento de ejemplo disponible para el recurso Send. You can also find a more detailed schema for the input used here.
   • Usando cURL:
     1. Envie un mensaje a través de un endpoint SOAP usando el siguiente ejemplo: [user@host ~]$ cat > request.xml <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:web="http://web.services.sms.redvoiss.net/"> <soapenv:Header/> <soapenv:Body> <web:sendBulkMessage> <!--Optional:--> <bulkMessage> <!--1 or more repetitions:--> <message_details> <destination>569XXXXXXXX</destination> <!--Optional:--> <field>World!</field> </message_details> <!--Optional:--> <bulkName>SOAP campaign</bulkName> <isCommercial>false</isCommercial> <message>Hello %CAMPO4%</message> </bulkMessage> </web:sendBulkMessage> </soapenv:Body> </soapenv:Envelope> ^D [user@host ~]$ curl -u username -H "Content-type: text/xml;charset=utf-8" -d @request.xml https://sms.lanube.cl/services/SMSService Enter host password for user 'username': <?xml version='1.0' encoding='UTF-8'?><S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/"><S:Body><ns2:sendBulkMessageResponse xmlns:ns2="http://web.services.sms.redvoiss.net/"><return>22YYYYYY</return></ns2:sendBulkMessageResponse></S:Body></S:Envelope> [user@host ~]$
     2. Envie un mensaje a través de un recurso Rest usando el siguiente ejemplo: [user@host ~]$ curl -u username -H "Content-Type: application/json" -X POST -d '{"bulkName": "RESTful campaign", "message": "Hello %CAMPO4%", "message_details": [{"destination": "569XXXXXXXX", "field": "World!"}], "isCommercial": false}' https://sms.lanube.cl/services/rest/send Enter host password for user 'username': {"batchId":"165405XX"} [user@host ~]$
     3. Envie un mensaje programado para ser enviado en una fecha específica a través de un recurso Rest usando el siguiente ejemplo: [user@host ~]$ curl -u username -H "Content-Type: application/json" -X POST -d '{"bulkName": "RESTful campaign", "message": "Hello %CAMPO4%", "message_details": [{"destination": "569XXXXXXXX", "field": "World!"}], "isCommercial": false, "sendDate": "2010-08-20T01:00:00-04:00"}' https://sms.lanube.cl/services/rest/send Enter host password for user 'username': {"batchId":"165405XX"} [user@host ~]$
     4. Envie un mensaje con respuesta a través de un recurso Rest usando el siguiente ejemplo: [user@host ~]$ curl -u username -H "Content-Type: application/json" -X POST -d '{"bulkName": "RESTful campaign", "message": "Hello %CAMPO4%", "message_details": [{"destination": "569XXXXXXXX", "field": "World!"}], "isCommercial": false}' https://sms.lanube.cl/services/rest/sendWithReply Enter host password for user 'username': {"batchId":"165405XX"} [user@host ~]$
5. Verifique estados:
   • Usando cURL:
     1. Verifique el estado de una campaña, recuerde reemplazar el parámetro XXXXXXX con un identificador de lote válido: [user@host ~]$ curl -u username -H "Content-Type: application/json" -X GET https://sms.lanube.cl/services/rest/batch/{batchId}/status Enter host password for user 'username': [{"msgCod":50428472,"destination":"569ABCDEFGH","message":"ENVIO PENDIENTE"},{"msgCod":50428473,"destination":"569ABCDEFGH","message":"ENVIO PENDIENTE"}]
     2. Verifique el estado de un mensaje, recuerde reemplazar el parámetro XXXXXXX con un identificador de mensaje válido: [user@host ~]$ curl -u username -H "Content-Type: application/json" -X GET https://sms.lanube.cl/services/rest/message/{messageId}/status Enter host password for user 'username': {"msgCod":50428472,"status":"ENVIO PENDIENTE"}
6. Verifique respuestas:
   • Usando cURL:
     1. Verifique la respuesta de una campaña habilitada para recibirlas: [user@host ~]$ curl -u username -H "Content-Type: application/json" -X GET https://sms.lanube.cl/services/rest/batch/{batchId}/replies Enter host password for user 'username': {"batchId":16540523,"messageReplyList":[{"replyId":1202,"date":1524538800000,"message":"Fake reply 1"},{"replyId":1203,"date":1524538800000,"message":"Fake reply 2"}]}
     2. Verifique la respuesta de un mensaje que forma parte de una campaña habilitada para recibirlas: [user@host ~]$ curl -u username -H "Content-Type: application/json" -X GET https://sms.lanube.cl/services/rest/message/{messageId}/replies Enter host password for user 'username': [{"replyId":1202,"date":1524538800000,"message":"Fake reply 1"},{"replyId":1203,"date":1524538800000,"message":"Fake reply 2"}]

Resolución de problemas

Preguntas Frecuentes

P: ¿Cuáles son los posibles estados de un mensaje?
R: Los posibles estados de un mensaje son

• ENVIO PENDIENTE: Mensaje cargado en plataforma, listo para ser enviado
• ENVIADO: Mensaje enviado al móvil
• RECIBIDO: Mensaje confirmado
• FALLIDO: Mensaje que falla en su envío al móvil
• ERROR: Mensaje en un estado distinto a los anteriormente definidos

P: ¿Existe algún otro recurso con respuestas a consultas recurrentes?
R: Si, en el siguiente sitio.

P: ¿Cuáles son las operaciones que se pueden realizar a través de los recursos disponibles en este sitio?
R: A través de los recursos disponibles de este sitio podrás:

1. Cargar una campaña en el sistema, con la posibilidad de programarla para una fecha futura, y parametrizando los mensajes que la componen si es necesario.
2. Consultar por el estado de una campaña específica.
3. Consultar por el estado de un mensaje específico.
4. De haber respuestas a una campaña, consultar por ellas en conjunto o una a una.

Contacto

Contacto comercial.

Contacto técnico.

Otros Recursos

Qualys® SSL Labs: SSL Report: sms.lanube.cl