Webhooks > Notification

Este webhook se llama en cada evento de notificación de un mensaje de texto, correo electrónico o mensaje de WhatsApp vinculado a una solicitud de pago o a una suscripción: cuando se envía, se entrega, se lee, se retrasa o falla, y cuando el cliente hace clic en el enlace de pago. El siguiente formato de datos se enviará por POST a la URL del webhook proporcionada.

El campo message es una oración legible para personas y no un código, y su redacción no forma parte del contrato de la API. Un envío se lee como "Payment Request sent to customer@example.com", una actualización de estado posterior como "Sms to +15555550100 delivered" y un clic como "Customer clicked the text link". Base la lógica de su integración en el booleano error y en los ids de los registros, no en la redacción.

Eventos de notificación

Cada uno de estos eventos envía su propio webhook. La carga no nombra el evento: error es true para una entrega fallida o parcialmente fallida y false para cualquier otro evento, y message describe el evento para que lo lean las personas.

Evento
Cuándo se envía
error
sent
El mensaje de texto, correo electrónico o mensaje de WhatsApp salió, y de nuevo cada vez que el proveedor lo reporta como enviado, por lo que un mismo mensaje puede producir varios.
false
delivered
El operador, el servidor de correo o WhatsApp confirmó la entrega.
false
read
El cliente abrió el correo electrónico o leyó el mensaje de WhatsApp. Los mensajes de texto nunca lo reportan.
false
delayed
Solo correo electrónico: el servidor de correo receptor aplazó el correo y la entrega se está reintentando.
false
clicked
Se abrió el enlace de pago, normalmente por el cliente desde el mensaje de texto o el correo electrónico.
false
partial
Solo correo electrónico: el correo falló para algunas de las direcciones del cliente, pero no para todas.
true
failed
No se pudo entregar el mensaje.
true
Notificación de entrega o clic
			
{
  "action": "notification",
  "data": {
    "site": {
      "id": "6201825a0cf5e23261a08646",
      "external_id": "65523213",
      "merchant_id": "123123123123"
    },
    "invoice": {
      "id": "649dc5bb468bd5b5d863c7d2",
      "external_id": "39772634"
    },
    "message": "Customer clicked the text link",
    "error": false
  }
}


		
Notificación fallida
			
{
  "action": "notification",
  "data": {
    "site": {
      "id": "6201825a0cf5e23261a08646",
      "external_id": "65523213",
      "merchant_id": "123123123123"
    },
    "invoice": {
      "id": "649dc5bb468bd5b5d863c7d2",
      "external_id": "39772634"
    },
    "message": "Text to 18001231245 failed",
    "error": true
  }
}