GoHighLevel

Die GoHighLevel-Verbindung von Rekomi erledigt zwei Aufgaben, und jede hat auf der Integrationsseite ihren eigenen Schalter. Affiliates in GoHighLevel synchronisieren überträgt Affiliates (und, wenn du es einschaltest, vermittelte Kunden und Leads) als Kontakte mit benutzerdefinierten Rekomi-Feldern und Tags in einen HighLevel-Sub-Account. Verkäufe über GoHighLevel gutschreiben schreibt Verkäufe dem Affiliate gut, über dessen Link der Kontakt kam, anhand der Attribution, die HighLevel selbst bei jedem Kontakt speichert. Beide Schalter sind standardmäßig an. HighLevel-Workflows können außerdem Formulareinsendungen und Zahlungen über einen Webhook an Rekomi zurückschicken. Nur so erreichen einmalige Bestellformulare und Zahlungsanbieter außer Stripe Rekomi überhaupt.

Was diese Verbindung kann und was nicht. Sie bewegt Kontakte zwischen Rekomi und GoHighLevel und benennt den Affiliate bei deinen Verkäufen. Woher der Verkauf selbst kommt, hängt davon ab, wie du abrechnest: Wiederkehrende Produkte auf einem Stripe-Konto, das unter Einrichtung > Zahlungsanbieter verbinden verbunden ist, kommen über Stripe an. Einmalige Bestellformulare und jeder Zahlungsanbieter außer Stripe (Authorize.net, NMI, PayPal, Square) erreichen Rekomi nur über den unten beschriebenen Workflow-Webhook. Die Verbindung liest die Attribution von HighLevel und schreibt sie nie.

Verkäufe über GoHighLevel gutschreiben

So funktioniert es

1. Jeder Affiliate-Link, den Rekomi für deine Kampagne ausgibt, trägt zwei zusätzliche Parameter: utm_source=rekomi und utm_campaign mit dem Link-Slug des jeweiligen Affiliates. Zum Beispiel: https://newsletter.example.com?via=jane&utm_source=rekomi&utm_campaign=jane. Slugs sind kleingeschrieben, und HighLevel vergleicht UTM-Werte exakt. Tippe sie also nicht von Hand ab.
2. Landet ein Besucher über diesen Link auf einer bei HighLevel gehosteten Funnel- oder Website-Seite (oder einer externen Seite mit dem Tracking-Skript von HighLevel) und sendet ein Formular, eine Umfrage, eine Kalenderbuchung, einen Chat oder ein ein- oder zweistufiges Bestellformular ab, speichert HighLevel die Ankunft beim Kontakt. HighLevel behält die erste und die letzte Ankunft. Rekomi liest zuerst die getaggten Felder und, wenn sie fehlen, die Adresse der Landingpage selbst. So nennt auch ein einfacher Affiliate-Link (?via=slug), der ausgegeben wurde, bevor die Tags eingeschaltet waren, noch seinen Affiliate.
3. Erreicht ein Verkauf Rekomi, ob über dein verbundenes Stripe-Konto oder über den Workflow-Webhook, und benennt nichts anderes einen Affiliate (ein Gutschein, Checkout-Metadaten, die Historie des Kunden, ein E-Mail-Lead, den Rekomi selbst erfasst hat), sucht Rekomi den Kontakt über die E-Mail-Adresse in deiner Location, liest die gespeicherte Attribution und schreibt den Verkauf dem Affiliate gut, den sie nennt. Zuerst wird die erste Ankunft geprüft, dann die letzte.

Was du brauchst

• Die GoHighLevel-Verbindung auf dieser Seite mit eingeschaltetem Verkäufe über GoHighLevel gutschreiben. Der Schalter ist ab dem Verbinden an. Der Private-Integration-Token, den du schon erstellt hast, deckt das Lesen der Kontakte ab.
• Für wiederkehrende Produkte, die über Stripe abgerechnet werden: dieses Stripe-Konto, verbunden unter Einrichtung > Zahlungsanbieter verbinden.
• Für einmalige Bestellformulare und Zahlungsanbieter außer Stripe: den Workflow-Webhook aus dem nächsten Abschnitt.

Käufe von HighLevel an Rekomi senden

Nutze das für jeden Verkauf, der nicht als Stripe-Abonnement auf dem verbundenen Konto läuft: einmalige Bestellformulare und jeden Zahlungsanbieter, der nicht Stripe ist.

1. Kopiere die Eingehende Webhook-URL, die auf der GoHighLevel-Integrationsseite in Rekomi angezeigt wird. Behandle sie wie ein Passwort: Wer sie hat, kann an dein Konto senden.
2. Erstelle in HighLevel einen Workflow mit dem Trigger Payment Received (oder Order Form Submission für Bestellformulare). Füge eine Aktion Webhook hinzu: Methode POST, URL = deine eingehende URL.
3. Füge im Bereich Custom Data der Webhook-Aktion vier Felder aus den Merge-Feldern des Triggers hinzu: email, amount, currency und order_id. Sende amount als einfache Dezimalzahl mit Punkt (49.99), ohne Tausendertrennzeichen oder Währungssymbole; ein Betrag in anderer Schreibweise (49,99, 1,234.50, $49.99) wird nicht erfasst, statt falsch gelesen zu werden. Wendet dein Checkout Rabattcodes über die eigenen Gutscheine von HighLevel an, füge als fünftes Feld coupon_code hinzu, gesetzt auf das Gutschein-Merge-Feld der Bestellung: Ein Code, den Rekomi für einen Affiliate erzeugt hat, schreibt diesem Affiliate den Verkauf gut, auch wenn der Käufer nie auf einen Link geklickt oder ein Formular abgesendet hat. Willst du den Slug des Affiliates im Payload haben, füge zwei weitere hinzu: utm_source mit dem festen Wert rekomi und utm_campaign, gesetzt auf das Attributions-Merge-Feld des Kontakts für die UTM-Kampagne (ein einzelnes Feld namens rekomi_campaign, gesetzt auf dieses Merge-Feld, funktioniert auch). Rekomi ignoriert utm_campaign, wenn daneben nicht utm_source mit dem Wert rekomi steht. Ohne diese Felder liest Rekomi die Attribution des Kontakts selbst. (total funktioniert anstelle von amount, und transaction_id oder payment_id anstelle von order_id.)

Rekomi erfasst den Kauf einmal pro Bestell-ID, ein Workflow, der zweimal auslöst, erzeugt also nie zwei Verkäufe. Gutgeschrieben wird der Kauf nur, wenn die eigene HighLevel-Attribution des Kontakts den Slug im Payload bestätigt. Ein coupon_code wird stattdessen mit deinen eigenen Affiliate-Codes abgeglichen: Ein aktiver Code nennt seinen Affiliate, ein unbekannter oder stillgelegter wird ignoriert. Enthält der Payload keinen Slug, schreibt Rekomi den Verkauf über einen früheren Lead mit derselben E-Mail-Adresse oder über den eigenen Rekomi-Tag des Kontakts gut. Ein Slug im Payload, den der Kontakt nicht trägt, wird nicht erfasst, ebenso wenig ein Kauf für eine E-Mail-Adresse, zu der HighLevel keinen Kontakt hat. Käufe werden nur erfasst, solange Verkäufe über GoHighLevel gutschreiben eingeschaltet ist. Senden ein Trigger Payment Received und ein Trigger Order Form Submission dieselbe Bestellung, erfasst Rekomi sie trotzdem nur einmal, weil die Bestell-ID der Schlüssel ist; sende aus beiden denselben Wert für order_id. Kommt derselbe Kauf zusätzlich über dein verbundenes Stripe-Konto an, führt Rekomi beides zusammen: Die Stripe-Zahlung wird an den Verkauf gehängt, den der Webhook schon erfasst hat (gleiche E-Mail-Adresse des Käufers, gleicher Betrag und gleiche Währung innerhalb von 90 Tagen), statt doppelt zu zählen. So bleibt die Gutschrift über den Gutschein erhalten, und Erstattungen werden weiterhin zugeordnet. Erstattungen für diese Verkäufe erreichen Rekomi nicht aus HighLevel. Erkläre den Verkauf auf der Seite Conversions für ungültig, wenn du eine Bestellung erstattest.

Der Schalter und die Statuszeile

Verkäufe über GoHighLevel gutschreiben sitzt auf der Integrationsseite neben Affiliates in GoHighLevel synchronisieren. Darunter zeigt die Seite einen schlichten Satz zum Status: ob die letzte Prüfung deiner Location durch Rekomi erfolgreich war, wann sie lief und wie viele Verkäufe bisher über GoHighLevel gutgeschrieben wurden. Rekomi führt diese Prüfung beim Verbinden aus. Ein Verkauf wird nur gutgeschrieben, wenn der Kontakt innerhalb des Zeitfensters angelegt wurde, das die Seite anzeigt (standardmäßig 365 Tage).

Schaltest du den Schalter aus, enden die Abfragen, und die beiden Tags verschwinden aus den Links deiner Affiliates. Deine Workflows senden weiter an die eingehende URL, und Leads werden weiter erfasst; nur die Gutschrift von Verkäufen über die Attribution endet.

E-Mail-Adresse eines Abonnenten prüfen

Unter dem Verkaufsbereich nimmt E-Mail-Adresse eines Abonnenten prüfen eine Adresse entgegen und zeigt dir, was HighLevel dazu gespeichert hat: ob der Kontakt in deiner Location existiert, ob seine Attribution einen deiner Affiliates nennt und ob ein Verkauf von dieser E-Mail-Adresse gutgeschrieben würde. So testest du es: Öffne einen Affiliate-Link, sende ein Formular mit einer neuen Adresse ab und prüfe diese Adresse dann hier.

Grenzen, offen gesagt

• Der Link muss auf einer Seite landen, die HighLevel erfasst. Ein Link auf eine Seite, die weder bei HighLevel gehostet ist noch das Tracking-Skript von HighLevel ausführt, speichert nichts. Ein Formular, das per iframe auf einer anderen Website eingebettet ist, speichert die Seite des iframes, nicht die Ankunft des Besuchers.
• UTM-Werte unterscheiden in HighLevel Groß- und Kleinschreibung. Die Tags von Rekomi sind kleingeschrieben; ein von Hand bearbeiteter Link mit anderer Schreibweise passt nicht.
• Deine eigenen Kampagnen überschreiben die letzte Ankunft. Klickt ein Kontakt vor dem Kauf auf eine deiner eigenen getaggten E-Mails, trägt er deine Kampagne als letzte Ankunft. Deshalb prüft Rekomi zuerst die erste Ankunft.
• HighLevel erlaubt doppelte Kontakte. Teilen sich zwei Kontakte eine E-Mail-Adresse, liest Rekomi den, den HighLevel für diese E-Mail-Adresse zurückgibt.
• Das Rate-Limit von HighLevel wird geteilt. 100 Anfragen pro 10 Sekunden und Location. Rekomi braucht ein bis zwei Lesezugriffe pro Verkauf, hält einen kurzen Cache pro E-Mail-Adresse, damit derselbe Käufer bei einer Häufung nicht zweimal gelesen wird, und wiederholt einen Lesezugriff für Verkäufe nach zwei Minuten, wenn HighLevel mit 429 antwortet. Der Affiliate-Sync hält sich an Retry-After.

Affiliates in GoHighLevel synchronisieren

Affiliates (immer aktiv, solange der Schalter an ist)

Sobald ein Affiliate freigegeben wird (oder optional schon bei seiner Bewerbung), ruft Rekomi POST /contacts/upsert mit folgenden Daten auf:

• locationId, dein Sub-Account
• email, firstName, lastName
• source: "Rekomi"
• customFields: Rekomi referral link, Rekomi referral slug, Rekomi campaign, Rekomi affiliate status

Danach setzt es Tags mit POST /contacts/{id}/tags: Rekomi affiliate plus alle Standard-Tags, die du festgelegt hast. Tags werden nur hinzugefügt, nie ersetzt, die Tags aus deinen eigenen Workflows bleiben also erhalten. Der Empfehlungslink, der beim Kontakt gespeichert wird, trägt dieselben beiden Tags wie die Links, die Rekomi den Affiliates anzeigt.

Vermittelte Kunden und Leads (optional)

Schalte unter Affiliates in GoHighLevel synchronisieren die Option Vermittelte Kunden und Leads synchronisieren ein. Jeder Verkauf und jeder Lead, den Rekomi einem Affiliate zuordnet, auch Verkäufe, die über die Aufgabe oben über GoHighLevel gutgeschrieben werden, wird als Kontakt angelegt oder aktualisiert (Abgleich über die E-Mail-Adresse), mit:

• Rekomi referring affiliate, Rekomi referring affiliate slug, Rekomi referring affiliate email, Rekomi referring affiliate code
• Rekomi last event (sale oder lead) und Rekomi last sale amount (bei Verkäufen)
• Rekomi campaign
• Tag Rekomi customer (Verkauf) oder Rekomi lead (Anmeldung ohne Kauf), plus deine Standard-Tags

Erstattete, abgelehnte und wegen Betrugsverdacht in Quarantäne gestellte Conversions werden nie übertragen. Importierte historische Conversions werden ebenfalls nicht übertragen.

Benutzerdefinierte Felder

Rekomi legt jedes fehlende Feld Rekomi ... beim ersten Einsatz an (Textfelder im Kontaktmodell). HighLevel leitet den Merge-Schlüssel aus dem Namen ab, in E-Mails, SMS und Workflows kannst du also zum Beispiel Folgendes nutzen:

• {{contact.rekomi_referral_link}}
• {{contact.rekomi_referring_affiliate}}
• {{contact.rekomi_last_event}}

Wenn du die Felder lieber vorher selbst anlegst, nutze genau die Namen oben, dann verwendet Rekomi sie weiter.

Zugangsdaten finden

In deinem HighLevel-Sub-Account (nicht in der Agenturansicht):

1. Settings, dann Business Profile. Kopiere die Location ID (etwa 20 Buchstaben und Ziffern).
2. Settings, dann Private Integrations, dann Create new integration. Gib ihr den Namen „Rekomi“.
3. Berechtigungen (Scopes): Contacts (view and edit) und Custom Fields (view and edit). Mehr ist nicht nötig; die Berechtigung für Kontakte deckt auch das Lesen der Attribution ab.
4. Kopiere den Token. Er beginnt mit pit-.

Agentur-API-Schlüssel und alte v1-Schlüssel funktionieren mit dieser Integration nicht; das Verbindungsformular lehnt sie ab, bevor es einen Aufruf macht.

GoHighLevel in Rekomi verbinden

1. Öffne Integrationen in der Seitenleiste des Dashboards.
2. Klicke auf die Karte von GoHighLevel.
3. Füge die Location ID und den Private-Integration-Token ein. Klicke auf Verbinden.
4. Rekomi führt einen Testaufruf gegen GET /locations/{locationId}/customFields aus, der auch die Berechtigung für benutzerdefinierte Felder bestätigt, und prüft dann, ob es Kontakte lesen kann. So ist die Statuszeile für Verkäufe sofort ausgefüllt.
5. Füge nach dem Verbinden Standard-Tags hinzu, wenn du welche willst, und schalte Vermittelte Kunden und Leads synchronisieren ein, wenn du auch Kunden in HighLevel haben möchtest.

Es gibt keine Listenauswahl: In HighLevel ist die Location selbst die Zielgruppe. Segmentiere mit Tags und deinen eigenen Smart Lists.

Leads von HighLevel an Rekomi senden

Nutze das, wenn die Anmeldung in einem HighLevel-Formular oder -Funnel stattfindet und du den Lead schon vor jedem Verkauf dem Affiliate gutschreiben willst, über dessen Link der Besucher kam.

1. Auf der Landingpage speichert HighLevel die Ankunft über den Affiliate-Link bereits (der Wert von utm_campaign ist der Slug des Affiliates), auf bei HighLevel gehosteten Seiten brauchst du also kein verstecktes Feld. Läuft dein Formular auf einer Seite, die HighLevel nicht erfasst, füge ein verstecktes Feld namens via (oder rekomi_via) hinzu, das aus dem URL-Parameter gefüllt wird; HighLevel-Formulare können URL-Parameter in Felder übernehmen, wenn der Feldname zum Parameter passt.
2. Kopiere die Eingehende Webhook-URL, die auf der GoHighLevel-Integrationsseite in Rekomi angezeigt wird. Behandle sie wie ein Passwort: Wer sie hat, kann Leads an dein Konto senden.
3. Öffne in HighLevel den Workflow, der bei diesem Formular läuft, und füge eine Aktion Webhook hinzu. Methode POST, URL = deine eingehende URL. Der Standard-Payload enthält email, first_name, last_name und die benutzerdefinierten Felder deines Formulars auf oberster Ebene. Füge im Bereich Custom Data zwei Felder hinzu, damit der Slug des Affiliates mit der Einsendung mitkommt: utm_source mit dem festen Wert rekomi und utm_campaign, gesetzt auf das Attributions-Merge-Feld des Kontakts für die UTM-Kampagne. Rekomi liest utm_campaign nur, wenn daneben utm_source mit dem Wert rekomi steht. Ein einzelnes Feld namens rekomi_campaign, gesetzt auf dasselbe Merge-Feld, funktioniert auch allein. Hast du auf einer nicht erfassten Seite ein verstecktes Feld genutzt, sende stattdessen via.

Rekomi liest email, die Namensfelder und den Slug des Affiliates aus rekomi_campaign, aus utm_campaign, wenn daneben utm_source mit dem Wert rekomi steht, aus den Attributionsobjekten von HighLevel, wenn der Workflow sie weiterleitet (zuerst attributionSource, dann lastAttributionSource, jeweils nur, wenn deren utmSource gleich rekomi ist), oder aus einem der Felder rekomi_via, via, rekomi_affiliate, referring_affiliate, affiliate, ref, referral. Feldnamen werden ohne Rücksicht auf Groß- und Kleinschreibung abgeglichen, auf oberster Ebene des Payloads oder in seinem Objekt customData. Eine Einsendung ohne Affiliate-Slug wird bestätigt und ignoriert. So erfasste Leads verhalten sich genau wie Leads aus dem Tracking-Skript: Du siehst sie beim Affiliate, und kauft diese Person später, schreibt die Attribution über den E-Mail-Abgleich von Rekomi den Verkauf gut.

Die eingehende URL löst nur Slugs auf, die zu deinem Konto gehören, und jede Antwort ist ein schlichtes 200, sodass sich damit keine Slugs ausforschen lassen.

Tags

Gib auf der Integrationsseite Standard-Tags ein (bis zu 8, je 64 Zeichen). Rekomi setzt immer den System-Tag (Rekomi affiliate, Rekomi customer oder Rekomi lead), damit du darauf Smart Lists und Workflow-Trigger aufbauen kannst.

Wann synchronisiert wird

• Standard: Nur Affiliates mit dem Status Approved (freigegeben) werden synchronisiert.
• Optional: Schalte „Bewerber vor der Freigabe einschließen“ ein, um auch Affiliates mit dem Status Pending (ausstehend) zu synchronisieren.
• Kunden und Leads: Sobald die Conversion erfasst wird (Stripe oder eine andere Abrechnungsquelle, der Kauf- oder Lead-Webhook oben, ein S2S-Postback, eine Anmeldung über das Tracking-Skript oder ein Verkauf, der über die Attribution von GoHighLevel gutgeschrieben wird).

Einstellungen pro Kampagne

Jede Kampagne kann die Konfiguration auf Kontoebene überschreiben. Öffne auf der Detailseite einer Kampagne den Tab Kampagneneinstellungen und scrolle zum Abschnitt CRM-Sync. Schaltest du eine Kampagne dort ab, stoppen für diese Kampagne sowohl der Affiliate- als auch der Kunden-Sync.

Sync-Status pro Affiliate

Öffne die Detailseite eines beliebigen Affiliates. Das Panel CRM-Sync zeigt den Status pro CRM. Erneut synchronisieren verwirft frühere Jobs und startet den Sync neu.

Fehlerbehebung

• Verbindungstest schlägt mit 401 fehl: Der Token ist kein Private-Integration-Token, wurde widerrufen oder gehört zu einem anderen Sub-Account als die Location ID. Erstelle den Token im selben Sub-Account neu.
• Verbindungstest schlägt mit 403 fehl: Dem Token fehlt die Berechtigung Custom Fields. Bearbeite die Integration in HighLevel und füge sie hinzu.
• Kontakte kommen ohne Rekomi-Felder an: Der Token kann keine benutzerdefinierten Felder anlegen (Berechtigung), oder die Location hat ihr Limit für benutzerdefinierte Felder erreicht. Rekomi synchronisiert den Kontakt trotzdem; lege die Felder von Hand mit genau diesen Namen an und synchronisiere erneut.
• Tags fehlen an einem Kontakt: Prüfe, ob der Kontakt nach dem Sync in HighLevel zusammengeführt wurde; beim Zusammenführen bleiben nur die Tags des verbleibenden Datensatzes erhalten.
• HTTP 429: HighLevel erlaubt 100 Anfragen pro 10 Sekunden und Location. Rekomi taktet die Syncs und hält sich an Retry-After; eine große Sammelfreigabe dauert dann einfach ein paar Minuten.
• Leads aus dem Webhook erscheinen nicht: Prüfe, ob der Payload email und ein Slug-Feld enthält, ob der Slug zu einem freigegebenen Affiliate in deinem Konto gehört und ob der Affiliate nicht seine eigene E-Mail-Adresse einsendet (Leads in eigener Sache werden verworfen und als Betrugssignal erfasst).
• Ein Kauf erscheint als Kauf, aber nicht als gutgeschriebener Verkauf. Nutze E-Mail-Adresse eines Abonnenten prüfen mit der Adresse des Käufers. Kein Kontakt heißt, dass der Käufer nie ein erfasstes HighLevel-Formular abgesendet hat; ein Kontakt ohne Rekomi-Attribution heißt, dass der Link auf einer nicht erfassten Seite gelandet ist oder die Schreibweise geändert wurde. Erscheint eine einmalige Bestellung gar nicht als Kauf, fehlt der Workflow-Webhook von oben.
• Sync schlägt mit 401/403 fehl, obwohl er vorher lief: Der Token wurde widerrufen. Rekomi markiert die Integration mit „Aktion nötig“ und schickt dir pro Störung einmal eine E-Mail zum Neuverbinden. Erstelle einen neuen Token, verbinde neu und nutze dann Alle erneut synchronisieren auf der Kachel Fehlgeschlagen.

Verbindung trennen

Klicke auf der Verbindungsseite von GoHighLevel auf Trennen. Der Integrationseintrag, seine eingehende Webhook-URL und die Einstellungen pro Kampagne werden gelöscht (die alte URL funktioniert sofort nicht mehr, entferne die Webhook-Aktionen also auch aus deinen Workflows). Der bisherige Sync-Verlauf bleibt für Prüfzwecke erhalten.

---

Anwendungsfälle, passende Zielgruppen und besondere Automatisierungsmuster findest du im Überblick zur GoHighLevel-Integration auf der Website.