Proveedor de mensajes

El proveedor de mensajes le permite escuchar los webhooks de la aplicación Messages API.

Funciones

  • onMessage - Esta función te permite recibir mensajes entrantes mediante la Messages API. Consulta el fragmento de código aquí.
  • onMessageEvent - Esta función te permite detectar eventos entrantes mediante la Messages API. Consulta el fragmento de código aquí.

Utiliza el vcr.verifyAuth método para verificar que las llamadas de retorno proceden de la Cloud Runtime Platform. Dado que este proveedor redirige los webhooks a través del enrutador de llamadas de retorno de VCR, también debes validar el X-Vonage-Webhook-Auth-Token encabezado para confirmar que el evento procede de Vonage. Véase Verificar una llamada de retorno para obtener información detallada.

Recibir Webhooks de SMS entrantes

Los SMS entrantes a tus números de Vonage pueden gestionarse mediante la SMS API o la Messages API. Vonage Cloud Runtime utiliza la Messages API, por lo que, para recibir mensajes SMS entrantes en tus aplicaciones, deberás actualizar la configuración de la API en el panel de control de Vonage para enviar los webhooks de SMS entrantes a la Messages API:

API Settings SMS Webhook Toggle

Inicialización del proveedor de mensajes

Para utilizar el proveedor de mensajes, debes crear una instancia del proveedor mediante una sesión:

const session = vcr.createSession();
const messaging = new Messages(session);

Caso práctico

Por ejemplo, para utilizar el proveedor de mensajes para escuchar todos los mensajes SMS entrantes al número de Vonage:

const session = vcr.createSession();
const messaging = new Messages(session);

const vonageNumber = { type: "sms", number: "447700900000" };
const from = { type: "sms", number: null }; 

await messaging.onMessage("onMessage", from, vonageNumber);