Integrationen

Close verbinden

Verbinde deine Close-Organisation in wenigen Minuten, ohne API-Keys und ohne von Hand verdrahtete Webhooks. Einmal autorisieren, CRM-Events wie neue Leads, neue Kontakte, neue Opportunities und Closed-Won-Deals auf deine Conversions abbilden und LeadJourney-Daten zurück nach Close schicken.

Wenn du Close verbindest, werden CRM-Events – neue Leads, neue Kontakte, neue Opportunities, Closed-Won-Deals – zu LeadJourney-Conversions, automatisch der Kampagne, Ad Set und Anzeige zugeordnet, die sie verdient haben. Du autorisierst Close einmal (keine Keys zum Kopieren, keine Webhook-URLs zum Einfügen) und mappst danach jedes Close-Event auf einen deiner Conversion-Typen. Gemappte Events laufen durch dieselbe Postback-Pipeline wie deine Offline-Conversions und übernehmen so automatisch jeden Ad-Postback, den du bereits eingerichtet hast. Über denselben Screen kannst du außerdem LeadJourney-Klicks, Leads und Conversions als Datensätze zurück nach Close senden.

Bevor du startest

Halte das bereit, damit die Verbindung von Anfang bis Ende funktioniert:

  • Einen aktiven LeadJourney-Workspace und eine Close-Organisation, in die du dich einloggen kannst.
  • Tracking ist live – Klicks müssen zuerst erfasst werden, damit Datensätze einer Kampagne zugeordnet werden können. Siehe Tracking-Script installieren.
  • Eine Möglichkeit, die Click-ID auf deinen Close-Datensätzen zu erfassen – typisch ein Custom Field auf dem Lead oder der Opportunity, das LeadJourneys Click-ID speichert (siehe Callout unten).
  • Mindestens einen Conversion-Typ zum Mappen (z. B. WonClient). Richte diese zuerst im Events Manager ein.

Wo du es findest

Öffne Settings → Apps oder gehe zu app.leadjourney.io/settings?slug=apps. Klick auf die Close-Karte, um die Integration zu öffnen (oder nutze ?slug=apps&app=close). Solange du nicht verbunden bist, siehst du eine „Connect your Close organization“-Karte; nach dem Verbinden zeigt derselbe Screen deine Organisation, deine Trigger und das Panel Send to Close.

Schritt für Schritt

LeadJourney aus Close autorisieren

Klick auf der Connect your Close organization-Karte auf Connect with Close. Du wirst zu Close weitergeleitet, um dich einzuloggen und den Zugriff von LeadJourney zu bestätigen.

Die Freigabe gibt API-Zugriff auf deine Leads, Opportunities und Kontakte, plus Offline-Zugriff, damit LeadJourney Datensätze lesen und eine Webhook-Subscription registrieren kann, um Änderungen in Echtzeit aufzunehmen – keine Keys zum Kopieren, keine Webhook-URLs zum Einfügen. Nach der Bestätigung schickt Close dich zurück und du siehst eine „Close connected“-Bestätigung.

Die Synchronisierung startet beim Verbinden

LeadJourney erfasst neue Close-Events ab dem Moment der Verbindung. Daten von vor der Verbindung werden nicht importiert.

Verbindungsdetails prüfen

Sobald du verbunden bist, zeigt der Header ein Live-Pill (oder Needs reconnect, falls etwas bricht) sowie die Buttons Re-authorize und Disconnect. Darunter siehst du den Status Connection, Name und ID deiner Organization, Active triggers (aktive von allen) und das Datum Connected since.

Einen Trigger hinzufügen

Klick im Triggers-Panel („Each trigger maps a Close record event to one of your conversions.“) auf Add trigger. Im Dialog New Close trigger:

  1. App: Close (bereits ausgewählt).
  2. LeadJourney Event: wähle den Conversion-Typ, den dieses Close-Event aufzeichnen soll, z. B. WonClient. (Keine Optionen? Lege zuerst einen unter Settings → Events an.)
  3. Trigger: wähle das Close-Event, das ihn auslöst, etwa einen neuen Lead, einen neuen Kontakt, eine neue Opportunity oder einen Closed-Won-Deal. Search triggers… grenzt lange Listen ein.
  4. Attribute changed (optional, bei Update-Triggern): wähle ein Feld und einen Target value, damit der Trigger nur feuert, wenn das Feld auf diesen Wert wechselt. Felder mit festen Optionen (z. B. ein Status) zeigen ein Dropdown; lass Any value (oder das Feld leer), um bei jedem Update zu feuern.

Klick auf Continue.

Nur bei einem bestimmten Status feuern

Um nur zu feuern, wenn eine Opportunity einen bestimmten Status erreicht, nutze Attribute changed bei einem Update-Trigger oder füge eine Bedingung im Tab Filtering hinzu (z. B. status gleich Won).

Daten empfangen und das Mapping bestätigen

Der Dialog öffnet einen Flow mit drei Tabs:

  • Receive Data: klick auf Find latest data, um die 3 neuesten Datensätze für das gewählte Event zu laden. Erscheint nichts, erstelle einen passenden Datensatz in Close und prüfe erneut, dann wähle einen Datensatz und klick auf Continue with selected record.
  • Configure Mapping: ordne den Close-Datensatz den LeadJourney-Spalten zu. Neue Trigger starten mit Email, Name, Phone, click_id, Revenue und Currency, vorbelegt, wo LeadJourney einen passenden Pfad findet. Add custom field fügt First name, Last name oder eines deiner Custom Fields hinzu, oder du legst mit Create new field ein neues an (Typ Text, Number oder Currency). Mehrere Pfade werden mit Leerzeichen verbunden, einem festen Wert stellst du static: voran. Das Mappen von click_id ist empfohlen, aber optional (siehe Callout unten).
  • Filtering (optional): klick auf Add filter und setze Path, Operator und Value. Der Trigger feuert nur, wenn jeder Filter auf den eingehenden Datensatz passt; ohne Filter feuert jedes passende Event.

Klick auf Save & Continue, um abzuschließen (beim Bearbeiten Save changes), oder auf Save and continue later, um den Zwischenstand zu sichern.

Wie Close-Datensätze mit der richtigen Kampagne verknüpft werden

Close erfasst LeadJourneys Click-ID nicht von allein – du speicherst sie auf dem Datensatz und mappst sie hier. Üblich ist ein Custom Field auf dem Lead oder der Opportunity, das die Click-ID des Besuchers enthält. Zeige im Tab Configure Mapping click_id auf dieses Feld (oder nutze einen static:-Wert zum Testen), sodass jeder Datensatz bereits mit dem Klick – und damit der Kampagne, Ad Set und Anzeige – verknüpft an kommt, der ihn verdient hat. Keine Click-ID? LeadJourney matcht als Fallback über email oder phone.

Deine Trigger verwalten

Jeder Trigger erscheint als Zeile – Close-Event → Conversion-Typ – mit einem Active- / Paused-Pill und einer Zusammenfassung, wie viele Felder und Filter er nutzt.

  • Pause / Resume: stoppe einen Trigger über den Schalter vorübergehend, ohne ihn zu löschen.
  • Edit: Event, Bedingung, Mapping, Filter oder Ziel-Conversion ändern. Die URL bekommt einen trigger_id-Parameter, so kannst du einen Link teilen, der genau diesen Trigger öffnet.
  • Delete: tippe delete und klick auf Delete trigger. Mapping und Filter lassen sich nicht wiederherstellen; die anderen Trigger laufen weiter.
  • Weitere hinzufügen: nutze Add trigger erneut, um mehr Close-Events (neue Leads, Kontakte, Opportunities, Closed-Won-Deals) auf verschiedene Conversions zu mappen.

Daten zurück an Close senden

Das Panel Send to Close schreibt LeadJourney-Klicks, Conversions und Leads als Datensätze nach Close, ganz ohne Zapier. Klick auf + Add destination, dann:

  1. Create this Close record: wähle Lead, Contact oder Opportunity.
  2. When this happens: wähle das LeadJourney-Event. Bei einem Conversion-Event kannst du es über Conversion type eingrenzen oder auf Any conversion type lassen.
  3. Write mode: Create legt immer einen neuen Datensatz an, Update aktualisiert nur einen vorhandenen Treffer und überspringt, wenn keiner gefunden wird. Einen Upsert-Modus gibt es bei Close nicht.
  4. Matching field (nur Update): das Close-Feld, über das der vorhandene Datensatz gefunden wird. Es muss auch unten gemappt sein. Alternativ wählst du Contact email oder Contact phone: LeadJourney matcht dann über die LeadJourney-E-Mail oder -Telefonnummer (bei Leads und Opportunities über den verknüpften Kontakt), ohne zusätzliches Mapping.
  5. Map fields: wähle ein Close field (oder tippe den Namen eines Custom Fields ein und klick auf Set) und danach den LeadJourney value, der gesendet wird. Mehrere Werte werden mit Leerzeichen verbunden, alternativ tippst du einen festen Wert ein und klickst auf Add. Find latest data zeigt echte Beispielwerte (filterbar nach Click-ID oder Lead-ID); + Add field fügt eine weitere Zeile hinzu.

Klick auf Create destination. Jede Destination-Zeile hat Pause / Resume, Edit und Delete (Löschen stoppt neue Datensätze; bestehende Close-Datensätze bleiben unberührt). Die Tabelle Sync history listet jede Zustellung mit Status (Success, Failed oder Skipped), Event, Objekt, Modus, Zeitpunkt und Detail sowie einem Retry-Button für fehlgeschlagene oder übersprungene Zustellungen.

Erneut verbinden

Wenn Close die App widerruft, die Webhook-Subscription verschwindet oder Close nicht erreichbar ist, wechselt der Header auf Needs reconnect und ein Banner nennt den Grund (z. B. „Close disconnected your app“ oder „Webhook subscription is gone“). Klick auf Reconnect, um die Autorisierung erneut auszuführen. Um erteilte Berechtigungen aufzufrischen, während alles läuft, nutze Re-authorize im Header. In beiden Fällen bleiben Trigger und Einstellungen erhalten.

Trennen (Disconnect)

Um Close zu entfernen, klick im Header auf Disconnect, tippe disconnect und bestätige mit Disconnect Close. Das ist bewusst so, weil es destruktiv ist:

Disconnect löscht deine Trigger

Das Trennen entfernt die Close-Verbindung dauerhaft, löscht jeden Trigger und widerruft die Webhook-Subscription. Close-Events fließen sofort nicht mehr in deine Conversions. Du kannst später erneut verbinden, aber deine Trigger-Konfiguration wird nicht wiederhergestellt – du richtest sie neu ein.

Fehlerbehebung

Keine Datensätze bei „Find latest data“?

Für dieses Event gibt es in Close noch nichts Aktuelles. Erstelle einen passenden Datensatz (einen neuen Lead, Kontakt oder eine Opportunity) und klick dann erneut auf Find latest data. Der Datensatz sollte erscheinen, sodass du das Mapping abschließen kannst.

Datensätze kommen an, werden aber keiner Kampagne zugeordnet?

LeadJourney muss wissen, zu welchem Klick der Datensatz gehört. Prüfe, dass (1) das Tracking-Script installiert ist und Klicks erfasst, (2) deine Datensätze die Click-ID in einem Custom Field tragen und der Trigger click_id darauf mappt und (3) der Trigger Active ist. Als Fallback können email oder phone zum Matchen genutzt werden.

Header zeigt „Needs reconnect“?

Close hat die Freigabe widerrufen, der Webhook ist weg oder die API ist nicht erreichbar. Klick im Banner auf Reconnect, um neu zu autorisieren. Deine Trigger bleiben erhalten.

Eine Destination zeigt Failed- oder Skipped-Zustellungen?

Öffne Sync history und lies die Spalte Detail. Update überspringt, wenn kein Treffer gefunden wird, und das Matching field muss auch gemappt sein. Korrigiere die Destination und klick dann auf Retry.

Häufige Fragen

Verwandte Artikel