Es gibt zwei Wege, WhatsApp mit Zoho Desk zu nutzen. Zoho Desk bietet einen eigenen WhatsApp-Kanal über die WhatsApp Business API an. Das bedeutet eine bei der API registrierte Nummer, freigegebene Nachrichtenvorlagen für Nachrichten außerhalb des 24-Stunden-Fensters und Gebühren pro Nachricht. Der andere Weg lässt WhatsApp auf der Nummer, die deine Kunden schon nutzen, mit Spun als WhatsApp-Arbeitsbereich, und verbindet WhatsApp und Zoho Desk über einen Workflow in deinem eigenen n8n.
Diese Seite beschreibt den zweiten Weg. Jede WhatsApp-Unterhaltung wird zu einem Zoho-Desk-Ticket, spätere Nachrichten kommen als Kommentare hinzu, und ein öffentlicher Kommentar eines Agenten geht per WhatsApp an den Kunden zurück. Wenn dein gesamter Support schon in Zoho Desk läuft und dir die Preise der Business API passen, ist der eigene Kanal von Zoho die einfachere Wahl.
Was der WhatsApp-Zoho-Desk-Workflow macht
- Die erste Nachricht einer Unterhaltung erstellt ein Ticket in der Abteilung deiner Wahl, verknüpft mit einem Zoho-Desk-Kontakt, der über die Telefonnummer gefunden oder neu angelegt wird. Das Ticket speichert die Spun-Chat-ID in einem benutzerdefinierten Feld.
- Spätere Nachrichten werden dem offenen Ticket als öffentliche Kommentare hinzugefügt, mit Name und Nummer des Absenders davor. Medien kommen als Link an, der 24 Stunden gültig bleibt.
- Antworten, die dein Team aus dem Spun-Posteingang sendet, werden als private Notizen hinzugefügt. So sieht der Agent in Zoho Desk den ganzen Austausch, und beide Seiten können antworten.
- Ein öffentlicher Kommentar eines Agenten wird dem Kunden per WhatsApp als Text gesendet. Private Notizen und die eigenen Kommentare des Workflows werden nie gesendet.
- Archivierst du die Unterhaltung in Spun, wird das Ticket geschlossen, und das Zurückholen aus dem Archiv öffnet es wieder. Das Schließen in Zoho Desk kann die Unterhaltung auch in Spun archivieren, eine Option, die aus bleibt, bis du sie einschaltest.
Subject: WhatsApp: Hi, my order has not arrived yet
[WhatsApp] Maria Lopez (+15550142233): Hi, my order has not arrived yet
[Sent from Spun] Alex: Sorry about that, checking now.Einrichtung Schritt für Schritt
Du brauchst einen Zoho-Desk-Plan mit Webhooks (Zoho bietet sie in Professional und Enterprise an), eine n8n-Instanz, die Zoho Desk und Spun über HTTPS erreichen, und einen eigenen Zoho-Desk-Agenten für die Integration, zum Beispiel „WhatsApp (Spun)“. Die Einrichtungsanleitung listet jeden Wert auf und zeigt, wo du ihn findest.
- 1
Lege einen Zoho-API-Client an
Lege in der Zoho API Console einen Self Client an und füge in n8n ein OAuth2-Credential mit den Zoho-URLs für dein Rechenzentrum und den Berechtigungen (Scopes) aus der Einrichtungsanleitung hinzu.
- 2
Finde deine Zoho-IDs
Die Organisations-ID, die Abteilung, die WhatsApp-Tickets erhalten soll, und die ID des Integrationsagenten.
- 3
Füge zwei benutzerdefinierte Ticketfelder hinzu
Eins für die Spun-Chat-ID (Pflichtfeld) und eins für die Spun-Leitung (optional). Der Workflow braucht ihre API-Namen, nicht ihre Beschriftungen.
- 4
Importiere den Workflow
Öffne seinen Settings-Node und füge die Zoho-Werte, den Wert für den Ticketkanal und den Status ein, den dein Portal für offene Tickets nutzt.
- 5
Erstelle einen Spun-API-Schlüssel
„Einstellungen“, dann „Webhooks“, dann „API-Schlüssel verwalten“, mit der Berechtigung „Nachrichten senden“. Hake auch „Gespräche schließen & erneut öffnen“ an, wenn das Schließen in Zoho Desk die Unterhaltung in Spun archivieren soll.
- 6
Melde den Workflow bei Spun an
Lege einen Webhook für eingehende Nachrichten, ausgehende Nachrichten, geschlossene und wieder geöffnete Unterhaltungen an, mit der Payload-Vorlage auf raw, und füge sein Signatur-Secret in den Workflow ein.
- 7
Erstelle den Zoho-Desk-Webhook
Richte im Developer Space einen Webhook auf die Antwort-URL des Workflows ein, für neue Ticketkommentare in deiner Abteilung.
- 8
Sende eine Testnachricht
Schreib von einem anderen Telefon an die Nummer. In Zoho Desk erscheint ein Ticket; beantworte es mit einem öffentlichen Kommentar, und die Antwort kommt auf dem Telefon an.
Siehe auch: Doku: Zoho Desk über n8n, die vollständige Einrichtungsanleitung · WhatsApp + n8n: die API und die Webhooks dahinter
Was du vor dem Aufbau wissen solltest
- Gruppenchats werden übersprungen: Eine Gruppe hat keine Telefonnummer, die mit einem Kontakt oder einem Ticket verknüpft werden kann.
- Ein aktives Ticket pro Unterhaltung. Eine Nachricht nach dem Schließen des Tickets startet ein neues Ticket.
- Medien kommen als 24-Stunden-Link ins Ticket, nicht als Zoho-Anhang. Antworten aus Zoho Desk sind reiner Text; Anhänge an einem Agentenkommentar werden nicht weitergeleitet.
- Das Schließen in Zoho Desk archiviert die Unterhaltung in Spun erst, wenn du diese Option einschaltest und dem API-Schlüssel die Berechtigung „Gespräche schließen & erneut öffnen“ gibst.
- Jedes zugestellte Ereignis verbraucht KI-Tokens aus deinem Spun-Plan. Wie das für den Einsatz als Helpdesk abgerechnet wird, wird noch geprüft.
- Der Workflow merkt sich Tickets und Kontakte in n8n und bleibt so deutlich innerhalb der API-Limits von Zoho.
Siehe auch: Alle WhatsApp-Helpdesk-Integrationen · WhatsApp als eigenes Helpdesk