Es gibt zwei ehrliche Wege, WhatsApp mit Zendesk zum Laufen zu bringen, und sie unterscheiden sich stark. Weg eins ist der eigene WhatsApp-Kanal von Zendesk: offiziell und auf der Business API aufgebaut, das heißt eine separate Nummer, Freigaben für Nachrichtenvorlagen, Gebühren pro Nachricht und keine WhatsApp-Gruppen. Weg zwei lässt WhatsApp auf der Nummer, die du schon nutzt, mit Spun als WhatsApp-Arbeitsbereich, und ein WhatsApp-Zendesk-Workflow in deinem eigenen n8n macht aus jeder Unterhaltung ein Zendesk-Ticket.
Diese Seite beschreibt Weg zwei und sagt ehrlich, wann Weg eins besser passt: Wenn dein gesamter Support in Zendesk läuft und du WhatsApp als einen weiteren Ticket-Kanal zu API-Konditionen willst, nimm den Kanal von Zendesk. Wenn WhatsApp dein wichtigster Kundenkanal ist und Zendesk nur ein System unter mehreren, dient es deinen Kunden meist besser, WhatsApp auf deiner echten Nummer mit einem Team-Posteingang zu behalten.
1. WhatsApp-Tickets in Zendesk: was der Workflow macht
Jede WhatsApp-Einzelunterhaltung auf der Leitung wird zu einem Zendesk-Ticket, ohne dass du vorher ein Label vergeben musst. Spätere Nachrichten landen im selben Ticket, und ein öffentlicher Kommentar eines Agenten geht auf WhatsApp an den Kunden zurück.
- Der Anfragende ist ein Zendesk-Benutzer, den der Workflow anhand der Telefonnummer des Kunden findet oder anlegt, und das Ticket wird für diesen Benutzer erstellt.
- Öffentliche Kommentare von Agenten in Zendesk gehen als Text auf WhatsApp an den Kunden, von deiner eigenen Nummer. Interne Notizen (private Kommentare) bleiben intern.
- Antworten, die dein Team aus dem Spun-Posteingang sendet, werden zu internen Notizen am Ticket, sodass beide Seiten antworten können und das Ticket den gesamten Austausch enthält.
- Archivierst du die Unterhaltung in Spun, wird das Ticket gelöst, und holst du sie aus dem Archiv zurück, wird es wieder geöffnet. Auch das Lösen in Zendesk kann die Unterhaltung in Spun archivieren; diese Option ist aus, bis du sie einschaltest. Der Workflow sendet dem Kunden in keinem der beiden Fälle eine Statusnachricht.
- Jede Antwort wird mit der ID des Zendesk-Kommentars als Idempotenzschlüssel gesendet, sodass eine wiederholte Antwort nicht doppelt rausgeht.
Gruppenchats werden übersprungen. Medien kommen als Link ins Ticket, der 24 Stunden gültig bleibt.
2. So richtest du es ein
Du brauchst einen Zendesk-Admin, der Webhooks, Auslöser und einen OAuth-Client anlegen kann, einen Integrations-Agenten wie „Spun WhatsApp“ und eine n8n-Instanz, die Zendesk und Spun über HTTPS erreichen können. Die Einrichtungsanleitung nennt jeden Wert und wo du ihn findest.
- 1
OAuth-Client anlegen
Melde dich als Integrations-Agent an, füge im Zendesk Admin Center einen OAuth-Client hinzu und lege in n8n ein OAuth2-Credential mit dem Grant-Typ Client Credentials an. Ein API-Token ist die Ausweichlösung.
- 2
Workflow importieren
Öffne seinen Settings-Knoten und füge deine Zendesk-URL und die Benutzer-ID des Integrations-Agenten ein. Eine Gruppe, eine Marke und ein Ticketfeld „Spun line“ sind optional.
- 3
Zendesk-Webhook und Antwort-Auslöser anlegen
Ein Webhook, der auf die Antwort-URL des Workflows zeigt, und ein Auslöser, der ihn aufruft, wenn ein Ticket mit dem Tag spun einen öffentlichen Kommentar bekommt. Füge das Signatur-Secret des Webhooks in den Workflow ein.
- 4
Spun-API-Schlüssel erstellen
„Einstellungen“, dann „Webhooks“, dann „API-Schlüssel verwalten“, mit der Berechtigung zum Senden von Nachrichten. Hake auch „Gespräche schließen & erneut öffnen“ an, wenn das Lösen in Zendesk die Unterhaltung in Spun archivieren soll.
- 5
Webhook-Abo für den Workflow anlegen
Füge einen Webhook für eingehende Nachrichten, ausgehende Nachrichten, geschlossene und wiedereröffnete Unterhaltungen hinzu, mit dem „Payload-Format“ auf Raw, und füge sein Signatur-Secret in den Workflow ein.
- 6
Testnachricht senden
Schreib der Leitung von einem anderen Telefon aus. In Zendesk erscheint ein Ticket; antworte mit einem öffentlichen Kommentar, und die Antwort kommt auf dem Telefon an.
POST https://api.spun.com/api/integrations/send-message
Authorization: Bearer wap_YOUR_KEY
Content-Type: application/json
{
"to": "14155552671",
"text": "Thanks for waiting, your replacement ships today.",
"idempotency_key": "<Zendesk comment id>"
}Siehe auch: Doku: Zendesk über n8n, die vollständige Einrichtungsanleitung · WhatsApp + n8n: die API und die Webhooks dahinter
Was du vor dem Aufbau wissen solltest
- Das ist eine Brücke, keine Zusammenlegung der Kanäle: WhatsApp-Unterhaltungen liegen in Spun, Tickets in Zendesk, und der Workflow hält beide auf demselben Stand. Wenn du WhatsApp als Zendesk-Kanal mit eigener Nummer brauchst, ist das Weg eins, mit seinen Kosten und Grenzen.
- Es ist ein n8n-Workflow, den du importierst, keine App aus dem Zendesk Marketplace. Die Spun-Seite nutzt einen API-Schlüssel, die Zendesk-Seite einen OAuth-Client.
- Das Schließen aus Zendesk ruft die Endpunkte von Spun zum Schließen und Wiedereröffnen auf, die auf dem Schlüssel die Berechtigung „Gespräche schließen & erneut öffnen“ brauchen.
- Zendesk erlaubt 30 Aktualisierungen pro Ticket in 10 Minuten, 5 neue Benutzer pro Minute und 5.000 Kommentare pro Ticket. Die Spun-API erlaubt 60 Anfragen pro Minute und Schlüssel.
- Jedes zugestellte Ereignis verbraucht KI-Tokens aus deinem Spun-Plan. Wie das bei der Nutzung als Helpdesk abgerechnet wird, wird noch geprüft.
- Viele Teams merken, dass die Ticket-Ebene der optionale Teil war: Labels, Zuweisung und Aufgaben von Spun decken chatbasiertes Ticketing schon allein ab. Sieh dir die Seite zum WhatsApp-Helpdesk an.
Siehe auch: WhatsApp als Helpdesk selbst (ohne Zendesk) · Alle WhatsApp-Helpdesk-Integrationen · WhatsApp + Zapier & Make (die gesamte API)