Events aus einem eigenen CRM senden

Wenn du ein selbst programmiertes oder internes CRM betreibst, gibt es keinen fertigen Konnektor zum Anklicken – du sendest die Events selbst. Das Prinzip ist simpel: Definiere einen Trigger in deinem CRM (eine neue Lead-Zeile, eine Opportunity wechselt auf Won, eine Zahlung geht ein) und sende beim Auslösen ein HTTP-Webhook – auch Postback genannt – an die Conversion API von LeadJourney. LeadJourney ordnet dieses Event dem Ad-Klick zu, der den Lead erzeugt hat, sodass ein Meilenstein in deiner Pipeline zu einer attribuierten Conversion wird.

Dieser Artikel ist so geschrieben, dass du ihn einem Entwickler in die Hand geben kannst. Er enthält den exakten Endpoint, die Authentifizierung, jedes Payload-Feld und kopierfertige Requests in vier Sprachen.

Deine Zugangsdaten holen

Öffne Einstellungen → Events → Conversion API. Dieser Tab enthält die drei Werte, die deine Integration braucht:

Aufbau eines Requests

Jedes Event ist ein einzelnes POST mit einem JSON-Body, authentifiziert mit deinem Postback Secret. Kopiere die exakte Webhook-URL aus dem Conversion-API-Tab – sie enthält bereits deine Workspace-ID.

curl -X POST "https://api.leadjourney.io/api/v1/postback/DEINE-WORKSPACE-ID" \
  -H "Authorization: Bearer DEIN_POSTBACK_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "Lead",
    "click_id": "DEINE_CLICK_ID",
    "email": "[email protected]",
    "first_name": "John",
    "last_name": "Doe"
  }'

Das ist der ganze Vertrag: URL + Authorization-Header + JSON-Body. Alles Weitere auf dieser Seite ist nur Detail rund um diese drei Teile.

Authentifizierung

Es gibt zwei Wege, das Postback Secret zu senden. Beide sind gleichwertig – nimm den, den deine Plattform unterstützt.

curl -X POST "https://api.leadjourney.io/api/v1/postback/DEINE-WORKSPACE-ID" \
  -H "Authorization: Bearer DEIN_POSTBACK_SECRET" \
  -H "Content-Type: application/json" \
  -d '{ "type": "Lead", "email": "[email protected]" }'

curl -X POST "https://api.leadjourney.io/api/v1/postback/DEINE-WORKSPACE-ID?token=DEIN_POSTBACK_SECRET" \
  -H "Content-Type: application/json" \
  -d '{ "type": "Lead", "email": "[email protected]" }'

Payload-Referenz

Der Body ist JSON. type ist immer erforderlich, und jedes Event braucht mindestens einen Identifier (click_id, email oder phone), damit LeadJourney es einem Lead zuordnen kann.

Zusätzliche CRM-Daten senden (Custom Fields)

Um Attribute wie Branche, Deal-Größe oder Tarif mitzuschicken, lege das Feld zuerst unter Einstellungen → Events → Custom Fields an und verschachtele seinen exakten Key unter custom_fields im selben Webhook – kein neuer Endpoint:

{
  "type": "WonClient",
  "email": "[email protected]",
  "revenue": 1499.00,
  "custom_fields": {
    "industry": "Software",
    "company_size": 100,
    "deal_size": 1499.00
  }
}

Die vollständige Anleitung findest du unter Custom Fields.

Den Trigger in deinem CRM definieren

Das ist der Teil, der bei einem selbst programmierten System einzigartig ist. Bei einem nativen Konnektor beobachtet LeadJourney das CRM für dich; hier entscheidest du die Momente und löst den Aufruf aus.

curl -X POST "https://api.leadjourney.io/api/v1/postback/DEINE-WORKSPACE-ID" \
  -H "Authorization: Bearer $LJ_POSTBACK_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "WonClient",
    "click_id": "'"$CLICK_ID"'",
    "email": "[email protected]",
    "revenue": 1499.00
  }'

await fetch("https://api.leadjourney.io/api/v1/postback/DEINE-WORKSPACE-ID", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.LJ_POSTBACK_SECRET}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    type: "WonClient",
    click_id: lead.clickId,   // die beim Anlegen des Leads gespeicherte Click-ID
    email: lead.email,
    revenue: deal.amount,
  }),
});

$ch = curl_init("https://api.leadjourney.io/api/v1/postback/DEINE-WORKSPACE-ID");
curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => [
        "Authorization: Bearer " . getenv("LJ_POSTBACK_SECRET"),
        "Content-Type: application/json",
    ],
    CURLOPT_POSTFIELDS => json_encode([
        "type"     => "WonClient",
        "click_id" => $lead->click_id,
        "email"    => $lead->email,
        "revenue"  => $deal->amount,
    ]),
]);
curl_exec($ch);
curl_close($ch);

import os, requests

requests.post(
    "https://api.leadjourney.io/api/v1/postback/DEINE-WORKSPACE-ID",
    headers={
        "Authorization": f"Bearer {os.environ['LJ_POSTBACK_SECRET']}",
        "Content-Type": "application/json",
    },
    json={
        "type": "WonClient",
        "click_id": lead.click_id,
        "email": lead.email,
        "revenue": deal.amount,
    },
    timeout=10,
)

Duplikate und Aktualisierungen behandeln

Versuche nicht, im eigenen Code zu deduplizieren – überlass das dem Events Manager. Jedes Event hat einen Modus, der bestimmt, wie wiederholte Postbacks für denselben Lead behandelt werden:

• Doppelte Postbacks ignorieren – nur der erste zählt (z. B. ein Lead pro Person, auch wenn dein Trigger zweimal feuert).
• Conversion mit neuen Daten aktualisieren – bestehendes Event aktualisieren, wenn sich ein Wert ändert (z. B. der revenue eines Deals wird korrigiert).
• Neue Conversion anlegen – jedes Postback erfassen (z. B. Wiederkäufe).

Lege das pro Event beim Anlegen fest – siehe die Modus-Tabelle in Events & der Events Manager. So kann dein CRM gefahrlos erneut senden, ohne deine Zahlen aufzublähen.

Fehlerbehandlung & Retries

• Sende den Body als application/json und lies den HTTP-Status. Ein 2xx bedeutet, das Event wurde angenommen; behandle jeden Nicht-2xx als Fehler und wiederhole mit kurzem Backoff (dein CRM feuert eventuell, bevor das Netzwerk bereit ist).
• Setze ein Request-Timeout, damit ein langsamer Aufruf nie die auslösende Aktion blockiert. Feuere das Postback nach Möglichkeit aus einem Background-Job oder einer Queue.
• Bevorzuge die Event-Modi oben gegenüber eigener Dedupe-Logik, damit ein wiederholter Aufruf keine doppelte Conversion erzeugt.

Testen & prüfen

FAQ

Verwandte Artikel