Webhooks

Los webhooks permiten que tu aplicación reciba notificaciones en tiempo real cuando ocurren eventos en tu workspace BuzzBip. BuzzBip envía una solicitud HTTP POST a tu endpoint configurado con un payload JSON.

Configurar webhooks

1. Ve a Settings → Developer → Webhooks en tu workspace BuzzBip
2. Haz clic en Add Webhook e introduce la URL de tu endpoint HTTPS
3. Selecciona los eventos a los que quieres suscribirte
4. Guarda y copia el signing secret para verificar el payload
5. Responde con 200 OK en 10 segundos para confirmar la recepción

Eventos compatibles

Ejemplo de payload

{
  "id": "evt_7f3a9b2c",
  "type": "message.received",
  "createdAt": "2026-06-01T14:32:00Z",
  "data": {
    "messageId": "msg_abc123",
    "conversationId": "conv_xyz789",
    "contactId": "cnt_def456",
    "channel": "whatsapp",
    "body": "Hello, I need help with my order",
    "from": "+21612345678"
  }
}

Verificar firmas

Cada solicitud webhook incluye un encabezado X-BuzzBip-Signature. Calcula un hash HMAC-SHA256 del cuerpo bruto de la solicitud usando tu signing secret y compáralo con el valor del encabezado para verificar la autenticidad.