SMS entrantes

Para recibir SMS entrantes, cree un punto final de webhook y configure su cuenta para utilizarlo en la pestaña de configuración de la API de la sección Panel de control para desarrolladores de Vonage.

Todos los mensajes enviados a uno de tus números virtuales de Vonage se envían a tu webhook mediante una solicitud

GET
o
POST
. Cuando recibes un mensaje en tu webhook, debes enviar una solicitud
GET
o
POST
. 200 OK o 204 No Content respuesta. Si no lo haces, Vonage asumirá que no has recibido el mensaje y seguirá reenviándolo durante las próximas 24 horas.

Los mensajes concatenados requieren una atención especial. Véase mensajes entrantes concatenados.

Anatomía de un mensaje entrante

Los mensajes se envían a su punto final de webhook como un objeto JSON con las siguientes propiedades:

Clave Valor Requerido
type Los valores posibles son:
  • text - texto estándar
  • unicode - un mensaje de texto que contenga caracteres Unicode
  • binary - un mensaje binario
 Sí
to El número de teléfono al que se envió el mensaje a. Este es su número virtual. Sí
msisdn Número de teléfono al que se envió este mensaje entrante de. Sí
messageId Identificador único de Vonage para este mensaje. Sí
message-timestamp En UTC±00:00 hora en que Vonage comenzó a enviar este mensaje entrante a tu punto final de webhook, en el siguiente formato: YYYY-MM-DD HH:MM:SS. Sí
timestamp En marca de tiempo unix representación de message-timestamp. No
nonce Una cadena aleatoria que añade un elemento extra de imprevisibilidad a la firma de la solicitud. Se utiliza la cadena nonce y timestamp con su secreto compartido para calcular y validar la firma de los mensajes entrantes. Si sus mensajes son firmado

Para los mensajes de tipo text o unicode

Si el type es text o unicodelas siguientes propiedades aparecen en la petición a su webhook endpoint.

Clave Valor
text El cuerpo del mensaje para este mensaje entrante.
keyword La primera palabra del cuerpo del mensaje. Se utiliza normalmente con códigos cortos.

Para los mensajes de tipo binary

Si el type es binarylas siguientes propiedades aparecen en la petición a su webhook endpoint.

Clave Valor
data El contenido de este mensaje
udh La codificación hexadecimal cabecera de datos del usuario

Para mensajes entrantes concatenados

Si un mensaje enviado a su número virtual se ajusta a la longitud máxima permitida de un solo mensaje, las siguientes propiedades no aparecen en la solicitud a su punto final de webhook.

Si el mensaje es más largo que el número máximo de caracteres permitidos en un solo mensaje, recibirá el mensaje en partes y aparecerán las siguientes propiedades en la solicitud.

Utiliza el concat-ref, concat-total y concat-part para construir el mensaje a partir de las partes individuales.

No todos los operadores admiten mensajes concatenados. Si el operador no admite la concatenación, el mensaje concat no estará presente en la carga útil.

Clave Valor
concat true
concat-ref La referencia de la transacción. Todas las partes de este mensaje comparten esto concat-ref.
concat-total El número de partes de este mensaje concatenado.
concat-part El número de esta parte del mensaje. La primera parte del mensaje es 1.