API-Webhooks

Webhooks

Webhooks benachrichtigen Ihre Anwendung in Echtzeit, wenn Ereignisse in myumbrella.ai auftreten, z. B. wenn ein neuer Schadensfall eingereicht oder ein Vertrag aktiviert wird.

Webhooks einrichten

1. Gehen Sie zu Einstellungen → Webhooks → Endpunkt hinzufügen
2. Geben Sie Ihre Endpunkt-URL ein (muss HTTPS sein)
3. Wählen Sie die Ereignisse aus, die Sie empfangen möchten
4. Speichern Sie und kopieren Sie das Signierungsgeheimnis

Ereignistypen

Ereignis	Auslöser
contract.created	Neuer Garantievertrag aktiviert
contract.cancelled	Vertrag storniert oder erstattet
claim.submitted	Neuer Schadensfall eingereicht
claim.approved	Schadensfall zur Lösung genehmigt
claim.denied	Schadensfall abgelehnt
claim.resolved	Schadensfall-Lösung abgeschlossen
plan.updated	Garantieplan-Konfiguration geändert

Payload-Format

{
  "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
  }
}

Signaturen verifizieren

Jeder Webhook enthält einen X-Umbrella-Signature-Header. Verifizieren Sie ihn, um die Authentizität sicherzustellen:

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

Wiederholungsrichtlinie

Fehlgeschlagene Zustellungen (Nicht-2xx-Antwort) werden bis zu 5 Mal mit exponentiellem Backoff wiederholt: 1 Min., 5 Min., 30 Min., 2 Stunden, 24 Stunden.