GET STARTED
Log In

Enviar mensajes SMS por medio de códigos abreviados

 

 

La API del servicio de mensajería Atmosphere® simplifica el envío y la recepción de mensajes SMS a través de sus códigos abreviados de IntelePeer.

Todos los códigos abreviados de IntelePeer se pueden usar para enviar y recibir mensajes SMS. Los códigos abreviados alfanuméricos no pueden recibir mensajes SMS.

 

Enviar un mensaje SMS

 

Puede enviar un mensaje SMS de código abreviado con una llamada a la API del servicio de mensajería Atmosphere®. Asegúrese de seguir las convenciones de API de IntelePeer.

 

URI

POST a https://api.intelepeer.com/_rest/v4/app/sms/send

 
Parámetros

Este método de API requiere un token de autorización. Para más información sobre tokens de autorización, consulte Autenticación de API Atmosphere®.

Parámetro Tipo de datos Requerido
from string requerido Número con formato de código abreviado (Código de país-Código abreviado) desde el cual se envía el mensaje (por ejemplo, 1-12345, 57-1234)
to string requerido El número en formato E.164 al cual se envía el mensaje (por ejemplo, +13038675309)
text string requerido El mensaje que será enviado
guid string opcional Un identificador que se anexa al mensaje en el Registro de Detalles de Mensajes para cotejarlo con otros registros del sistema.
Ejemplo de código abreviado

{ "from": "1-12345", "to": "+13038675309", "text": "Hello World!", "guid": "1123123123123123" }
 
Códigos de respuesta
Código de respuesta Descripción
202 El mensaje SMS ha sido colocado en cola correctamente para ser entregado al número telefónico de destino.
400 Se produjo uno de los siguientes errores:

  • El número telefónico no se encuentra en un formato de código abreviado correcto
  • El número telefónico no ha sido habilitado para SMS
  • Los campos de texto a/de no están en la solicitud
401 Se produjo uno de los siguientes errores:

  • El token de autorización expiró
  • El usuario no es propietario del número telefónico
  • Actualmente la empresa no tiene habilitado el acceso a la API SMS
403 El destino internacional no se encuentra disponible
404 El cliente no puede usar el número telefónico

 

Ejemplo de respuesta

{ "state": "CREATED", "refid": "SM5AC09A610001006568100005C32E9D" }

 

Comportamiento

 

Los mensajes enviados por medio de la API del servicio de mensajería Atmosphere® son retenidos en cola para ser entregados de forma rápida y confiable al operador de destino, y finalmente, al teléfono del usuario final. Puede comprobar el estado de un mensaje en cualquier momento después de enviarlo. Conozca cómo Comprobar el estado del mensaje. El siguiente es el ciclo de vida del mensaje:

  1. Mensaje retenido en cola para ser entregado
  2. Mensaje entregado al operador móvil
  3. Mensaje entregado al destinatario deseado

Es posible que haya retrasos en la entrega de un mensaje al cliente final por las siguientes razones:

  • Limitación de solicitudes impuesta por IntelePeer para mejorar la entrega de los mensajes
  • El equipo del cliente final se encuentra fuera del área de servicio, está apagado o en modo avión

Podrían ocurrir errores en la entrega del mensaje debido a los filtros de SPAM del operador u otras restricciones específicas del mismo.

 

Enviar mensajes SMS en lote

Es posible utilizar la misma API anterior para enviar mensajes en lote. A continuación se describen las diferencias entre la API de un solo mensaje y la de mensajes en lote:

 

Cambios en la solicitud de la API para enviar mensajes en lote:

La API para enviar un solo mensaje requiere un solo objeto que contiene los parámetros del mensaje. Para usar la API de envío de mensajes en lote, simplemente transforme su JSON en una lista de los siguientes objetos:

 

 Ejemplo

[ { "from": "1-12345", "to": "+13038675309", "text": "Hello World test 1", "guid": "1123123123123123" }, { "from": "1-98765", "to": "+13038678888", "text": "Hello World test 2", "guid": "myguid1" } ]

 

Cambios en la respuesta de la API para enviar mensajes en lote:

La API para enviar un solo mensaje responde con un identificador de referencia (refid), así como la información del estado de la solicitud. La API para enviar mensajes en lote retorna una lista de estas respuestas en la clave del objeto “respuestas”, en la que cada respuesta corresponde a la solicitud relacionada.

Por lo general, el código de respuesta HTTP en lote será 207, independientemente del estado de cada mensaje, a menos que ocurra un error a nivel de la solicitud en general.

 

 Ejemplo

{ "code": 207, "responses": [ { "state": "Queued", "code": 202, "refid": "SM5BE9B76600099999991000DE162EE8" }, { "state": "Queued", "code": 202, "refid": "SM5BE9B766000999999910008CF7795C" } ] }

Cart Overview