Webhook
message_status_updated

Estado de mensaje actualizado

Notifica a tu endpoint cada vez que cambia el estado de un mensaje saliente.

Disparador

Este webhook se dispara cada vez que cambia el estado de un mensaje saliente. Aplica exclusivamente a los canales de WhatsApp Business API y QR API. Los mensajes entrantes no generan actualizaciones de estado.

Valores de estado

  • enqueuedEl mensaje llegó correctamente al cliente de la API.
  • sentEl mensaje fue entregado al dispositivo del destinatario.
  • deliveredEl mensaje fue confirmado en el dispositivo del usuario final.
  • readEl usuario final ha leído el mensaje.
  • failedLa entrega no tuvo éxito (se proporciona el motivo del fallo).
  • mismatchWhatsApp corrigió automáticamente el número de teléfono.
  • deletedMensaje eliminado por el destinatario (obsoleto; Meta ya no lo admite).

Ejemplo de payload

json
{
  "event": "message_status_updated",
  "payload": {
    "uuid": "adf3d1216d4c4dcd908199d6700f2381",
    "status": "read",
    "contact": {
      "href": "https://dash.try-eclectic.com/contacts/eb2b914a977e4ab896e7b886698b3eac",
      "conversationHref": "https://dash.try-eclectic.com/chat/f3670b13446b412796238b1cd78899f9",
      "name": "John Doe",
      "tags": ["Lead"],
      "uuid": "eb2b914a977e4ab896e7b886698b3eac",
      "source": "whatsapp",
      "avatarUrl": null,
      "createdAt": "2022-10-12T15:57:16Z",
      "phoneNumber": "331122334455"
    },
    "messageStatusPayload": {
      "id": "gBGGM2MSRxl_Aglqmg5KQXU7ABC",
      "gsId": "2b34bfb7-2631-4763-89fb-1b3c65a4babc",
      "type": "read",
      "payload": {
        "ts": 1686563913
      },
      "destination": "1122334455"
    }
  }
}