Freshsales (Freshworks CRM)

Die Integration von Rekomi für Freshsales (Freshworks CRM) legt jeden freigegebenen Affiliate über den Upsert-Endpunkt für Kontakte an oder aktualisiert ihn, mit unique_identifier: { emails: ... }, contact: { emails, first_name, last_name, tags }. Der Endpunkt ist ein atomarer Upsert mit der E-Mail-Adresse als Schlüssel. Der API-Pfad hängt von deiner Produktlinie ab: Domains von Freshsales Suite nutzen /crm/sales/api/contacts/upsert, Freshsales Classic nutzt /api/contacts/upsert. Rekomi wählt das richtige Präfix automatisch anhand deiner Domain.

Verbinden

1. Kopiere deinen API-Schlüssel. Freshsales Suite: Profile (oben rechts) > Settings > API Settings. Freshsales Classic: Personal Settings > API Settings.
2. Öffne in Rekomi Integrationen > Freshsales (Freshworks CRM) und füge den API-Schlüssel und die Domain deiner Organisation ein. Beide Produktlinien funktionieren: yourbundle.myfreshworks.com oder yourorg.freshworks.com (Freshsales Suite) und yourorg.freshsales.io (Freshsales Classic). Ohne https:// und ohne Pfad.
3. Klicke auf Verbinden.

Tags

Voll unterstützt. Die Tags gehen direkt im Array tags mit. Der System-Tag Rekomi affiliate ist immer dabei.

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

• die benutzerdefinierten Felder cf_rekomi_referral_link, cf_rekomi_campaign, cf_rekomi_referring_affiliate, cf_rekomi_last_event, cf_rekomi_last_sale_amount
• den Tag Rekomi customer oder Rekomi lead, zusammengeführt mit den bestehenden Tags des Kontakts
• 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. Freshworks hat keine API zum Anlegen von Feldern. Lege sie einmalig unter Admin Settings > Contacts fields mit den Bezeichnungen Rekomi referral link, Rekomi campaign, Rekomi referring affiliate, Rekomi referring affiliate code, Rekomi last event, Rekomi last sale amount an, Rekomi füllt sie dann.

Hinweise zum Anbieter

• Authorization: Token token={key} (ein eigenes Format von Freshworks).
• Subdomain pro Mandant mit SSRF-Allowlist für *.myfreshworks.com, *.freshsales.io und *.freshworks.com.
• Vertriebs-CRM ohne Listenauswahl, die Segmentierung läuft über Tags.
• Rate-Limit: 1,000 Anfragen pro Stunde.
• Trennen löscht den Integrationseintrag.

---

Anwendungsfälle, passende Zielgruppen und besondere Automatisierungsmuster findest du im Überblick zur Freshworks-Integration auf der Website.