Brevo
Verbinde Brevo (früher Sendinblue), damit freigegebene Affiliates automatisch in einer Kontaktliste landen.
Die Brevo-Integration von Rekomi trägt jeden freigegebenen Affiliate in eine Kontaktliste in Brevo ein, die du auswählst.
Was synchronisiert wird
Sobald ein Affiliate freigegeben wird (oder optional schon bei seiner Bewerbung), ruft Rekomi POST /v3/contacts auf, mit:
emailattributes.FIRSTNAME(Vorname)attributes.LASTNAME(Nachname)listIds: [your-chosen-list-id]updateEnabled: true(damit eine erneute Synchronisierung desselben Affiliates aktualisiert, statt einen Fehler 400 zu liefern)
Der Aufruf läuft synchron, und die Antwort ist verbindlich: 201 Created bei neuen Kontakten, 204 No Content bei bestehenden.
API-Schlüssel finden
In Brevo:
- Öffne oben rechts das Profilmenü und dann SMTP & API.
- Öffne den Tab API Keys.
- Klicke auf Generate a new API key und nenne ihn „Rekomi“.
- Kopiere den Schlüssel. Er beginnt mit
xkeysib-.
Wenn du für den Schlüssel Authorized IPs aktivierst (eine optionale Sicherheitsfunktion), musst du zuerst die Server-IPs von Rekomi freigeben, sonst liefert der Verbindungstest 401.
Brevo in Rekomi verbinden
- Öffne Integrationen in der Seitenleiste des Dashboards.
- Klicke auf die Karte Brevo.
- Füge deinen API-Schlüssel ein. Klicke auf Verbinden.
- Rekomi führt einen Testaufruf gegen
GET /v3/accountaus. - Wähle nach dem Verbinden im Dropdown eine Standardliste.
Tags
Brevo hat am Kontakt-Endpunkt kein richtiges Tag-Konzept. Rekomi zeigt für Brevo kein Tag-Feld an und sendet keine Tags (unbekannte Attributnamen führen zu HTTP 400; sicherer ist es, sie gar nicht zu senden). Wenn du eine Segmentierung ähnlich wie mit Tags willst, lege in Brevo manuell ein Kontaktattribut an (Contacts > Settings > Contact attributes) und nutze den Segment-Builder von Brevo.
Der System-Tag Rekomi affiliate wird bei Brevo deshalb ebenfalls nicht vergeben.
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 Brevo. Der Abgleich läuft über die E-Mail-Adresse, bestehende Kontakte werden also aktualisiert statt doppelt angelegt. Jeder Eintrag enthält:
- die Kontaktattribute
REKOMI_REFERRAL_LINK,REKOMI_CAMPAIGN,REKOMI_REFERRING_AFFILIATE,REKOMI_REFERRING_AFFILIATE_CODE,REKOMI_LAST_EVENTundREKOMI_LAST_SALE_AMOUNT, angelegt beim ersten Einsatz - keine Tags (Brevo hat keine); segmentiere nach
REKOMI_LAST_EVENT=leadodersale - Affiliates, die über den Abschnitt oben synchronisiert werden, bekommen in denselben Feldern zusätzlich
Rekomi referral link,Rekomi campaignundRekomi 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. - Optional: Schalte „Bewerber vor der Freigabe einschließen“ ein, um auch Affiliates im 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
- HTTP 400 „duplicate_parameter“:
updateEnabledfehlte in der Anfrage oder war false. Rekomi sendet immerupdateEnabled: true; wenn du diesen Fehler siehst, melde dich beim Support, damit wir die Anfrage prüfen können. - HTTP 400 bei unbekanntem Attribut: Brevo lehnt unbekannte Attributnamen mit 400 ab (anders als ConvertKit, das sie stillschweigend verwirft). Rekomi sendet nur FIRSTNAME / LASTNAME, die in jedem Brevo-Konto automatisch existieren.
- HTTP 403: Einschränkung über Authorized IPs. Gib die Server-IPs von Rekomi für den Schlüssel frei oder entferne die Einschränkung.
- HTTP 429: Der Kontakt-Endpunkt von Brevo drosselt bei etwa 10 Anfragen pro Sekunde. Der Worker von Rekomi taktet auf 1 pro Sekunde, das passiert also selten; falls doch, beachtet Rekomi das Zeitfenster
x-sib-ratelimit-resetvon Brevo (Brevo sendet keinen standardmäßigenRetry-After). - Sync schlägt mit 401/403 fehl, obwohl er vorher lief: Der Schlüssel wurde widerrufen, oder es wurde eine Einschränkung über Authorized IPs hinzugefügt. Rekomi markiert die Integration mit „Aktion nötig“ und schickt dir pro Störung einmal eine E-Mail mit der Bitte, neu zu verbinden. Korrigiere den Schlüssel, verbinde neu und nutze dann auf der Kachel Fehlgeschlagen der Integrationsseite Alle erneut synchronisieren.
Trennen
Klicke auf der Verbindungsseite von Brevo auf Trennen. Der Integrationseintrag und die Einstellungen pro Kampagne werden gelöscht. Der bisherige Sync-Verlauf bleibt für Prüfzwecke erhalten.
Anwendungsfälle, passende Zielgruppen und besondere Automatisierungsmuster findest du im Überblick zur Brevo-Integration auf der Website.