Webhooks de l'API

Webhooks

Les webhooks notifient votre application en temps réel lorsque des événements se produisent dans myumbrella.ai, comme le dépôt d’une nouvelle réclamation ou l’activation d’un contrat.

Configuration des Webhooks

1. Allez dans Paramètres → Webhooks → Ajouter un Endpoint
2. Saisissez l’URL de votre endpoint (doit être HTTPS)
3. Sélectionnez les événements que vous souhaitez recevoir
4. Enregistrez et copiez le secret de signature

Types d’Événements

Événement	Déclencheur
contract.created	Nouveau contrat de garantie activé
contract.cancelled	Contrat annulé ou remboursé
claim.submitted	Nouvelle réclamation déposée
claim.approved	Réclamation approuvée pour résolution
claim.denied	Réclamation refusée
claim.resolved	Résolution de la réclamation terminée
plan.updated	Configuration du plan de garantie modifiée

Format du 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
  }
}

Vérification des Signatures

Chaque webhook inclut un en-tête X-Umbrella-Signature. Vérifiez-le pour garantir l’authenticité :

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)
  );
}

Politique de Nouvelles Tentatives

Les livraisons échouées (réponse non 2xx) sont réessayées jusqu’à 5 fois avec un délai exponentiel : 1 min, 5 min, 30 min, 2 heures, 24 heures.