Payload Webhook

Struttura del payload inviato dai webhooks.

Formato Generale

{
  "event": "contact.created",
  "timestamp": "2025-01-15T10:30:00Z",
  "webhook_id": "wh_abc123",
  "data": {
    // Dati specifici dell'evento
  }
}

Campo	Tipo	Descrizione
event	string	Nome dell'evento
timestamp	ISO 8601	Quando è avvenuto
webhook_id	string	ID del webhook
data	object	Dati della risorsa

Esempi per Evento

contact.created

{
  "event": "contact.created",
  "timestamp": "2025-01-15T10:30:00Z",
  "data": {
    "id": 123,
    "first_name": "Mario",
    "last_name": "Rossi",
    "email": "mario@example.com",
    "phone": "+39 123 456 7890",
    "company_id": 5,
    "stage": "lead",
    "created_at": "2025-01-15T10:30:00Z"
  }
}

deal.won

{
  "event": "deal.won",
  "timestamp": "2025-01-15T10:30:00Z",
  "data": {
    "id": 45,
    "name": "Progetto CRM",
    "value": 50000,
    "contact_id": 123,
    "company_id": 5,
    "stage": "won",
    "closed_at": "2025-01-15T10:30:00Z"
  }
}

appointment.created

{
  "event": "appointment.created",
  "timestamp": "2025-01-15T10:30:00Z",
  "data": {
    "id": 78,
    "title": "Demo prodotto",
    "type": "video",
    "start_at": "2025-01-20T10:00:00Z",
    "end_at": "2025-01-20T10:30:00Z",
    "contact_id": 123,
    "booking_page_id": 3
  }
}

deal.stage_changed

{
  "event": "deal.stage_changed",
  "timestamp": "2025-01-15T10:30:00Z",
  "data": {
    "id": 45,
    "name": "Progetto CRM",
    "previous_stage": "proposal",
    "new_stage": "negotiation",
    "value": 50000
  }
}

Header della Richiesta

POST /your-webhook-endpoint HTTP/1.1
Host: your-server.com
Content-Type: application/json
X-BladeCRM-Signature: sha256=abc123...
X-BladeCRM-Event: contact.created
X-BladeCRM-Delivery: del_xyz789

Header	Descrizione
X-BladeCRM-Signature	Firma HMAC
X-BladeCRM-Event	Nome evento
X-BladeCRM-Delivery	ID delivery unico