Webhooks de mensajes entrantes y de estado de mensajes

Debe configurar los webhooks de Mensaje de entrada y de Estado de mensaje.

Configure las URL de sus webhooks

Hay al menos dos webhooks que debes configurar:

  • Webhook de estado de mensajes
  • Webhook de mensajes entrantes

Cuando se generan actualizaciones del estado de los mensajes, como delivered, rejected o acceptedse recibirán devoluciones de llamada en el Estado del mensaje URL del webhook.

Cuando se recibe un mensaje entrante, se invoca una devolución de llamada con la carga útil del mensaje en la carpeta Mensaje entrante URL del webhook.

IMPORTANTE: Ambas URL de webhook deben estar configuradas. Como mínimo, sus gestores de webhooks deberían devolver 200 respuestas tanto para las devoluciones de llamada de mensaje entrante como para las de estado de mensaje. Esto asegura que los posibles cola de devolución de llamada se evitan los problemas.

Para configurar las URL de los webhooks

  1. Si ya ha crear una aplicaciónpero aún no ha configurado sus webhooks, vaya a Sus Applications y seleccione la aplicación que desea configurar.

  2. Haga clic en Editar para modificar las URL de los webhooks de la aplicación.

  3. En la sección Capacidades de mensajes, introduzca las URL de sus webhooks en los campos etiquetados como URL de estado y URL de entrada.

Los valores que introduzcas para las URL de los webhooks dependerán de dónde se encuentre tu servidor de webhooks. Por ejemplo:

Gancho web URL
URL de estado https://www.example.com/webhooks/message-status
URL de entrada https://www.example.com/webhooks/inbound-message

NOTA: Recomendamos utilizar Autenticación basada en JWT ya que esto le permite configurar las URL de los webhooks de recepción y entrega en el a nivel de aplicación. De lo contrario, todas las devoluciones de llamada de sus diferentes aplicaciones se enviarán a su URL de webhook a nivel de Account.

NOTA: Las devoluciones de llamada se envían a través de POST Peticiones HTTP.

Pruebas locales a través de Ngrok

Si quieres probar tu aplicación localmente puedes utilizar Ngrok.

Consulte nuestra información sobre Utilizar Ngrok para el desarrollo local

Si utiliza Ngrok de esta forma, deberá utilizar las URL de Ngrok para las URL de sus webhooks:

  • https://abcdef1.ngrok.io/webhooks/inbound-message
  • https://abcdef1.ngrok.io/webhooks/message-status

Cola de webhooks

Ten en cuenta que los webhooks que provienen de Vonage, como los de tu URL de webhook de estado de mensajes y URL de mensajes entrantes, son puestos en cola por Vonage según el mensaje.

Asegúrese de que todas las aplicaciones reconocen los webhooks con una respuesta 200.

Webhooks firmados

Para validar el origen de sus webhooks, puede validar la firma de los webhooks, consulte las instrucciones aquí

Webhooks en producción

Si las URL de Webhook para mensajes en tu Account de API de Vonage ya están en uso de producción y deseas una segunda para usar la API de Messages, envía un correo electrónico a soporte y solicitar una clave de sub API.