Webhooks ermöglichen es Smartsupp, Echtzeit-Benachrichtigungen an eine URL Ihrer Wahl zu senden — sobald eine Konversation geöffnet wird, ein Kontakt erstellt oder eine Nachricht zugestellt wird, weiß Ihr System sofort davon. Dieser Artikel erklärt, was Webhooks sind, wie Sie sie im Dashboard einrichten und wie Sie sie mit Automatisierungsplattformen wie Make und n8n verbinden.

Wir haben den Artikel in mehrere Abschnitte unterteilt:

Wozu sind Webhooks gut?

Ein Webhook ist eine automatische HTTP-Nachricht, die Smartsupp an eine URL Ihrer Wahl sendet, sobald ein ausgewähltes Ereignis eintritt. Anstatt Änderungen abzufragen, werden die Daten in dem Moment an Ihre Tools übertragen, in dem etwas passiert.

Typische Anwendungsfälle sind:

Automatisierungsplattformen — Workflows in Make, n8n oder ähnlichen Tools auslösen, um Kontakte in ein CRM hinzuzufügen, Benachrichtigungen an Slack zu senden oder Leads in einer Tabelle zu protokollieren
Interne Systeme — Konversations- und Kontaktdaten in Echtzeit an Dashboards, Data Warehouses oder Ticketing-Systeme übermitteln
Benachrichtigungen — Ihr Team benachrichtigen, wenn Konversationen bewertet werden oder wenn die Zustellung von Nachrichten fehlschlägt

Tipp: Webhooks sind im Plus-Tarif und höher verfügbar — Plus enthält 1 Webhook, Expert 3 und Ultimate bietet ein individuelles Limit. Tarife vergleichen →

Webhook erstellen

Das Einrichten eines Webhooks erfordert nur wenige Schritte in Ihrem Smartsupp-Dashboard:

1. Öffnen Sie Einstellungen und navigieren Sie zum Abschnitt Webhooks.
2. Klicken Sie auf das Hinzufügen eines neuen Webhooks 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 (vollständige Liste im nächsten Abschnitt).
4. Speichern Sie den Webhook. Ab diesem Moment werden die ausgewählten Ereignisse als HTTP POST-Anfragen mit JSON-Nutzdaten zugestellt.

Hinweis: Zuvor konfigurierte Webhooks funktionieren weiterhin normal. Es wird daran gearbeitet, alle vorhandenen Webhooks im neuen Dashboard-Bereich sichtbar und verwaltbar zu machen.

Verfügbare Ereignisse

Smartsupp kann Ihren Endpunkt über Ereignisse in drei Kategorien benachrichtigen. Wählen Sie nur die Ereignisse aus, die Ihr Workflow tatsächlich benötigt — dies hält Ihren Endpunkt schlank und vermeidet unnötigen Datenverkehr.

Kontakte

contact.created
contact.updated
contact.acquired
contact.banned
contact.unbanned

Konversationen

conversation.opened
conversation.closed
conversation.closed_by_contact
conversation.rated
conversation.agent_assigned
conversation.agent_unassigned
conversation.agent_joined
conversation.agent_left
conversation.agent_replied
conversation.bot_replied
conversation.contact_replied
conversation.message_delivered
conversation.message_delivery_failed

Besucher

visitor.connected
visitor.disconnected
visitor.updated
visitor.typing
visitor.triggered
visitor.replied

Verwandte Ressourcen: Smartsupp-Entwicklerdokumentation — vollständige JSON-Payload-Schemas für jeden Ereignistyp.

Webhook testen

Verwenden Sie vor dem Live-Gang die integrierte Testfunktion, um sicherzustellen, dass Ihr Endpunkt erreichbar ist und Ihr Make- oder n8n-Szenario korrekt eingerichtet ist.

Klicken Sie in den Webhook-Einstellungen im Dashboard auf Test senden. Smartsupp sendet eine Beispielnutzlast an Ihre Endpunkt-URL. Überprüfen Sie Ihren empfangenden Dienst, um zu bestätigen, dass die Daten im erwarteten Format angekommen sind.

Tipp: In Make muss Ihr Szenario aktiv sein und empfangen, bevor Sie den Test senden. In n8n wechseln Sie den Webhook-Knoten zur Produktions-URL und stellen Sie sicher, dass der Workflow aktiv ist.

Zustellung, Wiederholungen 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-Text gesendet, der das Ereignis und seine Daten beschreibt
Antwort — Ihr Endpunkt sollte so schnell wie möglich mit einem 2xx HTTP-Statuscode antworten; langsame Antworten können Wiederholungsversuche verzögern
Wiederholungen — bei fehlgeschlagener Zustellung wiederholt Smartsupp mit zunehmenden Verzögerungen bis zu 3 Tage lang
Automatische Deaktivierung — dauerhaft fehlschlagende Endpunkte werden automatisch deaktiviert; Sie können sie jederzeit im Dashboard wieder aktivieren
Sicherheit — jede Webhook-Anfrage ist signiert, damit Sie überprüfen können, dass sie wirklich von Smartsupp stammt; Details zur Signaturverifizierung finden Sie unter docs.smartsupp.com

Hinweis: Wenn Ihr Endpunkt wegen wiederholter Fehler deaktiviert wurde, aktivieren Sie ihn in Einstellungen → Webhooks wieder, nachdem Sie das zugrunde liegende Problem behoben haben. Smartsupp nimmt sofort wieder die Ereignisübermittlung auf.

Smartsupp mit Make oder n8n verbinden

Die Verbindung von Smartsupp mit einer Automatisierungsplattform erfordert vier Schritte. Der Vorgang ist für Make und n8n gleich — nur der Trigger-Knoten unterscheidet sich.

1. Fügen Sie in Make einen Webhooks → Benutzerdefinierter Webhook-Trigger hinzu und kopieren Sie die generierte URL. Fügen Sie in n8n einen 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 erfassen — bauen Sie dann den Rest Ihres Szenarios oder Workflows darauf auf.

Tipp: Aktivieren Sie in Make Ihr Szenario, bevor Sie den Test senden — sonst werden die Webhook-Daten nicht erfasst. Verwenden Sie in n8n die Produktions-URL (nicht die Test-URL), wenn Sie den Smartsupp-Webhook einrichten.

Was kommt als Nächstes?

Smartsupp REST API — erkunden Sie die vollständige API, um Smartsupp-Daten programmatisch zu lesen und zu schreiben.
Automatisierungen — richten Sie regelbasierte Automatisierungen ein, die direkt in Smartsupp ausgeführt werden, ohne ein externes Tool.
Integrationsübersicht — sehen Sie alle verfügbaren nativen Integrationen mit CRMs, E-Commerce-Plattformen und mehr.

💡 Brauchen Sie weitere Hilfe? Kontaktieren Sie unser Support-Team — wir helfen Ihnen gerne!

Webhooks: Smartsupp mit Make, n8n und Ihren eigenen Tools verbinden