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 OK al 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"
    },
    {
       ...
    }
    ]
 }

Extremos de aplicación de muestra

Para probar los webhooks, puedes crear una aplicación de muestra con un extremo para recibir notificaciones.

  • Extremos de aplicación de muestra mediante Glitch