Zapier

Die Zapier-Integration von Rekomi verbindet dein Affiliate-Programm mit Slack, Gmail, HubSpot, Notion, Google Sheets, Airtable, Discord, Mailchimp, Typeform und jeder anderen Zapier-App. Baue Automatisierungen ohne Code, die dein Team benachrichtigen, wenn sich ein Affiliate anmeldet, Conversions mit einem Vertriebs-CRM synchronisieren, große Auszahlungen in einem Slack-Kanal posten, neue Affiliates automatisch in eine E-Mail-Liste aufnehmen oder geprüfte Bewerber freigeben, sobald sie eine Umfrage abschicken.

Die Rekomi-App ist im Zapier-Marktplatz verfügbar: Rekomi auf Zapier ansehen. Angemeldete Marken können einen Zap auch direkt im Dashboard unter Integrationen → Zapier bauen. Deine Angaben sind dort schon vorausgefüllt, du sparst dir also die Registrierung bei Zapier.

Die Rekomi-App mit Zapier zu verbinden ist kostenlos; Aktionen und Trigger laufen mit deinem Rekomi-Konto in jedem aktuellen Plan. Nur die beiden unten genannten Aktionen sind an eine Planstufe gebunden (Bulk Invite Affiliates und Mint Embed Token).

Rekomi in Zapier verbinden

Die Rekomi-App ist im Zapier-Marktplatz unter dem Namen Rekomi veröffentlicht. Die Verbindung läuft über OAuth 2.0 mit PKCE: keine API-Schlüssel, kein Kopieren und Einfügen, keine geteilten Zugangsdaten. Verbindungen gelten pro Zapier-Konto: Jedes Teammitglied, das in eurem gemeinsamen Zapier-Workspace Zaps baut, verbindet seinen eigenen Rekomi-Nutzer, damit das Audit-Log sauber bleibt. Beachte: Um die Verbindung mit dem Standard-Scope (Berechtigungsumfang) für Lesen und Schreiben abzuschließen, brauchst du die Rolle Owner in der Rekomi-Organisation; Teammitglieder ohne diese Rolle bekommen auf dem Zustimmungsbildschirm einen 403 insufficient_role.

1. Öffne in Zapier den Zap-Editor und füge einen Rekomi-Trigger oder eine Rekomi-Aktion hinzu. Wenn Zapier nach einem Konto fragt, klicke auf Connect a new account.
2. Ein neuer Tab öffnet sich unter app.rekomi.com/oauth/authorize. Melde dich an, falls du noch nicht angemeldet bist. Der Zustimmungsbildschirm zeigt die Organisation, an die die Verbindung gebunden wird (die gerade aktive); soll Zapier an eine andere Organisation gebunden werden, wechsle vorher im Rekomi-Dashboard die Organisation.
3. Der Zustimmungsbildschirm nennt den App-Namen (Zapier), den angeforderten Scope (read_write offline_access) und deine aktive Organisation. Klicke auf Allow.
4. Das Fenster schließt sich automatisch, und Zapier zeigt den Namen deiner Organisation als verbundenes Konto an. Die Verbindung wird in jedem Zap wiederverwendet, den du mit demselben Zapier-Login baust.

Der Zustimmungsbildschirm zeigt immer die Scopes, die Zapier beim Autorisieren angefordert hat, und deine aktive Organisation. Musst du die Verbindung neu autorisieren, etwa nachdem du sie im Rekomi-Dashboard widerrufen hast oder um sie auf eine andere Organisation umzustellen, öffne app.rekomi.com/dashboard/settings/connected-apps, widerrufe die Zapier-Verbindung und gehe dann in Zapier auf My Apps → Rekomi → Reconnect.

Intern nutzt Zapier den standardkonformen Ablauf OAuth 2.0 Authorization Code + PKCE (S256). Der Token-Endpunkt ist https://api.rekomi.com/connect/token, Refresh-Tokens rotieren bei jeder Nutzung, und wer ein altes Refresh-Token erneut verwendet, widerruft die gesamte Token-Familie. Alle Details zum Protokoll findest du unter OAuth 2.0.

Trigger

Trigger lösen aus, wenn in Rekomi etwas passiert, und starten einen Zap. Rekomi-Trigger sind als REST-Hooks umgesetzt: Schaltest du einen Zap ein, abonniert Zapier einen Webhook-Endpunkt für deine Organisation; schaltest du ihn aus, meldet Zapier das Abonnement sauber ab. Es gibt kein Polling und keine verpassten Ereignisse, solange der Zap eingeschaltet ist.

Filter nur im Editor. Die Trigger New Campaign Coupon und New Affiliate Coupon bieten im Zap-Editor optionale Auswahlfelder Campaign und Affiliate. Sie sind dazu da, beim Bauen des Zaps realistische Beispieldaten abzurufen. Ist der Zap live, löst der Trigger für jedes passende Ereignis in deiner Organisation aus, egal was in den Auswahlfeldern steht. Willst du Live-Läufe eingrenzen, nutze einen normalen Filter-Schritt von Zapier.

Die vollständigen Payloads der Ereignisse (das JSON, das Rekomi tatsächlich sendet) stehen in der Dokumentation zu Webhooks. Zapier zeigt diese Felder eins zu eins in der Datenauswahl des Editors an.

Aktionen

Aktionen schreiben aus einer anderen Zapier-App heraus in dein Rekomi-Konto, typischerweise als zweiter Schritt eines Zaps, dessen Trigger aus einem anderen Produkt kommt.

Hinweise zu den Plänen.

• Bulk Invite Affiliates setzt ein bezahltes Abonnement voraus. In der Testphase kommt die Antwort 402 paid_plan_required (für den Missbrauchsweg über Massen-E-Mails gibt es keine Ausnahme in der Testphase), und Zapier zeigt sie als verständlichen Hinweis zum Upgrade an.
• Mint Embed Token gehört zur White-Label-Funktion Embed und setzt die Planstufe Growth oder höher voraus. Niedrigere Planstufen bekommen 402 plan_tier_required.
• Generate Affiliate Coupon, Revoke Affiliate Coupon und Create Campaign Coupon legen intern Stripe Coupons / Promotion Codes an oder ändern sie, wenn deine Organisation Stripe über die Rekomi-App verknüpft hat. Die Zeile bei Rekomi und die Zeile bei Stripe werden in einer einzigen Transaktion synchron gehalten: Lehnt Stripe das Anlegen ab, wird die Zeile bei Rekomi zurückgerollt.

Suchen

Suchen sind reine Abfragen ohne Schreibzugriff. Du nutzt sie meist in einem Zap mit dem Schalter „Find or Create“ oder um eine Angabe in eine Rekomi-ID aufzulösen, die du an einen späteren Schritt weitergibst.

Jede Suche bietet die üblichen Such-Einstellungen von Zapier:

• „Successful if no results“: Ist das angehakt, gilt ein leeres Ergebnis als Erfolg, und der Zap läuft weiter. Praktisch in Kombination mit einem nachgelagerten Zweig „Create if not found“.
• „Return first match“ / „Return all matches“: Wähle, ob der Zap mit dem einen besten Treffer arbeitet oder sich auf alle Treffer verteilt. Beim Verteilen gibt es einen Zap-Lauf pro Treffer.

Rezepte

Sieben ausgearbeitete Beispiele zum Nachbauen. Jedes ist ein einzelner Zap; der optionale Schritt Filter oder Formatter ist normales Zapier-Handwerk und nichts Rekomi-Spezifisches.

1. Slack benachrichtigen, wenn eine hochpreisige Conversion eingeht

Du willst in #sales einen Slack-Ping, sobald ein einem Affiliate zugeordneter Verkauf über $500 liegt, aber nicht bei jedem kleinen Kauf.

1. Trigger: Rekomi → New Conversion.
2. Filter: Nur weiter, wenn amountCents größer als 50000 ist.
3. Aktion: Slack → Send Channel Message an #sales mit der Affiliate-ID, dem Betrag und der Provision.

2. Freigegebene Affiliates in Mailchimp automatisch taggen

Wenn du einen neuen Affiliate freigibst, soll er in einer Mailchimp-Zielgruppe mit dem Tag partner landen, damit er automatisch deine Onboarding-Strecke für Affiliates bekommt.

1. Trigger: Rekomi → Affiliate Approved.
2. Aktion: Mailchimp → Add/Update Subscriber. Ordne email und fullName zu und setze das Tag partner.

3. Dringende E-Mail, wenn eine Auszahlung fehlschlägt

Schlägt eine Auszahlung fehl, hat der Affiliate meist das Onboarding bei Stripe Connect nicht abgeschlossen oder sein Connect-Konto ist eingeschränkt. Du willst sofort eine Warnung an das Finanzteam.

1. Trigger: Rekomi → Payout Failed.
2. Aktion: Gmail → Send Email an finance@yourbrand.com mit der Affiliate-ID, failureReason und einem Link zur Zeile des Affiliates im Dashboard.

4. Conversions in ein Umsatzprotokoll in Google Sheets übernehmen

Die Finanzabteilung will jede Rekomi-Conversion in einer Google-Tabelle, um sie monatlich mit Stripe abzugleichen.

1. Trigger: Rekomi → New Conversion.
2. Aktion: Google Sheets → Create Spreadsheet Row. Ordne conversionId, affiliateId, amountCents, currency, commissionCents, createdAt zu.

5. Erstattungen in HubSpot nachziehen

Wird eine Conversion erstattet, soll der zugehörige HubSpot-Deal zurück in die Phase Closed Lost, refunded wandern, damit dein Vertrieb ihn nicht weiter bearbeitet.

1. Trigger: Rekomi → Conversion Refunded. Das Erstattungsereignis trägt conversionId und die erstatteten Beträge, nicht die externalEventId der Conversion.
2. Suche: Rekomi → Get Conversion by ID. Übergib conversionId aus Schritt 1; das Ergebnis enthält externalEventId (deine eigene Stripe-Rechnungs- oder Checkout-ID).
3. Aktion: HubSpot → Update Deal. Suche den Deal über diese externalEventId und ändere dann seine Phase. Ergänze einen Filter auf isFullRefund gleich true, wenn Teilerstattungen den Deal nicht verschieben sollen.

6. Anmeldungen aus deiner eigenen App als Rekomi-Leads erfassen

Der Anmeldeablauf deines Produkts läuft außerhalb des Tracking-Skripts von Rekomi (eine native App, ein eigener Funnel), aber Anmeldungen sollen trotzdem dem vermittelnden Affiliate gutgeschrieben werden, damit ein späterer Kauf richtig zugeordnet wird.

1. Trigger: deine App oder dein Formular-Tool → New Signup (jeder Zapier-Trigger, der die E-Mail-Adresse des Besuchers und deinen ?via=-Slug liefert).
2. Aktion: Rekomi → Record Lead / Signup. Ordne den Empfehlungs-Slug und die E-Mail-Adresse zu. Der Lead erscheint sofort im Funnel des Affiliates, und die Attribution über die E-Mail-Adresse greift, sobald diese Person kauft.

7. Neue Bewerber nach einer Prüfumfrage in Typeform freigeben

Du lässt potenzielle Affiliates ein Typeform mit einem Bewertungsschema zur Selbsteinschätzung ausfüllen. Wer 8 oder mehr Punkte erreicht, soll automatisch freigegeben werden; niedrigere Werte bleiben zur manuellen Prüfung ausstehend.

1. Trigger: Typeform → New Entry.
2. Filter: Nur weiter, wenn das Feld score größer oder gleich 8 ist.
3. Aktion: Rekomi → Approve Affiliate. Übergib die Affiliate-ID aus dem versteckten Feld der Typeform-Antwort.

Fehler und Wiederherstellung

Die Middleware von Rekomi wandelt jeden Fehler aus dem Backend in eine verständliche Zapier-Meldung um. Die häufigsten:

In der Zap History von Zapier kannst du jeden fehlgeschlagenen Lauf mit vollständiger Anfrage und Antwort ansehen und ihn erneut ausführen, sobald die Ursache behoben ist.

Planstufe

Die Rekomi-App in Zapier funktioniert in jedem aktuellen Plan. Zwei Aktionen sind an Bedingungen geknüpft:

• Bulk Invite Affiliates: aktives bezahltes Abonnement erforderlich (in der Testphase gesperrt).
• Mint Embed Token: Growth+ erforderlich (wie bei der Funktion Embed).

Alle anderen Trigger, Aktionen und Suchen funktionieren in jeder Organisation, auch in der Testphase. Die vollständige Tabelle der Planstufen steht in der API-Referenz.

Sicherheit

• OAuth-Referenz-Tokens. Zapier hält nicht auslesbare Referenz-Tokens (Opaque Tokens, keine JWTs). Sie liegen verschlüsselt auf den Servern von Rekomi und lassen sich jederzeit unter app.rekomi.com/dashboard/settings/connected-apps widerrufen. Der Widerruf greift beim nächsten API-Aufruf: Zapier zeigt dann einen RefreshAuthError an und fordert den Nutzer auf, sich neu zu verbinden.
• Autorisierung mit PKCE-Schutz. Authorization Code + PKCE (S256) ist für den Zapier-Client Pflicht. Autorisierungscodes laufen nach 60 Sekunden ab und gelten nur einmal.
• Refresh-Rotation mit Widerruf der ganzen Familie. Refresh-Tokens rotieren bei jeder Nutzung; wird ein altes erneut verwendet, werden alle Tokens der Familie widerrufen (gemäß OAuth 2.0 Security BCP). Aktive Zaps, die innerhalb des rollierenden 30-Tage-Fensters erneuern, müssen praktisch nie neu autorisiert werden.
• HMAC-signierte Webhook-Zustellung. Jede Payload, die Rekomi an die Catch-URL von Zapier sendet, ist mit HMAC-SHA256 signiert und mit X-Rekomi-Signature: t=<unix>,v1=<hex> versehen. Zapier prüft das auf seiner Seite; du musst nichts tun.
• Audit-Log für alles. Jede erteilte Zustimmung, jede Token-Ausgabe, jede Erneuerung, jeder Widerruf im Dashboard und jede erkannte Wiederverwendung eines Tokens schreibt einen Eintrag, den du unter /dashboard/settings/audit-log siehst (Aktionen mit dem Präfix oauth.*). Auch jeder Schreibvorgang, den Zapier auslöst, schreibt einen Eintrag; Zapier-Traffic erkennst du am User-Agent der Anfrage (Rekomi-Zapier/<version>, zum Beispiel Rekomi-Zapier/2.2.0).
• Trennung pro Organisation. Tokens sind an die Organisation gebunden, die du bei der Zustimmung gewählt hast, und können keine andere Organisation lesen oder ändern, auch wenn dein Clerk-Nutzer zu beiden gehört.

Siehe auch

• OAuth 2.0: Details zum Protokoll der Zapier-Verbindung (Autorisierungs-URL, Token-URL, Scopes, Refresh-Rotation, Widerruf).
• Webhooks: die zugrunde liegenden Ereignisformate hinter jedem Rekomi-Trigger. Zapier nutzt diese Schnittstelle über REST-Hook-Abonnements.
• API-Referenz: die direkten REST-Entsprechungen zu allem, was die Zapier-Aktionen intern tun. Hilfreich, wenn du etwas brauchst, das Zapier nicht anbietet.
• MCP-Server: das Gegenstück zu Zapier für KI-Assistenten, gleiche Rekomi-Schnittstelle, anderes Nutzungsmodell.
• Stripe verbinden: die Integration auf Seite der Marke, in die sich Zapier neben der Stripe-Verbindung einfügt.
• Verbindungen verwaltest du unter app.rekomi.com/dashboard/settings/connected-apps.