SendGrid

Die SendGrid-Integration von Rekomi trägt jeden freigegebenen Affiliate in eine Kontaktliste von SendGrid Marketing Campaigns ein.

Was synchronisiert wird

Sobald ein Affiliate freigegeben wird (oder optional schon bei seiner Bewerbung), ruft Rekomi PUT /v3/marketing/contacts mit list_ids und den Kontaktdaten auf. SendGrid antwortet mit 202 Accepted und einer job_id. Rekomi fragt danach bis zu 5 Mal (im Abstand von 2s) GET /v3/marketing/contacts/imports/{job_id} ab, um zu bestätigen, dass der Import abgeschlossen ist, bevor der Sync als Erfolgreich markiert wird.

Dieses Muster aus asynchronem Aufruf und anschließender Abfrage verhindert den Fehlerfall „Laut Code erfolgreich, aber der Kontakt ist nie aufgetaucht“, bei dem ein 202 und ein späterer stiller Fehler im Worker ein echtes Problem verdecken würden. Ist der Job nach den 10 Sekunden Abfragezeit noch nicht fertig, wird der Sync trotzdem als Erfolgreich markiert und eine Warnung protokolliert: Das PUT wurde angenommen, und der Upsert lässt sich gefahrlos wiederholen. Einen langsamen Import als Fehler zu werten, würde nur Jobs, die fälschlich als Fehlgeschlagen gelten, und doppelte Importe erzeugen.

Deinen API-Schlüssel finden

In SendGrid:

1. Öffne Settings → API Keys → Create API Key.
2. Wähle Restricted Access und aktiviere Marketing - Read und Marketing - Write.
3. Speichere und kopiere den Schlüssel. Er beginnt mit SG. und wird nur einmal angezeigt.

SendGrid in Rekomi verbinden

1. Öffne Integrationen in der Seitenleiste des Dashboards.
2. Klicke auf die SendGrid-Karte.
3. Füge deinen API-Schlüssel ein. Klicke auf Verbinden.
4. Rekomi führt einen Testaufruf gegen GET /v3/scopes aus, um Schlüssel und Berechtigungen zu prüfen.

Tags

SendGrid kennt von Haus aus keine Tags. Rekomi ignoriert die Tags beim Eintragen (SendGrid segmentiert über Listen und custom_fields). Wenn du etwas Ähnliches wie Tags willst, lege in SendGrid eigene Listen an und verknüpfe die Einstellungen pro Kampagne damit.

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

• die benutzerdefinierten Felder rekomi_referral_link, rekomi_campaign, rekomi_referring_affiliate, rekomi_referring_affiliate_code, rekomi_last_event und rekomi_last_sale_amount, die beim ersten Gebrauch angelegt werden
• keine Tags (SendGrid hat keine); segmentiere nach 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 einsetzen 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 der Sync ausgelöst wird

• Standard: Nur Affiliates mit dem Status Approved werden synchronisiert.
• Optional: Schalte „Bewerber vor der Freigabe einschließen“ ein, um auch Pending 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

• sendgrid_no_job_id: In der 202-Antwort fehlt die job_id. Bekommt den Status Wird wiederholt, damit der Worker den Sync erneut auslöst.
• sendgrid_job_errored / sendgrid_job_failed: Der Import-Job hat einen Fehler gemeldet. Sieh im Tab „Activity“ von SendGrid nach Importfehlern.
• Der Sync zeigt Erfolgreich, aber der Kontakt erscheint erst nach einer Minute: Der Import-Job hat länger gedauert als die 10 Sekunden, die Rekomi abfragt; SendGrid schließt ihn kurz danach ab. Der Upsert lässt sich gefahrlos wiederholen, es geht also nichts verloren.
• 401: Der API-Schlüssel ist ungültig, oder ihm fehlen die Marketing-Berechtigungen. Erzeuge ihn mit den richtigen Einschränkungen neu. Wiederholte Authentifizierungsfehler markieren die Integration mit „Aktion nötig“ und lösen eine E-Mail zum Neuverbinden aus; nutze nach dem Korrigieren des Schlüssels Alle erneut synchronisieren auf der Kachel Fehlgeschlagen.

Trennen

Klicke auf der SendGrid-Verbindungsseite auf Trennen. Die Integration 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 SendGrid-Integration auf der Website.