Einrichtungsanleitung

Zendesk WhatsApp-Integration: die zwei ehrlichen Wege

Einrichtungsanleitung und importierbarer n8n-WorkflowZuletzt geprüft: Oktober 2026

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. 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. 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. 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. 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. 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. 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.

Die Antwort, die der Workflow für einen öffentlichen Kommentar sendet
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)

Häufige Fragen

Hat Zendesk einen eigenen WhatsApp-Kanal?

Ja, auf der Business API aufgebaut: offiziell und integriert, aber mit separater Nummer, Regeln für Nachrichtenvorlagen, Gebühren pro Nachricht und ohne Unterstützung für Gruppen. Diese Seite beschreibt die Alternative: WhatsApp in Spun auf deiner bisherigen Nummer behalten und Zendesk-Tickets über einen n8n-Workflow erstellen.

Kann eine WhatsApp-Nachricht automatisch ein Zendesk-Ticket erstellen?

Ja. Mit dem Workflow wird jede WhatsApp-Einzelunterhaltung zu einem Zendesk-Ticket für einen Anfragenden, der anhand der Telefonnummer gefunden oder angelegt wird, und spätere Nachrichten landen im selben Ticket.

Können Agenten aus Zendesk heraus auf WhatsApp antworten?

Ja. Ein öffentlicher Kommentar am Ticket geht auf WhatsApp von deiner echten Nummer an den Kunden. Antworten aus dem Spun-Posteingang landen als interne Notizen im Ticket, sodass beide Seiten antworten können.

Welcher Weg ist günstiger?

Beim Weg über Spun fallen keine Business-API-Gebühren pro Nachricht an. Jedes an den Workflow zugestellte Ereignis verbraucht KI-Tokens aus deinem Spun-Plan, und wie das bei der Nutzung als Helpdesk abgerechnet wird, wird noch geprüft. Beim eigenen Kanal von Zendesk kommen Business-API-Gebühren pro Unterhaltung zu den Preisen von Zendesk hinzu.

WhatsApp-Support auf deiner eigenen Nummer

Spun macht aus deiner bisherigen WhatsApp-Nummer einen gemeinsamen Support-Posteingang mit Warteschlangen, Zuweisung und KI-Zusammenfassungen, dazu die Webhooks und die API, die dieser Workflow nutzt. Kostenloser Test.

Kostenlos starten

Alle Integrationen ansehen