Omnisend

Die Omnisend-Integration von Rekomi legt Kontakte in deinem Omnisend-Konto an oder aktualisiert sie. Omnisend arbeitet kontoweit (ohne Listenauswahl) und ordnet Kontakte über Tags und Segmente.

Was synchronisiert wird

Sobald ein Affiliate freigegeben wird (oder optional schon bei seiner Bewerbung), ruft Rekomi POST /v3/contacts mit dem Identifier-basierten Body auf, den Omnisend erwartet:

{
  "identifiers": [{
    "type": "email",
    "id": "...",
    "channels": { "email": { "status": "subscribed", "statusDate": "..." } }
  }],
  "firstName": "...",
  "lastName": "...",
  "tags": ["Rekomi affiliate"]
}

Der Endpunkt arbeitet als Upsert: Eine bestehende E-Mail-Adresse liefert 200, eine neue 201.

API-Schlüssel finden

In Omnisend:

1. Account → Integrations → API Keys.
2. Erstelle einen neuen Schlüssel. Kopiere ihn.

Omnisend in Rekomi verbinden

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

Tags

Kommagetrennt. Omnisend nimmt das Tags-Array direkt im Aufruf an (höchstens 100). Rekomi schickt den System-Tag Rekomi affiliate und alle Standard-Tags mit, die du konfiguriert hast.

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

• die benutzerdefinierten Eigenschaften rekomi_referral_link, rekomi_campaign, rekomi_referring_affiliate, rekomi_referring_affiliate_code, rekomi_last_event, rekomi_last_sale_amount
• 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 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: Der API-Schlüssel ist ungültig. Kopiere ihn erneut unter Integrations → API Keys. 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.
• 400: Der Identifier hat ein fehlerhaftes Format. Das ist ein interner Fehler; melde dich beim Support.
• 429: Rate-Limit erreicht. Omnisend veröffentlicht kein Limit für Anfragen pro Sekunde; Rekomi weicht auf exponentiellen Backoff aus.

Verbindung trennen

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