Webhooks de mensajes entrantes y de estado de los 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 función de devolución de llamada con la carga útil del mensaje en el Mensaje recibido URL del webhook.

IMPORTANTE: Se deben configurar ambas URL de webhook. Como mínimo, tus controladores de webhook deben devolver respuestas 200 tanto para las llamadas de retorno de «Mensaje entrante» como para las de «Estado del mensaje». Esto garantiza que cualquier posible cola de devolución de llamada se evitan los problemas.

Para configurar las URL de los webhooks

  1. Si ya ha crear una aplicación, pero si aún no has configurado tus webhooks, ve a Sus Applications y selecciona la aplicación que deseas configurar.

  2. Haz clic 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 te permite configurar las URL de los webhooks de recepción de mensajes entrantes y de acuse de recibo 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 webhooks 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 de forma local, puedes utilizar Ngrok.

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

Si utilizas Ngrok de esta forma, deberías emplear las URL de Ngrok como URL de tus webhooks:

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

Cola de webhooks

Ten en cuenta que los webhooks procedentes de Vonage, como los que figuran en la URL del webhook de «Estado del mensaje» y en la URL de «Mensajes entrantes», son puestos en cola por Vonage mensaje a mensaje.

Asegúrate de que todas las aplicaciones respondan a los webhooks con un código de respuesta 200.

Webhooks firmados

Para verificar el origen de tus webhooks, puedes comprobar la firma de los mismos; consulta las instrucciones aquí

Webhooks en producción

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