Webhooks para la API local
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.
Antes de empezar
Necesitarás lo siguiente:
- Código que admita HTTPS y tenga un certificado SSL válido.
- Un extremo de una URL de devolución de llamada configurado para aceptar las solicitudes entrantes de la aplicación principal.
- Un extremo de una URL de devolución de llamada que devuelva una respuesta
HTTPS 200 OKal recibir una notificación.
Reintentar
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.
Establecer el extremo de una URL de devolución de llamada
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.
Ejemplo de solicitud
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.
Carga útil de las notificaciones de 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:
- Mensajes recibidos: esta alerta te avisa cuando has recibido un mensaje. También se denominan “notificaciones entrantes” en la documentación.
- Notificaciones de precios y de estado de los mensajes: esta alerta te avisa cuando ha cambiado el estado de un mensaje (por ejemplo, el mensaje se ha leído o entregado). También se denominan “notificaciones salientes” en la documentación.
Consulta Componentes para obtener información sobre cada campo.
Notificación de errores
{
"errors": [ {
"code": <error-code>,
"title": "<error-title>",
"details": "<error-description>",
"href": "location for error detail"
},
{
...
}
]
}
