ActiveCampaign

Die ActiveCampaign-Integration von Rekomi trägt jeden freigegebenen Affiliate in eine Liste deiner Wahl ein und vergibt Tags, damit du ihn in deinem ActiveCampaign-Dashboard erkennst.

Was synchronisiert wird

Sobald ein Affiliate freigegeben wird (oder optional schon bei seiner Bewerbung):

• Ein Kontakt wird über POST /api/3/contact/sync mit email, firstName und lastName angelegt oder aktualisiert.
• Der Kontakt wird über POST /api/3/contactLists mit status = 1 in deine gewählte Liste eingetragen.
• Jeder eingerichtete Tag wird über seinen Namen gefunden (oder angelegt, falls er fehlt) und über POST /api/3/contactTags vergeben.

Der Endpunkt „sync“ lässt sich gefahrlos wiederholen: Eine erneute Synchronisierung desselben Affiliates aktualisiert den bestehenden Kontakt, statt ein Duplikat anzulegen. Alle drei Aufrufe laufen vollständig synchron, ein „Erfolgreich“ in Rekomi bedeutet also, dass der Kontakt tatsächlich in deiner Liste ist.

API-Schlüssel und URL finden

In ActiveCampaign:

1. Klicke oben rechts auf das Zahnradsymbol und dann in der linken Seitenleiste auf Developer.
2. Die Seite API Access zeigt sowohl die URL (z. B. https://your-account.api-us1.com) als auch den Key.
3. Kopiere beides.

ActiveCampaign in Rekomi verbinden

1. Öffne Integrationen in der Seitenleiste des Dashboards.
2. Klicke auf die Karte ActiveCampaign.
3. Füge die API-URL und den API-Schlüssel ein. Klicke auf Verbinden.
4. Rekomi führt einen Testaufruf gegen GET /api/3/users/me aus, um beide Zugangsdaten zu prüfen. Liegt die URL nicht auf api-us1.com oder ist der Schlüssel ungültig, lehnt das Formular die Verbindung mit dem tatsächlichen Fehler von ActiveCampaign ab.
5. Wähle nach dem Verbinden im Dropdown eine Standardliste. Die Listen werden aus deinem ActiveCampaign-Konto geladen.

Tags

Kommagetrennt. Jeder Tag-Name wird über GET /api/3/tags?search= gesucht (exakte Übereinstimmung des Namens). Gibt es noch keinen Tag mit diesem Namen, legt Rekomi ihn über POST /api/3/tags mit tagType: "contact" an. Danach werden die Tags über POST /api/3/contactTags an den Kontakt gehängt. Der System-Tag Rekomi affiliate wird immer vergeben.

Schlägt das Vergeben eines einzelnen Tags fehl, wird die Eintragung nicht rückgängig gemacht (der Kontakt ist ja schon in der Liste); der Fehler wird protokolliert, damit du ihm nachgehen kannst.

Vermittelte Kunden und Leads (optional)

Schalte auf der Integrationsseite Vermittelte Kunden und Leads synchronisieren ein, dann schreibt Rekomi jeden Verkauf und jeden Lead, den es einem Affiliate zuordnet, auch nach ActiveCampaign. Der Abgleich läuft über die E-Mail-Adresse, bestehende Kontakte werden also aktualisiert statt doppelt angelegt. Jeder Eintrag enthält:

• eigene Kontaktfelder mit den Namen Rekomi referral link, Rekomi campaign, Rekomi referring affiliate, Rekomi referring affiliate code, Rekomi last event und Rekomi last sale amount (Personalisierungs-Tags %REKOMI_REFERRAL_LINK% und so weiter), die beim ersten Einsatz für dich angelegt und in allen Listen sichtbar gemacht werden
• die Tags Rekomi customer oder Rekomi lead, ergänzt, ohne deine anderen Tags anzurühren
• Affiliates, die über den Abschnitt oben synchronisiert werden, bekommen in denselben Feldern zusätzlich Rekomi referral link, Rekomi campaign und Rekomi affiliate status, damit du den Link eines Partners in deine E-Mails einbauen kannst.

Erstattete, abgelehnte und wegen Betrugsverdacht in Quarantäne gestellte Conversions werden nie übertragen, importierte historische Conversions werden übersprungen. Die Option ist standardmäßig ausgeschaltet.

Wann synchronisiert wird

• Standard: Nur Affiliates im Status Approved (freigegeben) werden synchronisiert. Der Job startet in dem Moment, in dem ein Affiliate freigegeben wird (manuell, gesammelt oder automatisch).
• Optional: Schalte auf der Einstellungskarte des Anbieters „Bewerber vor der Freigabe einschließen“ ein, um auch Affiliates im Status Pending (ausstehend) zu synchronisieren, sobald sie sich bewerben.

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, um:

• ActiveCampaign für diese Kampagne zu deaktivieren.
• Die Affiliates dieser Kampagne in eine andere Liste zu schicken.
• Zusätzlich zu den Standards des Kontos kampagnenspezifische Tags zu vergeben.

Sync-Status pro Affiliate

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

Fehlerbehebung

• „API URL must be on api-us1.com“: Der öffentliche API-Endpunkt von ActiveCampaign liegt immer auf api-us1.com, auch bei Konten, die nach EU oder APAC migriert wurden. Kopiere die URL noch einmal exakt aus den Developer-Einstellungen.
• list_link_failed: http_404: Die Listen-ID, an die Rekomi senden will, existiert nicht mehr. Wähle im Dropdown eine andere Liste.
• 429 Rate-Limit: ActiveCampaign drosselt bei 5 Anfragen pro Sekunde und Konto. Rekomi taktet seinen Worker auf eine Eintragung pro Sekunde, und eine Eintragung braucht 3+N(Tags) Aufrufe; viele erneute Synchronisierungen auf einmal können das Limit trotzdem auslösen. Der Job wiederholt automatisch und beachtet dabei Retry-After.
• Sync schlägt mit 401/403 fehl, obwohl er vorher lief: Der API-Schlüssel wurde widerrufen oder neu erzeugt. Rekomi markiert die Integration mit „Aktion nötig“ und schickt dir pro Störung einmal eine E-Mail mit der Bitte, neu zu verbinden. Verbinde dich mit neuen Zugangsdaten und nutze dann auf der Kachel Fehlgeschlagen der Integrationsseite Alle erneut synchronisieren.

Trennen

Klicke auf der Verbindungsseite von ActiveCampaign auf Trennen. Rekomi:

• Löscht den Integrationseintrag vollständig (es bleibt kein Restzustand zurück).
• Löscht alle Einstellungen pro Kampagne, die darauf verweisen.
• Behält historische Sync-Einträge für die Nachvollziehbarkeit.

Du kannst jederzeit neu verbinden; du startest dann bei null.

---

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