SMS recibidos

Para recibir SMS entrantes, cree un punto final del webhook y configura tu Account para utilizarlo en la pestaña «Configuración de la API» de la Panel de control para desarrolladores de Vonage.

Cualquier mensaje enviado a uno de tus números virtuales de Vonage se reenvía a tu webhook mediante una solicitud GET o POST. Cuando recibas un mensaje en tu webhook, debes enviar un 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 tu 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 tu número virtual. Sí
msisdn El número de teléfono desde el que se envió este mensaje recibido de. Sí
messageId Identificador único de Vonage para este mensaje. Sí
message-timestamp El UTC±00:00 En el momento en que Vonage comenzara a enviar este mensaje entrante a tu punto final de webhook, con el siguiente formato: YYYY-MM-DD HH:MM:SS. Sí
timestamp El 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 unicode, las siguientes propiedades aparecen en la solicitud enviada a tu punto final de webhook.

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 binary, las siguientes propiedades aparecen en la solicitud enviada a tu punto final de webhook.

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 tu número virtual no supera la longitud máxima permitida para un solo mensaje, las siguientes propiedades no aparecerán en la solicitud enviada a tu punto final de webhook.

Si el mensaje supera el número máximo de caracteres permitidos en un solo mensaje, lo recibirás por 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 que componen este mensaje concatenado.
concat-part El número de esta parte del mensaje. La primera parte del mensaje es 1.