Suscríbete a los webhooks para recibir notificaciones sobre los mensajes que reciba tu empresa y las actualizaciones del perfil de cliente. Consulta la página con información general sobre los webhooks para obtener más información sobre los webhooks de la Plataforma de WhatsApp Business.
La configuración de los webhooks no afectará al número de teléfono de la aplicación WhatsApp Business. Una vez que migres un número de teléfono a la Plataforma de WhatsApp Business, ya no podrás usarlo en la aplicación WhatsApp Business.
Necesitarás lo siguiente:
HTTPS 200 OK
al recibir una notificación.Si una notificación no se entrega por cualquier motivo o la solicitud del webhook devuelve un código de estado HTTP distinto de 200
, la entrega se vuelve a intentar. La entrega se sigue intentando con tiempos de retraso cada vez mayores hasta agotar un tiempo de espera determinado (normalmente, un plazo de 24 horas, aunque puede variar) o hasta que la entrega se realiza correctamente.
Envía una solicitud PATCH
al extremo /v1/settings/application
con el parámetro webhooks
establecido en el extremo de la URL de devolución de llamada. Otros parámetros que normalmente se configuran son sent_status
y callback_persist
.
PATCH /v1/settings/application { "callback_persist": true, "sent_status": true, // Either use this or webhooks.message.sent, but webhooks.message.sent property is preferred as sent_status will be deprecated soon "webhooks": { "url": "webhook.your-domain", "message": { // Available on v2.41.2 and above "sent": false, "delivered": true, "read": false }, } }
Si se lleva a cabo correctamente, la respuesta contiene 200 OK
con un valor null
o un objeto JSON.
Consulta la referencia sobre la configuración de la aplicación para obtener más información sobre la configuración de la aplicación y los parámetros adicionales de los webhooks.
Cuando se produce un evento de activación, la Plataforma de WhatsApp Business ve el evento y envía una notificación a la URL de un webhook que se ha especificado previamente. Puedes recibir dos tipos de notificaciones:
Consulta Componentes para obtener información sobre cada campo.
{ "errors": [ { "code": <error-code>, "title": "<error-title>", "details": "<error-description>", "href": "location for error detail" }, { ... } ] }