Es gibt zwei Wege, WhatsApp mit Freshdesk zu nutzen. Freshdesk 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 Freshdesk über einen Workflow in deinem eigenen n8n.
Diese Seite beschreibt den zweiten Weg, den WhatsApp-Freshdesk-Workflow: Jede 1:1-Unterhaltung wird zu einem Freshdesk-Ticket, spätere Nachrichten werden ihm hinzugefügt, und die öffentliche Notiz eines Agenten geht per WhatsApp an den Kunden zurück. Wenn dein gesamter Support schon in Freshdesk läuft und dir die Preise der Business API passen, ist der eigene Kanal von Freshdesk die einfachere Wahl.
Was der WhatsApp-Freshdesk-Workflow macht
- Jede 1:1-Unterhaltung auf WhatsApp wird zu einem Ticket mit der Quelle Chat, den Tags spun und whatsapp und der Spun-Chat-ID in einem benutzerdefinierten Feld.
- Der Anfragende wird über die Telefonnummer, dann über die Mobilnummer, im internationalen Format einem Freshdesk-Kontakt zugeordnet. Gibt es keinen Treffer, wird ein Kontakt nur mit Name und Nummer angelegt. Bestehende Kontakte werden nie bearbeitet, und es wird nie eine E-Mail-Adresse hinzugefügt.
- Spätere Nachrichten werden als öffentliche Notizen auf der Kundenseite des Verlaufs hinzugefügt, mit Name und Nummer des Absenders davor. Ein Ticket im Status Ausstehend oder Gelöst geht zurück auf Offen.
- Agenten antworten mit einer öffentlichen Notiz, und die Notiz erreicht den Kunden per WhatsApp als Text. Private Notizen bleiben intern.
- Antworten, die dein Team aus dem Spun-Posteingang sendet, erscheinen als private Notizen, sodass beide Seiten antworten können.
- Archivieren in Spun schließt das Ticket (oder löst es, je nach Einstellung), und das Zurückholen aus dem Archiv öffnet es wieder. Das Schließen in Freshdesk kann die Unterhaltung auch in Spun archivieren, eine Option, die aus bleibt, bis du sie einschaltest.
- Steht ein Ticket auf Geschlossen, eröffnet die nächste Nachricht ein neues Ticket, das die Nummer des vorherigen Tickets nennt.
Die API von Freshdesk kennt keine Ticketquelle WhatsApp, daher nutzen diese Tickets die Quelle Chat plus das Tag whatsapp. Berichte, die auf den eigenen WhatsApp-Kanal von Freshdesk filtern, enthalten sie nicht; filtere stattdessen nach dem Tag.
Antworte mit einer öffentlichen Notiz, nicht mit dem Button „Reply“
Bei einem WhatsApp-Ticket antworten Agenten über „Add note“ und stellen die Notiz auf öffentlich. Der Button „Reply“ sendet eine E-Mail, und ein Kunde, den der Workflow angelegt hat, hat keine E-Mail-Adresse. Eine öffentliche Notiz ist das, was die Automatisierungsregel an den Workflow sendet, und das, was den Kunden per WhatsApp erreicht.
Einrichtung Schritt für Schritt
Für die Synchronisierung in beide Richtungen brauchst du Freshdesk Growth oder höher, weil Agentennotizen den Workflow über eine Automatisierungsregel erreichen, die einen Webhook aufruft. In Free und Sprout werden WhatsApp-Nachrichten trotzdem zu Tickets, aber Notizen können nicht zurückgesendet werden. Außerdem brauchst du einen Freshdesk-Admin, einen Integrationsagenten wie „Spun WhatsApp“ mit eigenem API-Schlüssel und eine n8n-Instanz, die Freshdesk und Spun über HTTPS erreichen.
- 1
Lege das Credential für den API-Schlüssel an
Melde dich als Integrationsagent an, kopiere den API-Schlüssel aus den Profileinstellungen und füge ihn in n8n als Credential vom Typ Basic Auth hinzu.
- 2
Füge ein Ticketfeld „Spun chat id“ hinzu
Ein einzeiliges Textfeld, weder für Agenten noch zum Schließen verpflichtend, dazu ein optionales Feld „Spun line“.
- 3
Importiere den Workflow
Öffne seinen Settings-Node und füge deine Freshdesk-URL, den API-Namen des Chat-ID-Felds und die ID des Integrationsagenten ein.
- 4
Wähle Antwort-URL und Secret
Gib dem Antwort-Node einen langen zufälligen Pfad, lege eine zweite zufällige Zeichenfolge als Freshdesk-Secret fest und aktiviere den Workflow.
- 5
Lege die Automatisierungsregel an
Im Tab „Ticket Updates“ eine Regel, die läuft, wenn ein Agent eine Notiz zu einem Ticket mit dem Tag spun hinzufügt, und die die Antwort-URL des Workflows mit dem Header X-Spun-Secret aufruft.
- 6
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 Freshdesk die Unterhaltung in Spun archivieren soll.
- 7
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.
- 8
Sende eine Testnachricht
Schreib von einem anderen Telefon an die Nummer. In Freshdesk erscheint ein Ticket; beantworte es mit einer öffentlichen Notiz, und die Antwort kommt auf dem Telefon an. Prüfe bei diesem ersten Test die E-Mail-Benachrichtigungen an Anfragende.
Siehe auch: Doku: Freshdesk über n8n, die vollständige Einrichtungsanleitung · WhatsApp + n8n: die API und die Webhooks dahinter
Was du vor dem Aufbau wissen solltest
- Freshdesk signiert seine Webhooks nicht, daher prüft der Workflow bei jeder Antwort einen Header mit einem gemeinsamen Secret. Die eigenen Ereignisse von Spun sind mit HMAC signiert.
- Medien kommen als 24 Stunden gültiger Link ins Ticket, nicht als Anhang. Anhänge an einer Agentennotiz werden nicht weitergeleitet.
- Gruppenchats werden übersprungen.
- Das API-Limit von Freshdesk gilt pro Konto und Minute (Growth 100, Pro 400, Enterprise 700) und wird mit deinen anderen Apps geteilt. Eine neue Unterhaltung braucht bis zu 5 Aufrufe, eine spätere Nachricht 2 oder 3. Freshdesk erlaubt 1.000 Webhook-Aufrufe pro Stunde und stellt den Rest in eine Warteschlange.
- Jedes zugestellte Ereignis verbraucht KI-Tokens aus deinem Spun-Plan. Wie das für den Einsatz als Helpdesk abgerechnet wird, wird noch geprüft.
Siehe auch: Alle WhatsApp-Helpdesk-Integrationen · WhatsApp als eigenes Helpdesk