Recibir mensajes SMS

El servicio de mensajería Atmosphere® le permite recibir fácilmente mensajes SMS a través de sus números telefónicos de IntelePeer. Los mensajes que reciba en su número telefónico de IntelePeer son entregados por medio de HTTP POST al destino que usted elija.

Cómo indicarle al servicio de mensajería Atmosphere® dónde enviar los mensajes entrantes

Puede configurar un webhook de destino para cada uno de sus números telefónicos de dos maneras:

  • Configurando el webhook en el portal del cliente.
  • Configurando el webhook haciendo una llamada a la API de configuración. Para más información, visite Aprovisionar números telefónicos.

Recibir mensajes por medio de la API

Cuando un número habilitado para SMS recibe un mensaje, el servicio de mensajería Atmosphere® intenta entregar el mensaje al URL que usted especificó cuando configuró el número.

El mensaje se entrega como un POST en su URL.

Parámetros

Los siguientes datos se entregan en el cuerpo del POST:

ParámetroTipo de datosDescripción
refidstringIdentificador de este mensaje; tiene una extensión de 32 caracteres. Este identificador también se puede encontrar en el MDR.
fromstringEl número desde el cual se envió el texto en formato E.164.
tostringEl número al cual se envió el texto en formato E.164.
messagestringEl contenido del mensaje de texto.
signaturestringEl código compartido configurado en el portal del cliente. Use este código para verificar que el mensaje fue enviado desde IntelePeer.
Ejemplo
{
    "refid": "ABCDEF1234567890ABCDEF1234567890",
    "from": "+7708675309",
    "to": "+13038675309",
    "message": "Hello World!",
    "signature": "SECRET CODE"
}
Comportamiento

El servicio de mensajería Atmosphere® espera un código de respuesta HTTP 200 de su aplicación. Esta respuesta indica que usted recibió el mensaje correctamente.

Si no se recibe un código de respuesta HTTP 200 de su aplicación, sucederá lo siguiente:

  • El servicio de mensajería Atmosphere® realizará hasta 5 intentos para volver a enviar el mensaje.
  • Cada intento fallido se reflejará en el tablero de control de informe de SMS.