Mailjet

Die Mailjet-Integration von Rekomi fügt jeden freigegebenen Affiliate zu einer Mailjet-Kontaktliste hinzu.

Was synchronisiert wird

Sobald ein Affiliate freigegeben wird (oder optional schon bei seiner Bewerbung), ruft Rekomi POST /v3/REST/contactslist/{listId}/managecontact mit Email, einem zusammengesetzten Name und Action: "addnoforce" auf.

addnoforce legt den Kontakt an und trägt ihn in die Liste ein, holt aber Kontakte, die sich früher abgemeldet haben, NICHT zurück (Schutz der Zustellbarkeit: Rekomi nutzt nie addforce, das Abmeldungen rückgängig machen würde).

API-Schlüssel finden

In Mailjet:

1. Account → API Key Management.
2. Kopiere den API Key (öffentlich) und den Secret Key (privat).

Mailjet in Rekomi verbinden

1. Öffne Integrationen in der Seitenleiste des Dashboards.
2. Klicke auf die Karte von Mailjet.
3. Füge beide Schlüssel ein. Klicke auf Verbinden.
4. Rekomi führt einen Testaufruf gegen GET /v3/REST/user aus.

Tags

Mailjet kennt keine echten Tags. Rekomi ignoriert das Tags-Array beim Eintragen, denn unbekannte Kontakteigenschaften müssten vorher über contactmetadata registriert werden und gingen sonst stillschweigend verloren. Wenn du eine Segmentierung wie mit Tags willst, lege in Mailjet von Hand Eigenschaften an und baue Segmente darauf auf.

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

• die Kontakteigenschaften rekomi_referral_link, rekomi_campaign, rekomi_referring_affiliate, rekomi_referring_affiliate_code, rekomi_last_event, rekomi_last_sale_amount, die beim ersten Einsatz angelegt werden
• keine Tags; segmentiere über rekomi_last_event
• 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 den Tab Kampagneneinstellungen und scrolle zum 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

• 401: Einer oder beide Schlüssel sind ungültig. Kopiere sie erneut unter Account → API Key Management. Wiederholte Authentifizierungsfehler markieren die Integration mit „Aktion nötig“ und lösen pro Störung einmal eine E-Mail zum Neuverbinden aus. Nutze nach dem Neuverbinden Alle erneut synchronisieren auf der Kachel Fehlgeschlagen der Integrationsseite.
• 429 mit dem Code MJ-002 im Antwortinhalt: Rate-Limit. Rekomi hält sich an Retry-After, wenn der Header mitkommt, und weicht sonst auf exponentiellen Backoff aus.
• Das Namensfeld zeigt nur das erste Wort: Mailjet hat ein einziges Feld Name, Rekomi setzt Vor- und Nachname mit einem Leerzeichen zusammen. Zeigt der Kontakt nur „Jane“, prüfe, ob Rekomi für den Affiliate sowohl firstName als auch lastName erfasst hat.

Verbindung trennen

Klicke auf der Verbindungsseite von Mailjet 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 Mailjet-Integration auf der Website.