Integrationen

CallRail verbinden

Verbinde CallRail mit einem Account-API-Key, lass jeden Anruf LeadJourneys clickId-Cookie erfassen, füge die Webhook-URLs in CallRail ein und mappe Anrufe und Formular-Einsendungen auf deine Conversions.

Wenn du CallRail verbindest, werden eingehende Anrufe und CallRail-Formular-Einsendungen zu LeadJourney-Conversions, zugeordnet dem Anzeigen-Klick, der das Telefon klingeln ließ. CallRail verbindest du mit einem Account-API-Key (es gibt kein OAuth). Du fügst den Key ein, wählst, welche CallRail-Companies zu diesem Workspace gehören, und kopierst die von LeadJourney erzeugten Webhook-URLs in CallRail. Für die Attribution muss CallRail bei jedem Anruf LeadJourneys clickId-Cookie erfassen. Gemappte Events laufen durch dieselbe Postback-Pipeline wie deine Offline-Conversions und übernehmen so jeden Ad-Postback, den du bereits eingerichtet hast.

Bevor du startest

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

  • Einen aktiven LeadJourney-Workspace und ein CallRail-Konto, in dem du einen API-Key anlegen und Webhooks sowie Tracking Sources bearbeiten kannst.
  • Tracking ist live auf der Website, für die du wirbst: Das LeadJourney-Tracking-Script setzt das clickId-Cookie, das CallRail erfasst. Siehe Tracking-Script einbinden.
  • Dynamic Number Insertion (DNI) in CallRail, oder den Plan, sie einzurichten (Schritt 3).
  • Mindestens einen Conversion-Typ zum Mappen (z. B. BookedCall). 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 CallRail-Karte (unter Call Tracking Tools), um die Integration zu öffnen. Solange du nicht verbunden bist, siehst du eine „Connect your CallRail account“-Karte; nach dem Verbinden zeigt derselbe Screen dein Konto, die Companies, aus denen du Anrufe konvertierst, deine Webhook URLs und deine Triggers.

Schritt für Schritt

API-Key einfügen

Öffne in CallRail Account → API Keys und lege einen API-Key an (oder kopiere einen bestehenden). Zurück in LeadJourney, auf der Connect your CallRail account-Karte:

  1. CallRail API Key: füge den Key ein.
  2. Webhook signing secret (optional): hast du auf deinen CallRail-Webhooks ein Signing Secret gesetzt, füge es hier ein, damit LeadJourney eingehende Zustellungen prüfen kann. Lass das Feld leer, wenn du keines nutzt.
  3. Klick auf Connect.

LeadJourney prüft den Key über die CallRail-API. Der Key wird verschlüsselt gespeichert und nur genutzt, um dein Konto für die Mapping-Oberfläche zu lesen. Du siehst eine „CallRail connected“-Bestätigung.

Konto und Companies wählen

CallRail verschachtelt Account → Company → Calls, und eine Agentur führt meist eine Company pro Kunde. Ein API-Key sieht also die Anrufe aller Kunden.

  • CallRail account: dieses Panel erscheint nur, wenn dein Key mehr als ein Konto sieht. Wähle das Konto, aus dem dieser Workspace Anrufe ziehen soll (Select a CallRail account…). Solange du keins wählst, kann LeadJourney keine Companies auflisten und keine Anrufe konvertieren.
  • Companies: hake die Companies an, deren Anrufe in diesen Workspace gehören, und klick auf Save selection. All companies konvertiert jede Company, auch später hinzugefügte. Mit Search companies… findest du eine, mit Refresh list liest du die Liste neu aus CallRail.

Wählst du bestimmte Companies, legst du auch fest, was passiert, wenn ein Anruf ohne Company ankommt. Jede Option ist direkt daneben erklärt.

Click-ID-Erfassung in CallRail einrichten

Attribution funktioniert nur, wenn die LeadJourney-Click-ID CallRail erreicht. In CallRail:

  1. Schalte Dynamic Number Insertion (DNI) ein: lege eine Tracking Source mit Website- / Nummern-Pool an und aktiviere Session-Tracking (JavaScript) auf der Website, für die du wirbst.
  2. Lege eine Custom Cookie Capture-Regel an, die das First-Party-Cookie clickId erfasst (vom LeadJourney-Tracking-Script bereits gesetzt).

CallRail schickt den Wert dann bei jedem Anruf als custom.clickId mit.

Webhook-URLs in CallRail einfügen

Das Webhook URLs-Panel listet eine URL pro Event, jeweils mit Copy-Button:

  • Post-call webhook: feuert, nachdem ein Anruf endet. Nutze dafür CallRails Post-Call-Webhook.
  • Call modified webhook: feuert, wenn ein Anruf später bearbeitet wird (z. B. getaggt oder qualifiziert).
  • Form submission webhook: feuert, wenn ein CallRail-Formular abgeschickt wird.

Füge jede URL in den passenden Webhook unter CallRail → Settings → Integrations → Webhooks der jeweiligen Company ein.

Company-spezifische URLs

Sobald du bestimmte Companies gewählt hast, zeigt LeadJourney einen URL-Satz pro Company. Füge die URLs jeder Company in die Webhook-Einstellungen genau dieser Company ein. Die URL einer falschen Company verwirft ihre Anrufe oder ordnet sie der falschen Company zu. Hast du die Webhooks vor der Company-Auswahl eingerichtet, füge die neuen URLs erneut ein: die älteren nennen keine Company.

Einen Trigger hinzufügen

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

  1. App: CallRail (bereits ausgewählt).
  2. LeadJourney Event: wähle den Conversion-Typ, den dieses Event aufzeichnen soll, z. B. BookedCall. (Keine Optionen? Lege zuerst einen unter Settings → Events an.)
  3. Trigger: wähle das CallRail-Event: einen beendeten Anruf, einen bearbeiteten Anruf oder eine Formular-Einsendung. Mit Search triggers… filterst du die Liste.

Klick auf Continue.

Daten empfangen und das Mapping bestätigen

Der Dialog öffnet einen Flow mit drei Tabs:

  • Receive Data: klick auf Find latest data, um die neuesten Datensätze für dieses Event aus deinem CallRail-Konto zu laden. Gibt es noch keine, führe zuerst einen Testanruf über CallRail durch (oder sende ein Testformular ab). Gemappt wird gegen die Webhook-Payload des Anrufs, du kannst die Feldnamen, die CallRail sendet, im nächsten Tab also auch einfach eintippen.
  • Configure Mapping: ordne Email, Name, Phone, click_id, Revenue und Currency zu (First name / Last name oder eigene Felder fügst du per Add custom field hinzu). Typische Quellen sind customer_email, customer_name, customer_phone_number und value. click_id aus custom.clickId zu mappen ist empfohlen, aber optional.
  • Filtering (optional): klick auf Add filter und setze Path, Operator und Value. Üblich für Anrufe ist answered equals true.

Klick auf Save & Continue, um abzuschließen.

Wie Anrufe mit der richtigen Kampagne verknüpft werden

Das LeadJourney-Tracking-Script setzt das clickId-Cookie, wenn ein Besucher über deine Anzeige kommt. DNI zeigt diesem Besucher eine Tracking-Nummer, und die Custom Cookie Capture-Regel hängt das Cookie an den Anruf. CallRail sendet es als custom.clickId, dein Trigger mappt es auf click_id, und der Anruf kommt bereits mit dem Klick (und damit der Kampagne, dem Ad Set und der Anzeige) verknüpft an, der ihn verdient hat. Ohne Click-ID kann weiterhin über email oder phone gematcht werden.

Deine Trigger verwalten

Jeder Trigger erscheint als Zeile (CallRail-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, Mapping, Filter oder Ziel-Conversion ändern.
  • Delete: einen einzelnen Trigger entfernen (zur Bestätigung delete tippen); die anderen laufen weiter.
  • Weitere hinzufügen: z. B. beendete Anrufe auf BookedCall und Formular-Einsendungen auf Lead.

Erneut verbinden

Lehnt CallRail den Key ab (meist, weil er rotiert oder widerrufen wurde) oder antwortet nicht, wechselt der Header auf Needs reconnect und ein Banner nennt den Grund („CallRail rejected your API key“ oder „CallRail is unreachable“). Klick auf Reconnect, um das Verbindungsformular erneut zu öffnen und einen frischen Key einzufügen. Update API key im Header macht jederzeit dasselbe. Deine Trigger und Einstellungen bleiben erhalten.

Trennen (Disconnect)

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

Disconnect löscht deine Trigger

Das Trennen entfernt das CallRail-Konto dauerhaft aus diesem Workspace, löscht jeden Trigger und verwirft den gespeicherten API-Key. CallRail-Events fließen sofort nicht mehr in deine Conversions. Du kannst später erneut verbinden, aber deine Trigger-Konfiguration wird nicht wiederhergestellt. Die eingefügten Webhooks liegen in CallRail; entferne sie unter Settings → Integrations → Webhooks, wenn du nicht neu verbinden willst.

Fehlerbehebung

Anrufe kommen an, werden aber keiner Kampagne zugeordnet?

Prüfe, dass (1) das Tracking-Script auf der beworbenen Website läuft, (2) DNI dort aktiv ist, (3) die Custom Cookie Capture-Regel das Cookie mit exakt dem Namen clickId erfasst und (4) der Trigger click_id aus custom.clickId mappt und Active ist.

Nach der Company-Auswahl kommen keine Anrufe mehr an?

Die Webhooks in CallRail nutzen wahrscheinlich noch die älteren URLs ohne Company. Kopiere die Company-spezifischen URLs aus dem Webhook URLs-Panel und füge sie erneut in die Webhook-Einstellungen jeder Company ein.

Anrufe eines anderen Kunden landen in diesem Workspace?

Der Workspace konvertiert All companies. Hake im Companies-Panel nur die Companies an, die hierher gehören, klick auf Save selection und füge dann die Company-spezifischen Webhook-URLs ein.

Eine gewählte Company „no longer exists“?

LeadJourney behält eine Auswahl, die CallRail nicht mehr listet, statt sie auszuweiten; für sie werden also keine Anrufe konvertiert. Klick auf Refresh list, wähle die Ersatz-Company und Save selection.

Keine Datensätze bei „Find latest data“?

Für dieses Event gibt es noch nichts Aktuelles. Führe einen Testanruf über CallRail durch oder sende ein Testformular ab und klick dann erneut auf Find latest data, oder tippe die Feldnamen direkt unter Configure Mapping ein.

Häufige Fragen

Verwandte Artikel