Ausgehende Webhooks
Ausgehende Webhooks pushen Lead-Daten von LeadHub an eine externe URL, wenn ein Lead-Ereignis eintritt. Verwenden Sie dies, um Leads mit einem CRM zu synchronisieren, Zapier-Workflows auszulösen oder externe Systeme zu benachrichtigen.
Wie ausgehende Webhooks funktionieren
- Sie erstellen einen ausgehenden Webhook mit einer Ziel-URL und den abzuhörenden Ereignissen.
- Wenn das ausgewählte Ereignis eintritt (z. B. ein neuer Lead wird erstellt), sendet LeadHub eine HTTP-POST-Anfrage an Ihre URL.
- Die Nutzlast ist ein JSON-Objekt mit den vollständigen Lead-Daten.
Ausgehenden Webhook erstellen
- Gehen Sie zu Integrationen → Ausgehende Webhooks.
- Klicken Sie auf Neuer ausgehender Webhook.
- Konfigurieren Sie:
| Feld | Beschreibung |
|---|---|
| Name | Interner Name (z. B. „Sync zu HubSpot") |
| URL | Der externe Endpunkt, der den POST empfängt |
| Ereignisse | Welche Ereignisse diesen Webhook auslösen |
| Geheimnis | Optionales HMAC-Geheimnis für Signaturverifizierung |
| Aktiv | Umschalten zum Aktivieren oder Deaktivieren |
- Klicken Sie auf Speichern.
Verfügbare Ereignisse
| Ereignis | Wann es ausgelöst wird |
|---|---|
lead.created | Ein neuer Lead-Datensatz wird erstellt |
lead.updated | Ein Lead wird geändert |
lead.deleted | Ein Lead wird gelöscht |
lead.stage_changed | Ein Lead wechselt in eine neue Pipeline-Phase |
lead.assigned | Ein Lead wird einem Benutzer zugewiesen |
form.submitted | Eine Formulareinreichung wird empfangen |
Nutzlastformat
{
"event": "lead.created",
"occurred_at": "2026-04-29T10:30:00Z",
"lead": {
"id": 123,
"first_name": "Jane",
"last_name": "Smith",
"email": "[email protected]",
"source": "web_form",
"status": "new",
"lead_score": 45,
"created_at": "2026-04-29T10:30:00Z"
}
}
HMAC-Signaturverifizierung
Wenn Sie ein Geheimnis setzen, signiert LeadHub jede Anfrage mit HMAC-SHA256.
Die Signatur wird im Header X-LeadHub-Signature gesendet.
$computed = 'sha256=' . hash_hmac('sha256', $rawBody, $secret);
if (!hash_equals($computed, $_SERVER['HTTP_X_LEADHUB_SIGNATURE'])) {
http_response_code(401);
exit;
}
Webhook-Zustellung und Wiederholungen
LeadHub stellt Webhooks asynchron über die Warteschlange zu. Bei Nicht-2xx-Antwort wird die Zustellung bis zu 3 Mal mit exponentiellem Backoff wiederholt.
Überprüfen Sie das Webhook-Protokoll für den Zustellverlauf.
Deaktivieren vs. Löschen
- Deaktivieren: Aktiv ausschalten — keine Ereignisse werden gesendet, Webhook bleibt erhalten.
- Löschen: Entfernt die Webhook-Konfiguration dauerhaft.