Mit Webhooks kann Smartsupp Echtzeitbenachrichtigungen an eine URL Ihrer Wahl senden — sobald eine Konversation geöffnet, ein Kontakt erstellt oder eine Nachricht zugestellt wird, erfährt Ihr System davon. Dieser Artikel erklärt, was Webhooks sind, wie Sie sie in Ihrem dashboard einrichten und wie Sie sie mit Automatisierungsplattformen wie Make und n8n verbinden.
Wir haben den Artikel in mehrere Abschnitte unterteilt:
Wofür eignen sich Webhooks?
Ein Webhook ist eine automatische HTTP-Nachricht, die Smartsupp an eine URL Ihrer Wahl sendet, sobald ein ausgewähltes Ereignis eintritt. Statt Änderungen regelmäßig abzufragen, erhalten Ihre Tools die Daten direkt, sobald etwas passiert.
Typische Anwendungsfälle sind:
Automatisierungsplattformen — lösen Sie Workflows in Make, n8n oder ähnlichen Tools aus, um Kontakte zu einem CRM hinzuzufügen, Benachrichtigungen in Slack zu posten oder Leads in einer Tabelle zu erfassen
Interne Systeme — übertragen Sie Konversations- und Kontaktdaten in Echtzeit in Dashboards, Data Warehouses oder Ticketsysteme
Benachrichtigungen — benachrichtigen Sie Ihr Team, wenn Konversationen bewertet werden oder die Zustellung einer Nachricht fehlschlägt
Tipp: Webhooks sind ab dem Plus-Abonnement verfügbar — Plus umfasst 1 Webhook, Expert umfasst 3 und Ultimate bietet ein individuelles Limit. Abonnements vergleichen →
Einen Webhook erstellen
Die Einrichtung eines Webhooks in Ihrem Smartsupp-dashboard erfordert nur wenige Schritte:
1. Öffnen Sie Einstellungen und navigieren Sie zum Bereich Webhooks .
2. Klicken Sie, um einen neuen Webhook hinzuzufügen, und geben Sie Ihre Endpunkt-URL ein — die Adresse, an die Smartsupp Ereignisdaten sendet.
3. Wählen Sie die Ereignisse aus, die Sie empfangen möchten (die vollständige Liste finden Sie im nächsten Abschnitt).
4. Speichern Sie den Webhook. Ab diesem Zeitpunkt werden die ausgewählten Ereignisse als HTTP-POST-Anfragen mit JSON-Nutzdaten zugestellt.
Hinweis: Zuvor konfigurierte Webhooks funktionieren weiterhin wie gewohnt. Wir arbeiten daran, alle bestehenden Webhooks im neuen dashboard-Bereich sichtbar und verwaltbar zu machen.
⚠️ Haben Sie bereits früher Webhooks erstellt? Ältere Webhooks werden in diesem Bereich noch nicht angezeigt — sie funktionieren weiterhin wie bisher. Wir führen das alte und das neue System zusammen, damit sich alles an einem Ort verwalten lässt.
Verfügbare Ereignisse
Smartsupp kann Ihren Endpunkt über Ereignisse aus drei Kategorien benachrichtigen. Wählen Sie nur die Ereignisse aus, die Ihr Workflow tatsächlich benötigt — so wird Ihr Endpunkt weniger belastet und unnötiger Datenverkehr vermieden.
Kontakte
contact.createdcontact.updatedcontact.acquiredcontact.bannedcontact.unbanned
Konversationen
conversation.openedconversation.closedconversation.closed_by_contactconversation.ratedconversation.agent_assignedconversation.agent_unassignedconversation.agent_joinedconversation.agent_leftconversation.agent_repliedconversation.bot_repliedconversation.contact_repliedconversation.message_deliveredconversation.message_delivery_failed
Besucher
visitor.connectedvisitor.disconnectedvisitor.updatedvisitor.typingvisitor.triggeredvisitor.replied
Weiterführende Ressourcen: Smartsupp-Entwicklerdokumentation — vollständige JSON-Nutzdatenschemas für jeden Ereignistyp.
Ihren Webhook testen
Nutzen Sie vor dem produktiven Einsatz die integrierte Testfunktion, um zu prüfen, ob Ihr Endpunkt erreichbar ist und Ihr Szenario in Make oder n8n korrekt eingerichtet ist.
Klicken Sie in Ihren Webhook-Einstellungen im dashboard auf Test senden. Smartsupp sendet Beispielnutzdaten an Ihre Endpunkt-URL. Prüfen Sie in Ihrem empfangenden Dienst, ob die Daten im erwarteten Format angekommen sind.
Tipp: In Make muss Ihr Szenario aktiv sein und auf eingehende Daten warten, bevor Sie den Test senden. Stellen Sie in n8n den Webhook-Knoten auf seine Produktions-URL um und stellen Sie sicher, dass der Workflow aktiv ist.
Zustellung, Wiederholungsversuche und Sicherheit
Smartsupp ist darauf ausgelegt, Webhook-Ereignisse zuverlässig zuzustellen, auch wenn Ihr Endpunkt vorübergehend nicht verfügbar ist.
Format — alle Ereignisse werden als HTTP-POST-Anfragen mit einem JSON-Body gesendet, der das Ereignis und seine Daten beschreibt
Antwort — Ihr Endpunkt sollte so schnell wie möglich mit einem HTTP-Statuscode 2xx antworten; langsame Antworten können Wiederholungsversuche verzögern
Wiederholungsversuche — wenn die Zustellung fehlschlägt, versucht Smartsupp es bis zu 3 Tage lang mit zunehmenden Wartezeiten erneut
Automatische Deaktivierung — Endpunkte, bei denen dauerhaft Fehler auftreten, werden automatisch deaktiviert; Sie können sie jederzeit im dashboard wieder aktivieren
Sicherheit — jede Webhook-Anfrage ist signiert, damit Sie überprüfen können, ob sie tatsächlich von Smartsupp stammt; unter docs.smartsupp.com finden Sie Einzelheiten zur Signaturprüfung
Hinweis: Wenn Ihr Endpunkt aufgrund wiederholter Fehler deaktiviert wurde, aktivieren Sie ihn unter Einstellungen → Webhooks erneut, nachdem Sie das zugrunde liegende Problem behoben haben. Smartsupp sendet dann sofort wieder Ereignisse.
Smartsupp mit Make oder n8n verbinden
Die Verbindung von Smartsupp mit einer Automatisierungsplattform erfolgt in vier Schritten. Der Ablauf ist für Make und n8n gleich — nur der Trigger-Knoten unterscheidet sich.
1. Fügen Sie in Makeeinen Trigger Webhooks → Custom webhook hinzu und kopieren Sie die generierte URL. Fügen Sie in n8neinen Webhook -Trigger-Knoten hinzu und kopieren Sie seine Produktions-URL.
2. Gehen Sie in Smartsupp zu Einstellungen → Webhooks, erstellen Sie einen neuen Webhook und fügen Sie die kopierte URL ein.
3. Wählen Sie die benötigten Ereignisse aus und speichern Sie den Webhook.
4. Klicken Sie auf Test senden , damit Make oder n8n die Datenstruktur erfasst — bauen Sie anschließend den Rest Ihres Szenarios oder Workflows darauf auf.
Tipp: Aktivieren Sie in Make Ihr Szenario, bevor Sie den Test senden — andernfalls werden die Webhook-Daten nicht erfasst. Verwenden Sie in n8n die Produktions -URL (nicht die Test-URL), wenn Sie den Smartsupp-Webhook einrichten.
Wie geht es weiter?
Smartsupp REST API — entdecken Sie die vollständige API, um Smartsupp-Daten programmgesteuert zu lesen und zu schreiben.
Automatisierungen — richten Sie regelbasierte Automatisierungen ein, die direkt in Smartsupp ohne externes Tool ausgelöst werden.
Übersicht der Integrationen — sehen Sie sich alle verfügbaren nativen Integrationen mit CRMs, E-Commerce-Plattformen und weiteren Systemen an.
💡 Benötigen Sie weitere Hilfe? Kontaktieren Sie unser Support-Team — wir helfen Ihnen gerne!