Webhook API

Webhook

I webhook notificano la tua applicazione in tempo reale quando si verificano eventi in myumbrella.ai, come la presentazione di un nuovo reclamo o l’attivazione di un contratto.

Configurazione dei Webhook

1. Vai su Impostazioni → Webhook → Aggiungi Endpoint
2. Inserisci l’URL del tuo endpoint (deve essere HTTPS)
3. Seleziona gli eventi che desideri ricevere
4. Salva e copia il segreto di firma

Tipi di Eventi

Evento	Trigger
contract.created	Nuovo contratto di garanzia attivato
contract.cancelled	Contratto annullato o rimborsato
claim.submitted	Nuovo reclamo presentato
claim.approved	Reclamo approvato per la risoluzione
claim.denied	Reclamo rifiutato
claim.resolved	Risoluzione del reclamo completata
plan.updated	Configurazione del piano di garanzia modificata

Formato del Payload

{
  "id": "evt_abc123",
  "type": "claim.submitted",
  "created_at": "2025-01-15T10:30:00Z",
  "data": {
    "claim_id": "clm_xyz789",
    "contract_id": "ctr_def456",
    "customer_email": "jane@example.com",
    "issue_type": "accidental_damage",
    "amount": 299.99
  }
}

Verifica delle Firme

Ogni webhook include un header X-Umbrella-Signature. Verificalo per garantire l’autenticità:

const crypto = require('crypto');

function verifyWebhook(payload, signature, secret) {
  const expected = crypto
    .createHmac('sha256', secret)
    .update(payload)
    .digest('hex');
  return crypto.timingSafeEqual(
    Buffer.from(signature),
    Buffer.from(expected)
  );
}

Politica di Ripetizione

Le consegne non riuscite (risposta non-2xx) vengono ripetute fino a 5 volte con backoff esponenziale: 1 min, 5 min, 30 min, 2 ore, 24 ore.