Dokumentation

Webhooks#

Erhalten Sie Echtzeit-Benachrichtigungen über neue Besucher.

Webhook einrichten#

  1. Gehen Sie zu Einstellungen → Webhooks
  2. Klicken Sie auf "Neuer Webhook"
  3. Geben Sie Ihre Endpoint-URL ein
  4. Wählen Sie die Events, die Sie empfangen möchten

Verfügbare Events#

Event

Beschreibung

company.identified

Neues Unternehmen identifiziert

company.returned

Unternehmen kehrt zurück

company.intensive

Hohe Aktivität erkannt

segment.matched

Unternehmen erfüllt Segment-Kriterien

Payload-Format#

Webhooks werden als HTTP POST mit JSON-Body gesendet:

{"event": "company.identified", "company": {...}, "timestamp": "..."}

Sicherheit#

Jeder Webhook enthält einen X-Webmetic-Signature Header zur Verifizierung:

signature = HMAC-SHA256(payload, webhook_secret)

Retry-Logik#

Bei Fehlern (Status != 2xx) wird der Webhook automatisch wiederholt:

  • 1. Versuch: sofort
  • 2. Versuch: nach 1 Minute
  • 3. Versuch: nach 5 Minuten
  • 4. Versuch: nach 30 Minuten