Werbe-Leads per Webhook

Werbe-Leads benötigen das erweiterte CRM und eine Freischaltung durch Dealpipe. Nur Administratoren richten Verbindungen ein.

Jeder Lead, den Ihr Tool an Dealpipe sendet, wird sofort zur Anfrage unter CRM → Leads. Dealpipe legt den Kontakt an oder verknüpft ihn über die E-Mail-Adresse mit einem bestehenden Kontakt. Zuweisungsregeln, Reaktionszeit-Hinweise und automatische Antworten laufen wie bei jeder anderen Anfrage.

Verbindung anlegen

Öffnen Sie Einstellungen → CRM → Werbe-Leads.
Wählen Sie Verbindung hinzufügen → Webhook und geben Sie einen Namen ein, zum Beispiel „Zapier Meta-Kampagnen“.
Kopieren Sie die URL und das Secret. Das Secret wird nur einmal angezeigt.

Die Liste zeigt für jede Verbindung den letzten empfangenen Lead und den letzten Fehler. Über das Menü der Zeile können Sie die Verbindung umbenennen, das Secret erneuern oder sie löschen. Nach dem Erneuern funktioniert das alte Secret sofort nicht mehr. Bereits empfangene Anfragen bleiben beim Löschen erhalten.

Google-Ads-Lead-Formulare

Google Ads sendet jeden Lead aus einem Lead-Formular direkt an Dealpipe, ohne Zapier oder Make.

Öffnen Sie Einstellungen → CRM → Werbe-Leads und wählen Sie Verbindung hinzufügen → Google-Lead-Formulare.
Kopieren Sie die Webhook-URL und den Webhook-Schlüssel. Der Schlüssel wird nur einmal angezeigt.
Öffnen Sie in Google Ads das Lead-Formular. Unter Leads aus Google Ads exportieren → Andere Optionen zur Datenintegration → Webhook-Integration (optional) tragen Sie URL und Schlüssel ein.
Wählen Sie Testdaten senden. Dealpipe legt eine Testanfrage ohne Kontakt an; die Verbindung zeigt Zeit und Namen des letzten Testleads. Danach Speichern.

Echte Leads werden zur Anfrage mit Kampagne, Formular und Google-Klick-ID. Derselbe Lead wird nie doppelt angelegt, auch wenn Google ihn erneut sendet. Nach dem Erneuern des Schlüssels tragen Sie den neuen Schlüssel in jedem Lead-Formular ein. Leads, die Google nicht zustellen konnte, während die Verbindung gestört war, laden Sie in Google Ads als CSV herunter. Die CSV enthält die letzten 30 Tage.

Verbindung pausieren

Im Menü der Verbindung wählen Sie Pausieren. Eine pausierte Verbindung lehnt jeden Lead mit 403 ab und speichert nichts. Mit Fortsetzen nimmt sie wieder Leads an. Leads aus der Pause stellt Google nicht erneut zu; laden Sie sie als CSV herunter.

Anfrage senden

Senden Sie pro Lead eine POST-Anfrage mit einem JSON-Objekt an die URL der Verbindung. Das Secret steht im Header Authorization als Bearer-Token. Alternativ akzeptiert Dealpipe den Header X-Dealpipe-Secret.

curl -X POST "https://app.deal-pipe.de/api/webhooks/leads/<VERBINDUNGS-ID>" \
  -H "Authorization: Bearer <SECRET>" \
  -H "Content-Type: application/json" \
  -d '{
    "lead_id": "meta-1234567890",
    "first_name": "Anna",
    "last_name": "Schmidt",
    "email": "[email protected]",
    "phone": "+49 170 1234567",
    "postal_code": "20095",
    "city": "Hamburg",
    "message": "Bitte um Rückruf",
    "campaign": "Neubau Hafencity Herbst",
    "ad_set": "Kapitalanleger 30-55",
    "ad": "Video Penthouse",
    "answers": { "Budget": "400.000 bis 600.000 €", "Finanzierung geklärt": "Ja" }
  }'

Felder

Feld	Pflicht	Bedeutung
`lead_id`	Ja	Eindeutige ID des Leads auf der Werbeplattform. Dealpipe legt pro ID nur eine Anfrage an.
`email`	Nein	E-Mail-Adresse. Darüber wird ein bestehender Kontakt gefunden.
`phone`	Nein	Telefonnummer.
`name`	Nein	Vollständiger Name. Alternativ `first_name` und `last_name`.
`first_name`, `last_name`	Nein	Vor- und Nachname, wenn `name` fehlt.
`postal_code`, `city`	Nein	Postleitzahl und Ort. Zuweisungsregeln können nach Postleitzahl verteilen.
`message`	Nein	Freitext des Leads.
`campaign`, `ad_set`, `ad`	Nein	Kampagne, Anzeigengruppe und Anzeige. Werden beim neuen Kontakt als Herkunft gespeichert.
`utm_source`, `utm_medium`, `utm_content`	Nein	UTM-Werte. Werden beim neuen Kontakt als Herkunft gespeichert.
`is_test`	Nein	`true` markiert einen Test-Lead. Er wird als Anfrage gespeichert, legt aber keinen Kontakt an und löst weder Zuweisung noch Reaktionszeit-Hinweis noch automatische Antwort aus.
`answers`	Nein	Weitere Formularantworten als Objekt aus Frage und Antwort. Sie erscheinen in der Nachricht der Anfrage.

Leere Werte ("" oder null) gelten als nicht angegeben. Zahlen in Textfeldern werden als Text übernommen. Andere Felder ignoriert Dealpipe. Herkunftsangaben werden nur bei einem neu angelegten Kontakt gespeichert; bei bestehenden Kontakten bleibt die erste Herkunft erhalten.

Antworten

Status	Bedeutung
`200`	Gespeichert. Die Antwort enthält `id` (die Anfrage) und `duplicate`. `duplicate: true` heißt: Diese `lead_id` war schon da, es wurde nichts Neues angelegt.
`400`	Ungültige Daten. `error.field` nennt das Feld, `error.message` den Grund. Der Fehler erscheint auch in den Einstellungen.
`401`	Unbekannte Verbindung oder falsches Secret. Es wurde nichts gespeichert.
`403`	Die Verbindung ist pausiert oder Werbe-Leads sind für Ihre Organisation nicht aktiv. `error.code` nennt den Grund. Wiederholen hilft nicht.
`413`	Die Anfrage ist größer als 64 KB.
`429`	Mehr als 120 Leads pro Minute an diese Verbindung. Warten Sie die Sekunden aus dem Header `Retry-After` ab.

Senden Sie denselben Lead bei einem Fehler ruhig erneut. Dank lead_id entsteht keine doppelte Anfrage.

Beispiel: Zapier

Wählen Sie als Auslöser Ihre Werbeplattform, zum Beispiel Facebook Lead Ads → New Lead.
Fügen Sie die Aktion Webhooks by Zapier → Custom Request hinzu.
Setzen Sie Method auf POST und URL auf die URL der Verbindung.

Tragen Sie unter Data das JSON ein und setzen Sie die Felder des Auslösers ein, zum Beispiel:

{
  "lead_id": "{{Lead ID}}",
  "email": "{{Email}}",
  "name": "{{Full Name}}",
  "phone": "{{Phone Number}}",
  "campaign": "{{Campaign Name}}",
  "ad_set": "{{Ad Set Name}}",
  "ad": "{{Ad Name}}"
}

Tragen Sie unter Headers Authorization mit dem Wert Bearer <SECRET> und Content-Type mit dem Wert application/json ein.
Testen Sie den Schritt. Der Lead erscheint unter CRM → Leads.

Beispiel: Make

Wählen Sie als Auslöser Ihre Werbeplattform, zum Beispiel Facebook Lead Ads → Watch Leads.
Fügen Sie das Modul HTTP → Make a request hinzu.
Setzen Sie URL auf die URL der Verbindung und Method auf POST.
Fügen Sie unter Headers den Header Authorization mit dem Wert Bearer <SECRET> hinzu.
Wählen Sie als Body type Raw und als Content type JSON (application/json).
Tragen Sie unter Request content das JSON ein und setzen Sie die Felder des Auslösers ein, wie im Zapier-Beispiel.
Führen Sie das Szenario einmal aus. Der Lead erscheint unter CRM → Leads.

Zum Testen senden Sie "is_test": true. Die Anfrage erscheint unter CRM → Leads, ohne Kontakt, Zuweisung und automatische Antwort.

Einstieg

Immobilien

CRM und Zusammenarbeit

KI Coworker

Administration

Hilfe

Werbe-Leads per Webhook

Verbindung anlegen

Google-Ads-Lead-Formulare

Verbindung pausieren

Anfrage senden

Felder

Antworten

Beispiel: Zapier

Beispiel: Make

​Verbindung anlegen

​Google-Ads-Lead-Formulare

​Verbindung pausieren

​Anfrage senden

​Felder

​Antworten

​Beispiel: Zapier

​Beispiel: Make

Verbindung anlegen

Google-Ads-Lead-Formulare

Verbindung pausieren

Anfrage senden

Felder

Antworten

Beispiel: Zapier

Beispiel: Make