EmailOctopus

Die EmailOctopus-Integration von Rekomi fügt jeden freigegebenen Affiliate zu einer EmailOctopus-Liste hinzu.

Was synchronisiert wird

Sobald ein Affiliate freigegeben wird (oder optional schon bei seiner Bewerbung), ruft Rekomi PUT /lists/{listId}/contacts (Upsert) auf und übergibt email_address, status: "subscribed", fields: { FirstName, LastName } und deine konfigurierten Tags (beim PUT-Upsert gehen Tags als Map aus Tag-Name und true mit, vorhandene Tags am Kontakt bleiben unberührt).

PUT ist der Weg für den Upsert, POST würde bei doppelten E-Mail-Adressen mit 409 antworten.

API-Schlüssel finden

In EmailOctopus:

1. Settings → API keys (emailoctopus.com/developer/api-keys).
2. Klicke auf Create a key. Gib ihm den Namen „Rekomi“.
3. Kopiere den Schlüssel.

EmailOctopus in Rekomi verbinden

1. Öffne Integrationen in der Seitenleiste des Dashboards.
2. Klicke auf die Karte von EmailOctopus.
3. Füge deinen API-Schlüssel ein. Klicke auf Verbinden.
4. Rekomi führt einen Testaufruf gegen GET /lists?limit=1 aus.

Tags

Kommagetrennte Zeichenketten. Die Tags werden direkt beim Upsert gesetzt: Rekomi schickt den System-Tag Rekomi affiliate und alle Standard-Tags mit, die du konfiguriert hast. Hinzu kommen nur die Tags, die Rekomi sendet. Tags, die schon am Kontakt hängen, bleiben unberührt.

Hinweis zu Feldnamen

Die fields-Map von EmailOctopus verwendet als Schlüssel die Feld-Tags, die du pro Liste festlegst. Standard sind FirstName / LastName (PascalCase), und Rekomi sendet mit genau diesen Namen. Hast du die Feld-Tags in deiner Liste umbenannt, gehen Vor- und Nachname stillschweigend verloren. Prüfe also, ob die Feld-Tags deiner Liste der Standardkonvention entsprechen, oder benenne sie wieder in FirstName/LastName um.

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 EmailOctopus. Der Abgleich läuft über die E-Mail-Adresse, bestehende Kontakte werden also aktualisiert statt doppelt angelegt. Jeder Eintrag enthält:

• die Listenfelder Rekomi referral link, Rekomi campaign, Rekomi referring affiliate, Rekomi referring affiliate code, Rekomi last event, Rekomi last sale amount (Feld-Tags RekomiReferralLink und so weiter), die beim ersten Einsatz in der Liste angelegt werden
• den Tag Rekomi customer oder Rekomi lead
• 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 Affiliates in deine E-Mails einfügen 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 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.

Einstellungen pro Kampagne

Jede Kampagne kann die Konfiguration auf Kontoebene überschreiben. Öffne auf der Detailseite einer Kampagne Kampagneneinstellungen und suche den Abschnitt CRM-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

• Vor- und Nachname fehlen am Kontakt: Die Feld-Tags passen nicht zu den Standardwerten FirstName / LastName. Benenne sie in EmailOctopus um oder prüfe das Feldschema deiner Liste.
• 429: EmailOctopus drosselt bei dauerhaft 10 Anfragen pro Sekunde, kurzzeitig bei 100. Rekomi hält sich an X-RateLimit-Retry-After, wenn der Header mitkommt.
• Sync schlägt mit 401/403 fehl, obwohl er vorher lief: Der API-Schlüssel wurde widerrufen. Rekomi markiert die Integration mit „Aktion nötig“ und schickt dir pro Störung einmal eine E-Mail zum Neuverbinden. Verbinde mit einem neuen Schlüssel neu und nutze dann Alle erneut synchronisieren auf der Kachel Fehlgeschlagen der Integrationsseite.

Verbindung trennen

Klicke auf der Verbindungsseite von EmailOctopus auf Trennen. Der Integrationseintrag und die Einstellungen pro Kampagne werden gelöscht. Der Sync-Verlauf bleibt erhalten.

---

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