Skip to main content

​
n8n

Verbinde n8n, um eigene Attribution-Workflows zu bauen. n8n ist eine Open-Source-Alternative zu Zapier/Make — self-hosted oder in der Cloud — die jedes Formular, CRM oder jede Datenquelle über einen HTTP-Request-Node in Finseo einspeisen kann, mit voller Kontrolle über die Datentransformation.

​
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 → n8n oder via GET /v1/projects).

​
Workflow einrichten

  1. Erstelle in n8n einen neuen Workflow mit deinem bevorzugten Trigger (Formular-Übermittlung, CRM-Event, Webhook, Zeitplan, …).
  2. Füge einen HTTP Request-Node hinzu:
    • Method: POST
    • URL: https://app.finseo.ai/api/v1/projects/YOUR_PROJECT_ID/attribution
    • Authentication: Generic → Header Auth mit Authorization: Bearer YOUR_API_KEY
    • Body Content Type: JSON
  3. Mappe die Felder:
channelId ist Pflicht — übergib einen festen Kanal oder leite die Rohantwort als freetextResponse weiter und lass Finseo kategorisieren. Optionale Felder: channelLabel, subChannel, respondentName, pageUrl, formId, metadata.
  1. Führe den Node einmal zum Testen aus und aktiviere dann den Workflow.
Alternativ kannst du statt der v1-API an die Webhook-URL deines Projekts POSTen (aus dem Connect-Dialog) — praktisch, wenn du in n8n keine API-Keys verwalten willst.

​
Troubleshooting

Prüfe die Header-Auth-Konfiguration: Der Header-Name muss Authorization sein und der Wert Bearer YOUR_API_KEY mit write-Scope.
Sendest du freetextResponse ohne passende channelId, kategorisiert Finseo den Text automatisch — prüfe den rohen Antworttext, wenn die Kategorisierung nicht passt.