Flodesk

Die Flodesk-Verbindung von Rekomi erledigt eine Aufgabe: Affiliates in Flodesk synchronisieren fügt jeden freigegebenen Affiliate als Abonnenten zu einem Flodesk-Segment hinzu.

Was diese Verbindung kann und was nicht. Sie synchronisiert Affiliates nach Flodesk. Verkäufe schreibt sie nicht gut, und die Integrationsseite zeigt keinen Schalter Verkäufe über Flodesk gutschreiben: Flodesk hat auf keinem bei Flodesk gehosteten Formular, keiner Seite und keinem Checkout einen Platz, an dem gespeichert wird, über welchen Link ein Abonnent kam. Rekomi kann also nichts auslesen. Um Affiliates Verkäufe gutzuschreiben, nutze den normalen Installationsweg: Verbinde den Zahlungsanbieter hinter deinem Checkout unter Einrichtung > Zahlungsanbieter verbinden und installiere das Rekomi-Skript auf deiner eigenen Website, auf der Affiliate-Links landen (siehe die Installationsanleitungen). Wenn du über Flodesk Checkout verkaufst: Die Abrechnung läuft über ein Stripe-Konto, das Flodesk für dich angelegt hat und das von jedem anderen Stripe-Konto getrennt ist. Verbinde genau dieses.

Affiliates in Flodesk synchronisieren

Was synchronisiert wird

Sobald ein Affiliate freigegeben wird (oder optional schon bei seiner Bewerbung), ruft Rekomi POST /v1/subscribers mit email, first_name, last_name und segment_ids: ["segId"] auf. Der Endpunkt arbeitet als Upsert, ein erneuter Sync liefert 200 mit dem aktualisierten Abonnenten.

Den Status verwaltet die API von Flodesk selbst (schreibgeschützt), neue Abonnenten sind standardmäßig active.

API-Schlüssel finden

In Flodesk:

1. Account → Integrations → Developer API.
2. Klicke auf Add API key. Kopiere den Schlüssel.

Flodesk in Rekomi verbinden

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

Tags

Flodesk kennt keine Tags, nur Segmente. Rekomi ignoriert das Tags-Array beim Eintragen. Wenn du etwas wie Tags brauchst, lege eigene Flodesk-Segmente an und richte die Einstellungen pro Kampagne auf sie aus.

Vermittelte Kunden und Leads (optional)

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

• die benutzerdefinierten Felder rekomi_referral_link, rekomi_campaign, rekomi_referring_affiliate, rekomi_referring_affiliate_code, rekomi_last_event, rekomi_last_sale_amount
• 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. Erlaubt dein Flodesk-Plan das Anlegen benutzerdefinierter Felder per API nicht, lege sie selbst mit genau diesen Schlüsseln an, Rekomi füllt sie dann.

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

• 400 mit „status is read-only“: Sollte nicht vorkommen, denn Rekomi sendet nie einen Status. Wenn du das siehst, melde dich beim Support.
• 429: Flodesk drosselt Abonnenten-Aufrufe bei 100 Anfragen pro Minute. Ein Retry-After-Header ist nicht dokumentiert, Rekomi weicht deshalb auf exponentiellen Backoff aus.
• 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 Flodesk 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 Flodesk-Integration auf der Website.