API de instalaciones locales de la Plataforma de WhatsApp Business

Webhooks para la API de instalaciones locales

Suscríbete a Webhooks para obtener notificaciones sobre los mensajes que recibe tu empresa y actualizaciones del perfil de tus clientes. Consulta Información general, Webhooks a fin de obtener más información sobre los webhooks de la plataforma de WhatsApp Business.

La configuración de webhooks no afectará el número de teléfono en tu Aplicación WhatsApp Business. Una vez que migres tu 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 sea compatible con HTTPS y tenga un certificado SSL válido
  • Un punto de conexión de URL de devolución de llamada que esté configurado para aceptar solicitudes entrantes desde la aplicación principal
  • Un punto de conexión de URL de devolución de llamada que devuelva una respuesta HTTPS 200 OK cuando se reciba una notificación

Reintentar.

Si por algún motivo, una notificación no se entrega o si la solicitud de webhook devuelve un código de estado HTTP distinto de 200, volveremos a intentar la entrega. Volveremos a intentar las entregas con intervalos crecientes hasta un tiempo de espera determinado (por lo general, 24 horas, aunque esto puede variar) o hasta que la entrega se realice correctamente.

Configura el punto de conexión de la URL de devolución de llamada

Envía una solicitud PATCH al punto de conexión /v1/settings/application con el parámetro webhooks configurado para el punto de conexión de la URL de devolución de llamada. Otros parámetros que se suelen configurar 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 la solicitud se envía correctamente, la respuesta contiene 200 OK con un objeto null o JSON.

Visita la referencia sobre la configuración de la app para obtener más información sobre cómo configurar tu app y sobre parámetros de webhooks adicionales.

Carga de notificaciones de webhooks

Cada vez que se produce un evento de activación, la plataforma de WhatsApp Business detecta el evento y envía inmediatamente una notificación a la URL del webhook que hayas especificado anteriormente. Se pueden recibir dos tipos de notificaciones:

  • Mensajes recibidos: esta alerta te permite saber cuando recibiste un mensaje. En este documento, también se hace referencia a estos mensajes como "notificaciones entrantes".
  • Notificaciones de precios y estados de mensajes: esta alerta te permite saber cuando cambia el estado de un mensaje, por ejemplo, si se leyó o se entregó. En este documento, también se hace referencia a estos mensajes como "notificaciones salientes".

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

Puntos de conexión de app de ejemplo

Si quieres probar tus webhooks, puedes crear una app de ejemplo con un punto de conexión para recibir notificaciones.