So verwenden Sie Zendesk Webhooks: Ein vollständiger Leitfaden für 2026

Webhooks sind eines der leistungsstärksten Automatisierungstools in Zendesk. Sie ermöglichen es Ihrer Support-Plattform, in Echtzeit mit anderen Systemen zu kommunizieren und Daten ohne manuellen Eingriff dorthin zu senden, wo sie benötigt werden.

Stellen Sie sich einen Webhook als einen Boten vor, der zwischen Apps läuft. Wenn in Zendesk etwas passiert (ein Ticket wird erstellt, ein Benutzer wird aktualisiert, eine Priorität ändert sich), überträgt der Webhook diese Informationen sofort an ein anderes System. Anstatt alle paar Minuten nach Updates zu suchen, werden Ihre Systeme benachrichtigt, sobald etwas passiert.

Dieser Leitfaden führt Sie durch alles, was Sie über Zendesk Webhooks wissen müssen: was sie sind, wie Sie sie einrichten und wie Sie sie effektiv einsetzen. Egal, ob Sie Zendesk mit Slack verbinden, ein CRM aktualisieren oder benutzerdefinierte Integrationen erstellen, Sie finden praktische Schritte, die Sie sofort befolgen können.

Wenn Sie nach Automatisierung ohne die technische Komplexität von Webhooks suchen, bieten Tools wie eesel AI native Zendesk-Integrationen, die Ihnen die schwere Arbeit abnehmen. Unser AI Agent kann Tickets autonom lösen, ohne dass ein Webhook eingerichtet werden muss. Wenn Sie jedoch die volle Kontrolle über Ihre Datenflüsse wünschen, sind Webhooks der richtige Weg.

Schritt 1: Zugriff auf den Webhooks-Bereich im Zendesk Admin Center (Zendesk Administrationszentrum)

Um zu beginnen, melden Sie sich bei Ihrem Zendesk-Konto an und navigieren Sie zum Admin Center (Administrationszentrum). Klicken Sie auf das Zahnradsymbol in der Seitenleiste und gehen Sie dann zu Apps und Integrationen > Webhooks. Weitere Informationen finden Sie in der offiziellen Zendesk-Webhook-Dokumentation.

Das Webhooks-Dashboard zeigt alle Ihre vorhandenen Webhooks, ihren Status (aktiv oder inaktiv) und wann sie zuletzt ausgelöst wurden. Wenn Sie zum ersten Mal hier sind, ist die Liste leer.

Nehmen Sie sich einen Moment Zeit, um sich mit der Oberfläche vertraut zu machen. Sie sehen Optionen zum Erstellen neuer Webhooks, zum Bearbeiten vorhandener Webhooks und zum Anzeigen von Aktivitätsprotokollen. Die Aktivitätsprotokolle sind besonders nützlich, wenn Sie später Probleme beheben.

Schritt 2: Einen neuen Webhook erstellen

Klicken Sie auf die Schaltfläche Webhook erstellen, um den Einrichtungsvorgang zu starten. Sie sehen ein Formular mit mehreren Feldern, die Sie konfigurieren können.

Benennen Sie Ihren Webhook mit einem aussagekräftigen Namen. Sie werden es sich später danken, wenn Sie mehrere Webhooks haben und sich daran erinnern müssen, was jeder einzelne tut. "Slack-Benachrichtigungen für dringende Tickets" ist besser als "Webhook 1".

Wählen Sie Ihre Verbindungsmethode. Zendesk bietet zwei Möglichkeiten, Webhooks zu verbinden:

1. Auslöser (Trigger) oder Automatisierung – der Webhook wird ausgelöst, wenn bestimmte Ticketbedingungen erfüllt sind (z. B. wenn ein Ticket mit hoher Priorität erstellt wird)
2. Zendesk-Ereignisse – der Webhook abonniert Systemereignisse (z. B. wenn ein Benutzer erstellt oder aktualisiert wird)

Der Hauptunterschied? Triggerbasierte Webhooks geben Ihnen eine detaillierte Kontrolle darüber, wann sie ausgelöst werden. Ereignisbasierte Webhooks werden für jede Instanz dieses Ereignistyps ausgelöst, ohne Filterung auf Zendesk-Ebene.

Wichtig: Sobald Sie einen Webhook erstellt haben, können Sie seine Verbindungsmethode nicht mehr ändern. Wenn Sie mit einem triggerbasierten Webhook beginnen, bleibt er immer triggerbasiert. Wählen Sie sorgfältig basierend auf Ihrem Anwendungsfall aus.

Geben Sie Ihre Endpunkt-URL ein – dies ist der Ort, an den Zendesk die Webhook-Daten sendet. Zum Testen können Sie einen Dienst wie webhook.site verwenden, um die Payloads anzuzeigen. Für die Produktion sollte dies Ihr tatsächlicher Integrationsendpunkt sein.

Schritt 3: Anforderungseinstellungen konfigurieren

Jetzt konfigurieren Sie, wie der Webhook Daten an Ihren Endpunkt sendet.

Wählen Sie die HTTP-Methode basierend darauf aus, was Ihr Endpunkt erwartet:

• POST – am häufigsten zum Erstellen von Ressourcen oder zum Senden von Daten
• PUT/PATCH – zum Aktualisieren vorhandener Ressourcen
• GET – zum Abrufen von Daten (selten bei Webhooks verwendet)
• DELETE – zum Entfernen von Ressourcen

Wenn Sie eine Verbindung zu Zendesk-Ereignissen herstellen (nicht zu Triggern), müssen Sie POST verwenden. Ereignisabonnements unterstützen keine anderen HTTP-Methoden.

Wählen Sie Ihr Anfrageformat:

• JSON – der Standard für moderne APIs, menschenlesbar und weit verbreitet
• XML – älteres Format, das noch von einigen Enterprise-Systemen verwendet wird
• Form-encoded – einfache Schlüssel-Wert-Paare, nützlich für grundlegende Integrationen

Auch hier gilt: Ereignisbasierte Webhooks erfordern JSON. Nur triggerbasierte Webhooks bieten Ihnen Formatflexibilität.

Richten Sie die Authentifizierung ein. Die meisten Produktionsendpunkte erfordern eine Form der Authentifizierung. Zendesk unterstützt:

• Bearer-Token – Zendesk sendet einen Authorization: Bearer <token>-Header
• Basic Auth – Benutzername und Passwort, die in der Anfrage codiert sind
• API-Schlüssel – benutzerdefinierter Header mit Ihrem API-Schlüssel
• Keine – nur zum Testen oder für öffentliche Endpunkte

Für die Bearer-Token-Authentifizierung fügen Sie Ihr Token in das Feld ein. Zendesk übernimmt die Header-Formatierung für Sie. Wenn Sie einen benutzerdefinierten Header für API-Schlüssel verwenden, fügen Sie ihn im Abschnitt für benutzerdefinierte Header hinzu.

Schritt 4: Testen Sie Ihren Webhook

Bevor Sie Ihren Webhook speichern, testen Sie ihn, um sicherzustellen, dass alles funktioniert.

Klicken Sie auf Webhook testen, um das Testfenster zu öffnen. Sie sehen eine Beispiel-Payload, die Zendesk senden würde, zusammen mit Optionen zum Anpassen der Testdaten.

Klicken Sie auf Test senden und achten Sie auf die Antwort. Ein erfolgreicher Test zeigt ein grünes Häkchen mit einem HTTP-Statuscode der Ebene 200. Wenn Sie Fehler sehen, überprüfen Sie:

• Ist Ihre Endpunkt-URL korrekt und zugänglich?
• Ist die Authentifizierung richtig konfiguriert?
• Erwartet Ihr Endpunkt das richtige Anfrageformat?

Die Webhook-Aktivitätsprotokolle sind Ihr bester Freund bei der Fehlersuche. Gehen Sie zu Admin Center > Webhooks > [Ihr Webhook] > Aktivität, um Zustellversuche, Antwortcodes und Fehlermeldungen anzuzeigen.

Häufige Probleme sind:

• 401/403-Fehler – Authentifizierungsprobleme, überprüfen Sie Ihre Token
• 404-Fehler – Endpunkt-URL ist falsch oder der Dienst ist ausgefallen
• 500-Fehler – Ihr Endpunkt stürzt ab, überprüfen Sie Ihre Serverprotokolle
• Timeouts – Ihr Endpunkt ist zu langsam, um zu antworten (Zendesk wartet 10 Sekunden)

Sobald Ihr Test bestanden ist, klicken Sie auf Erstellen, um den Webhook zu speichern.

Schritt 5: Mit Triggern oder Ereignissen verbinden

Ihr Webhook wurde erstellt, aber er tut nichts, bis Sie ihn mit einem Auslöser (Trigger), einer Automatisierung oder einem Ereignisabonnement verbinden.

Für triggerbasierte Webhooks:

1. Gehen Sie zu Admin Center > Objekte und Regeln > Auslöser (oder Automatisierungen)
2. Erstellen Sie einen neuen Auslöser oder bearbeiten Sie einen vorhandenen
3. Legen Sie Ihre Bedingungen fest (z. B. "Priorität ist hoch" UND "Status ist neu")
4. Wählen Sie unter Aktionen die Option Aktiven Webhook benachrichtigen und wählen Sie Ihren Webhook aus
5. Konfigurieren Sie die JSON-Payload mit Zendesk-Platzhaltern wie {{ticket.id}}, {{ticket.requester.email}} oder {{ticket.subject}}

Für ereignisbasierte Webhooks:

1. Bearbeiten Sie Ihren Webhook
2. Wählen Sie unter Abonnements die Ereignisse aus, die Sie abonnieren möchten
3. Verfügbare Ereignisse umfassen Ticketereignisse, Benutzerereignisse, Organisationsereignisse und mehr
4. Speichern Sie Ihre Änderungen

Denken Sie daran: Ereignisbasierte Webhooks werden für jede Instanz dieses Ereignisses ausgelöst. Wenn Sie "Ticket erstellt" abonnieren, erhalten Sie einen Webhook für jedes einzelne Ticket. Stellen Sie sicher, dass Ihr Endpunkt das Volumen verarbeiten kann.

Häufige Anwendungsfälle für Zendesk Webhooks

Sobald Sie die Grundlagen verstanden haben, werden Sie überall Webhook-Möglichkeiten sehen. Hier sind einige der häufigsten Arten, wie Teams Zendesk Webhooks verwenden:

Slack-Benachrichtigungen für dringende Tickets

Wenn ein Ticket mit hoher Priorität eingeht, posten Sie eine Nachricht in Ihrem #support-urgent-Kanal mit Ticketdetails und einem direkten Link. Dies hält alle auf dem Laufenden, ohne dass Zendesk ständig überprüft werden muss.

Aktualisieren externer CRM-Systeme

Wenn ein Benutzer in Zendesk erstellt oder aktualisiert wird, synchronisieren Sie diese Daten mit Salesforce, HubSpot oder Ihrem benutzerdefinierten CRM. Dies hält die Kundendaten über alle Plattformen hinweg konsistent.

Senden von SMS-Benachrichtigungen

Verbinden Sie Zendesk mit einem SMS-Dienst wie 8x8 oder Twilio, um Kunden proaktiv über ihre Tickets zu informieren.

Data-Warehouse-Protokollierung

Senden Sie alle Ticketereignisse an ein Data Warehouse wie Snowflake oder BigQuery zur Analyse. Dies gibt Ihnen eine vollständige Historie der Supportaktivitäten für Berichterstattung und maschinelles Lernen.

Automatisierte Ticketaktionen über interne API-Aufrufe

Verwenden Sie Webhooks, um die eigene API von Zendesk für komplexe Ticketaktualisierungen aufzurufen, die Auslöser nicht verarbeiten können. Zum Beispiel das Kopieren von Daten zwischen benutzerdefinierten Feldern oder das Aktualisieren verwandter Tickets.

Automatisierung von Datenschutz und Compliance

Verbinden Sie sich mit Datenschutzplattformen wie Transcend, um Datenbetroffenenanfragen automatisch zu bearbeiten, wenn Kunden Ihrem Support-Team eine E-Mail senden.

Lokales Testen von Webhooks mit ngrok

Erstellen Sie einen Webhook-Endpunkt auf Ihrem lokalen Rechner? Sie benötigen eine Möglichkeit, ihn dem Internet zugänglich zu machen, damit Zendesk ihn erreichen kann. Hier kommt ngrok ins Spiel.

ngrok erstellt einen sicheren Tunnel von einer öffentlichen URL zu Ihrem Localhost. So richten Sie es ein:

1. Ngrok installieren – von ngrok.com herunterladen und mit Ihrem Authtoken authentifizieren
2. Starten Sie Ihren lokalen Server – führen Sie Ihren Webhook-Endpunkt auf Localhost aus (normalerweise Port 3000 oder 8080)
3. Starten Sie ngrok – führen Sie ngrok http 3000 aus (ersetzen Sie 3000 durch Ihren Port)
4. Kopieren Sie die ngrok-URL – sie sieht aus wie https://1a2b-3c4d.ngrok.app
5. Verwenden Sie diese URL in Zendesk – fügen Sie sie als Ihren Webhook-Endpunkt ein

Wenn Zendesk Webhooks sendet, werden diese über ngrok an Ihren lokalen Rechner weitergeleitet. Sie können die vollständige Anfrage-Payload, Header und Antwort im ngrok-Dashboard oder -Terminal überprüfen.

Dieses Setup ist perfekt für Entwicklung und Tests. Denken Sie daran: Ngrok-URLs ändern sich jedes Mal, wenn Sie ngrok neu starten (es sei denn, Sie haben einen kostenpflichtigen Plan mit reservierten Domains). Aktualisieren Sie Ihre Zendesk-Webhook-Konfiguration, wenn sich Ihre ngrok-URL ändert.

Fehlerbehebung bei häufigen Problemen

Auch bei sorgfältiger Einrichtung schlagen Webhooks manchmal fehl. So diagnostizieren und beheben Sie häufige Probleme:

Webhook wird nicht ausgelöst

• Überprüfen Sie Ihre Auslöserbedingungen – werden sie tatsächlich erfüllt?
• Stellen Sie sicher, dass der Webhook aktiv und nicht pausiert ist
• Sehen Sie sich die Webhook-Aktivitätsprotokolle auf Zustellversuche an
• Testen Sie für triggerbasierte Webhooks den Auslöser separat

Authentifizierungsfehler

• Überprüfen Sie Ihr Bearer-Token oder Ihren API-Schlüssel
• Stellen Sie sicher, dass das Token nicht abgelaufen ist
• Stellen Sie sicher, dass Sie die richtige Authentifizierungsmethode für Ihren Endpunkt verwenden
• Überprüfen Sie, ob Ihr Endpunkt die Authentifizierung in einem bestimmten Header-Format erwartet

Ratenbegrenzung

Testkonten sind auf 60 Webhook-Aufrufe pro Minute beschränkt. Wenn Sie dies überschreiten, blockiert Zendesk vorübergehend zusätzliche Anfragen. Lösungen:

• Upgrade auf einen kostenpflichtigen Zendesk-Plan
• Stapeln Sie Ihre Webhook-Aufrufe
• Verwenden Sie Auslöserbedingungen, um unnötiges Auslösen von Webhooks zu reduzieren

Payload-Formatfehler

• Stellen Sie sicher, dass Ihr Endpunkt das Format erwartet, das Sie senden (JSON vs. XML)
• Überprüfen Sie, ob die erforderlichen Felder in Ihrer Payload enthalten sind
• Testen Sie mit einem Tool wie Postman, um zu überprüfen, ob Ihr Endpunkt unabhängig funktioniert

Wiederholungslogik und Zustellungsfehler

Zendesk wiederholt fehlgeschlagene Webhooks automatisch mit exponentiellem Backoff. Wenn Ihr Endpunkt einen 5xx-Fehler zurückgibt oder ein Timeout auftritt, versucht Zendesk die Zustellung in den nächsten Stunden mehrmals. Überprüfen Sie Ihre Endpunktprotokolle, um zu sehen, ob Wiederholungsversuche Ihren Server treffen.

Optimierung der Support-Automatisierung mit eesel AI

Webhooks geben Ihnen Flexibilität, erfordern aber auch technische Einrichtung und laufende Wartung. Wenn Sie nach Automatisierung suchen, ohne Code zu schreiben oder Endpunkte zu verwalten, bietet eesel AI einen anderen Ansatz. Sie können auch unseren AI Copilot zum Entwerfen von Antworten oder AI Triage für automatisiertes Ticket-Routing erkunden.

Anstatt Webhook-Integrationen zu erstellen, laden Sie eesel AI als KI-Teamkollegen in Ihr Team ein. Es verbindet sich direkt mit Zendesk und lernt aus Ihren vergangenen Tickets, Help Center-Artikeln und Makros. Innerhalb weniger Minuten versteht es Ihr Geschäft und kann mit der Bearbeitung von Tickets beginnen.

Sie können damit beginnen, dass eesel AI Antworten für Ihre Agenten entwirft, die diese überprüfen können. Wenn es sich bewährt hat, können Sie es so einstellen, dass es Antworten direkt sendet, bestimmte Tickettypen bearbeitet oder rund um die Uhr arbeitet. Der Fortschritt wird gesteuert – Sie entscheiden, wann Sie den Umfang basierend auf der tatsächlichen Leistung erweitern.

Für Teams, die bereits Webhooks verwenden, kann eesel AI Ihre bestehende Automatisierung ergänzen. Verwenden Sie Webhooks für System-zu-System-Integrationen und lassen Sie eesel AI die kundenorientierte Konversationsebene verwalten. Zusammen schaffen sie einen leistungsstarken Automatisierungs-Stack, der sowohl technische Workflows als auch menschenähnliche Support-Interaktionen abdeckt.

Wenn Sie mehr Zeit mit der Wartung von Webhook-Integrationen verbringen als davon zu profitieren, könnte es sich lohnen zu prüfen, ob ein KI-nativer Ansatz besser zu Ihren Bedürfnissen passt.