Superchat verbindet sich über Webhooks mit n8n. Dadurch kannst du Workflows automatisch basierend auf Ereignissen in Superchat auslösen – zum Beispiel, wenn ein neuer Kontakt erstellt oder ein Gespräch eröffnet wird. Dieser Artikel erklärt die Einrichtungsschritte, zeigt ein praktisches Beispiel und gibt Tipps zur Fehlerbehebung.
Bevor du startest
Stelle sicher, dass du Folgendes vorbereitet hast:
Ein aktives Superchat-Konto
Eine funktionierende n8n-Instanz (Cloud oder selbst gehostet)
Grundlegende Kenntnisse im Erstellen von Workflows und Hinzufügen von Nodes in n8n
Superchat mit n8n verbinden
Erstelle in n8n einen neuen Workflow und füge einen Webhook-Node als Trigger hinzu
Stelle die HTTP-Methode auf POST ein und kopiere die Test-Webhook-URL
Navigiere in Superchat zu Einstellungen → Integrationen → Webhooks und erstelle einen neuen Webhook
Füge die n8n-Webhook-URL in das URL-Feld ein und wähle das/die Ereignis(se) aus, das/die den Workflow auslösen soll(en)
Kehre zu n8n zurück und klicke auf Auf Testereignis warten
Löse das ausgewählte Ereignis in Superchat aus (z. B. erstelle einen neuen Kontakt), um eine Test-Nutzlast an n8n zu senden
Sobald n8n die Nutzlast empfängt, siehst du die eingehenden Daten im Editor – die Verbindung funktioniert
Test-URL vs. Produktions-URL
n8n generiert für jeden Webhook-Node zwei separate URLs – eine Test-URL und eine Produktions-URL.
Die Test-URL empfängt nur Daten, während du in n8n auf Auf Testereignis warten geklickt hast. Sie dient nur zum Erstellen und Debuggen und läuft nach 120 Sekunden ab.
Die Produktions-URL ist diejenige, die du in Superchat einfügen solltest, sobald dein Workflow bereit ist. Sie wird erst aktiv, wenn du deinen Workflow gespeichert und mit dem Schalter oben rechts im n8n-Canvas aktiviert hast. Wenn dein Workflow nicht aktiviert ist, lösen Ereignisse aus Superchat nichts aus.
Welche Daten sendet Superchat?
Wenn ein Webhook-Ereignis ausgelöst wird, sendet Superchat eine JSON-Nutzlast an n8n, die Details zum Ereignis enthält. Eine vollständige Referenz der Felder für jeden Ereignistyp findest du im Superchat Webhook-Objektmodell in der Entwicklerdokumentation.
Um eine Live-Nutzlast während der Entwicklung zu prüfen, verwende die Test-URL, löse ein Ereignis in Superchat aus und sieh dir die Rohdaten direkt im n8n-Editor an.
Praktisches Beispiel: Neuen Superchat-Kontakt zu Google Sheets hinzufügen
In diesem Beispiel wird jedes Mal eine neue Zeile in einer Google-Tabelle erstellt, wenn ein Kontakt in Superchat angelegt wird.
Richte den Webhook-Node wie oben beschrieben ein und sende ein Testereignis von Superchat, damit n8n Beispieldaten zum Arbeiten hat
Füge einen Google Sheets-Node hinzu und verbinde ihn mit dem Webhook-Node
Stelle den Vorgang auf Zeile anfügen ein
Wähle dein Ziel-Tabellenblatt und Arbeitsblatt aus
Ordne die Felder aus der Superchat-Nutzlast den entsprechenden Spalten zu – siehe das Webhook-Objektmodell für die genauen Feldnamen
Klicke auf Schritt testen, um zu überprüfen, ob eine Zeile korrekt erstellt wird
Sobald bestätigt, wechsle den Webhook-Node auf die Produktions-URL, speichere den Workflow und aktiviere ihn
Dein Workflow wird nun automatisch jedes Mal ausgeführt, wenn ein neuer Kontakt in Superchat erstellt wird.
Fehlerbehebung
Der Workflow wird nicht ausgelöst
Überprüfe, ob dein Workflow aktiviert ist und ob die Produktions-URL – nicht die Test-URL – in Superchat gespeichert ist.
Daten kommen an, aber Felder sind leer
Öffne das Ausführungen-Panel in n8n (linke Seitenleiste), um die empfangene Roh-Nutzlast zu prüfen. Dies zeigt genau, was Superchat gesendet hat, und hilft, Zuordnungsprobleme zu identifizieren.
Das Testereignis wird nicht empfangen
Stelle sicher, dass du in n8n auf Auf Testereignis warten geklickt hast, bevor du das Ereignis in Superchat auslöst. Die Test-URL läuft nach 120 Sekunden ab – wenn sie abgelaufen ist, klicke erneut darauf, bevor du es noch einmal versuchst.