Skip to main content

​
Zapier / Make

Nutze Zapier oder Make als universellen Connector für Attribution: Jedes Tool mit einem Zapier/Make-Trigger — Google Forms, ein CRM, ein Umfrage-Tool — kann „Wie hast du uns gefunden?”-Antworten an die Finseo REST API senden.

​
Was du brauchst

  • Einen Finseo-API-Key mit write-Scope: Erstelle ihn unter Settings → API → Create Key.
  • Deine Projekt-ID (sichtbar im Connect-Dialog unter Integrations → Zapier / Make oder via GET /v1/projects).

​
Zap / Szenario einrichten

  1. Erstelle einen neuen Zap (Zapier) oder ein Szenario (Make) mit deinem Formular oder CRM als Trigger.
  2. Füge eine Aktion hinzu: Webhooks by Zapier → Custom Request (oder das HTTP-Modul in Make).
  3. Konfiguriere den Request:
    • Method: POST
    • URL: https://app.finseo.ai/api/v1/projects/YOUR_PROJECT_ID/attribution
    • Headers: Authorization: Bearer YOUR_API_KEY, Content-Type: application/json
  4. Mappe die Felder in den JSON-Body:
channelId ist Pflicht — mappe entweder einen festen Kanal oder übergib die Rohantwort als freetextResponse und lass Finseo kategorisieren. Optionale Felder: channelLabel, subChannel, pageUrl, formId und ein freies metadata-Objekt.
  1. Teste die Aktion — die Antwort liefert den gespeicherten Attributionsdatensatz zurück — und schalte die Automatisierung an.

​
Tipps

  • Ein API-Key kann mehrere Zaps bedienen; beschränke ihn beim Erstellen auf das relevante Projekt.
  • Für Tools mit nativen Webhooks (Typeform, Jotform, HubSpot, …) nimm lieber die direkte Integration — ganz ohne Middleware.

​
Troubleshooting

Der API-Key fehlt, hat keinen write-Scope oder ist für dieses Projekt nicht freigegeben. Erstelle unter Settings → API einen neuen Key mit Schreibzugriff.
channelId ist Pflicht und der Body muss valides JSON sein. Prüfe die gemappten Felder im Test-Output deiner Aktion.