n8n-Integration

n8n ist ein Tool, mit dem du automatische Abläufe (Workflows) baust. Mit einem Webhook-Node in n8n starten Deskwoot-Ereignisse wie eine neue Konversation, eine neue Kundennachricht oder eine CSAT-Bewertung deine n8n-Workflows. So gibst du sie an dein CRM, eine Tabelle oder deine eigenen Systeme weiter. Diesen Weg findest du auch unter Einstellungen > Integrationen > n8n.

Welchen Plan du brauchst

Der Webhook-Node bekommt seine Ereignisse von einem Deskwoot-Webhook. Webhooks gibt es ab dem Startup-Plan, auch in der Testphase. Im kostenlosen Hacker-Plan senden Webhooks nichts.

Ein Webhook schickt nur Daten aus Deskwoot hinaus. Soll n8n Nachrichten deiner Kundschaft als Bot beantworten, legst du unter Einstellungen > Bots einen Bot vom Typ Benutzerdefinierter Webhook an. Dafür brauchst du einen bezahlten Plan (ab Startup). Willst du aus n8n eine Konversation zuweisen, mit einem Label versehen oder lösen oder einen Kontakt ändern, rufst du mit dem HTTP Request Node von n8n und einem API-Token die REST-API von Deskwoot auf. Die REST-API braucht einen bezahlten Enterprise-Plan, und eine Testphase enthält keinen API-Zugang. Wie du einen Token erstellst, steht unter API-Token und Entwicklerzugriff.

In n8n einrichten

1. Öffne in n8n deinen Workflow und füge als ersten Schritt einen Webhook-Node hinzu.
2. Stelle HTTP Method auf POST.
3. Lass Respond auf Immediately, dann antwortet n8n Deskwoot sofort.
4. Kopiere die Production URL des Nodes.

In Deskwoot einrichten

1. Gehe zu Einstellungen > Webhooks. Diese Seite sehen nur Administratoren.
2. Klicke auf Webhook hinzufügen.
3. Füge die Production URL unter Endpunkt-URL ein.
4. Hake unter Ereignisse abonnieren die Ereignisse an, die dein Workflow braucht. Ist keines angehakt, bekommt der Webhook alle Ereignisse.
5. Klicke auf Webhook erstellen.

Veröffentliche dann den Workflow in n8n: Auf der Production URL hört n8n erst, wenn der Workflow veröffentlicht ist. Ab dann startet jedes Ereignis einen Durchlauf des Workflows, und du siehst die Durchläufe im Tab Executions.

Was in n8n ankommt

Jedes Ereignis kommt als POST-Anfrage mit einem JSON-Body. In der Ausgabe des Webhook-Nodes enthält der Body event (den Namen des Ereignisses), data (die Daten des Ereignisses), timestamp und accountId. In den Headern stehen x-deskwoot-event mit dem Namen des Ereignisses und x-deskwoot-signature. Schickt ein Webhook mehrere Ereignisse, lass den nächsten Node event prüfen, zum Beispiel einen If-Node.

Diese Ereignisse kannst du wählen: Konversation erstellt, Konversation aktualisiert, Konversation zugewiesen, Konversation gelöst, Nachricht erstellt, Kontakt erstellt, Kontakt aktualisiert und CSAT abgegeben. Die Daten jedes Ereignisses stehen in der API-Dokumentation.

Gut zu wissen

• Deskwoot wartet höchstens 10 Sekunden. Antwortet n8n nicht rechtzeitig oder mit einem Fehler, versucht Deskwoot es nach 5 Sekunden noch einmal. Mit Respond auf Immediately lässt auch ein langer Workflow Deskwoot nie warten.
• n8n muss aus dem Internet über HTTPS erreichbar sein. Deskwoot sendet nur an öffentliche HTTPS-Adressen. n8n auf deinem eigenen Server braucht eine öffentliche HTTPS-Adresse, keine aus deinem internen Netz.
• Nimm die Production URL, nicht die Test URL. Deskwoot sendet immer an die gespeicherte Adresse, also muss es die sein, auf der n8n hört, solange der Workflow veröffentlicht ist.

Häufige Fragen

Welchen Plan brauche ich?

Ab Startup für den Webhook, der deine Workflows startet, auch in der Testphase. Ein Bot vom Typ Benutzerdefinierter Webhook, mit dem n8n deiner Kundschaft antwortet, braucht einen bezahlten Plan (ab Startup). Willst du aus n8n Konversationen zuweisen, mit Labels versehen oder lösen oder Kontakte ändern, rufst du die REST-API auf, und die braucht einen bezahlten Enterprise-Plan.

Warum startet mein Workflow nicht?

Prüfe, ob der Workflow in n8n veröffentlicht ist, ob der Webhook in Deskwoot die Production URL hat und nicht die Test URL, ob das Ereignis angehakt ist (oder gar keines) und ob n8n aus dem Internet über HTTPS erreichbar ist. Im kostenlosen Hacker-Plan senden Webhooks gar nichts.

Kann n8n etwas in Deskwoot ändern?

Über den Webhook nicht: Er schickt nur Ereignisse hinaus. Um Nachrichten deiner Kundschaft aus n8n zu beantworten, nimmst du einen Bot vom Typ Benutzerdefinierter Webhook unter Einstellungen > Bots, der einen bezahlten Plan braucht (ab Startup). Um eine Konversation zuzuweisen, mit einem Label zu versehen oder zu lösen oder einen Kontakt zu ändern, rufst du mit dem HTTP Request Node von n8n die REST-API auf, und die braucht einen bezahlten Enterprise-Plan.

Woran erkenne ich, dass ein Ereignis wirklich von Deskwoot kommt?

Jede Anfrage hat einen Header x-deskwoot-signature: sha256= und dahinter der HMAC SHA256 des rohen Bodys als Hex, signiert mit dem Secret des Webhooks. Das Dashboard zeigt dieses Secret nicht an. Behandle die Production URL deshalb wie ein Passwort: n8n gibt ihr einen zufälligen Pfad, und nur Deskwoot sollte ihn kennen. Erstellst du den Webhook über die REST-API, bekommst du sein Secret einmal in der Antwort.

Geht das auch mit n8n Cloud?

Ja. Der Webhook-Node funktioniert in n8n Cloud und mit n8n auf deinem eigenen Server. Auf deinem eigenen Server braucht n8n eine öffentliche HTTPS-Adresse, damit Deskwoot es erreicht.

Kann ich mehrere Workflows starten?

Ja. Lege in Deskwoot für die Production URL jedes Workflows einen eigenen Webhook an, jeden mit seinen eigenen Ereignissen.

Was passiert, wenn n8n eine Weile nicht erreichbar ist?

Ereignisse aus dieser Zeit gehen nach der einen Wiederholung verloren, weil Deskwoot darüber hinaus nichts aufbewahrt. Im Enterprise-Plan kannst du über die REST-API nachholen, zum Beispiel indem du die Konversationen nach der neuesten Aktivität sortiert abrufst.