Es gibt zwei Wege, WhatsApp mit HubSpot Service Hub zu nutzen. HubSpot bietet in seinem Posteingang 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 erstellt HubSpot-Tickets über einen Workflow in deinem eigenen n8n.
Diese Seite beschreibt den zweiten Weg, für HubSpot-Tickets aus WhatsApp: Jede 1:1-Unterhaltung wird zu einem Ticket in der Pipeline deiner Wahl, jede Nachricht wird im Ticket und in der Kontakt-Timeline protokolliert, und Agenten antworten aus dem Ticket auf WhatsApp. Das läuft neben der HubSpot-CRM-Kontaktsynchronisierung von Spun, die Kontakte abgleicht und keine Tickets erstellt.
HubSpot-Tickets aus WhatsApp: Was der Workflow macht
- Jede 1:1-Unterhaltung auf WhatsApp wird zu einem HubSpot-Ticket in der Pipeline und dem Ticketstatus, die dein Admin festlegt. Gruppenchats werden übersprungen.
- Jede Nachricht wird im Ticket als WhatsApp-Kommunikation protokolliert und erscheint auch in der Timeline des Kontakts, wobei der Text nennt, wer schreibt.
- Antworten, die dein Team aus dem Spun-Posteingang sendet, werden ebenfalls im Ticket protokolliert, sodass beide Seiten antworten können.
- Archivieren in Spun verschiebt das Ticket in den geschlossenen Status, und das Zurückholen aus dem Archiv verschiebt es zurück in den offenen Status. Das Schließen in HubSpot kann die Unterhaltung auch in Spun archivieren, eine Option, die aus bleibt, bis du sie einschaltest.
[WhatsApp] Maria Lopez (+15550142233): Hi, my order has not arrived yet
[Sent from Spun] Alex: Sorry about that, checking now.
[Sent from HubSpot] It ships today, here is the tracking link.Antworten aus dem Ticket mit dem Feld Spun reply
Agenten antworten, indem sie Text in eine Eigenschaft Spun reply am Ticket eingeben und speichern. Innerhalb weniger Sekunden erreicht der Text den Kunden per WhatsApp, wird im Ticket protokolliert, und das Feld ist wieder leer. Konnte eine Antwort nicht gesendet werden, steht in einer Notiz am Ticket, warum.
Antworten sind reiner Text; Ticketanhänge werden nicht weitergeleitet. HubSpot-Notizen und -E-Mails bleiben intern. Alles, was in Spun reply geschrieben wird, wird gesendet, egal wer es schreibt. Halte diese Eigenschaft deshalb aus Massenbearbeitungen, Importen und HubSpot-Workflows heraus.
Neben der HubSpot-CRM-Kontaktsynchronisierung
Die HubSpot-CRM-Kontaktsynchronisierung von Spun ist für Kontakte zuständig, dieser Workflow für Tickets. Der Workflow nutzt einen eigenen HubSpot-Schlüssel und bearbeitet nie einen Kontakt. Ist die Kontaktsynchronisierung verbunden, legt er auch nie einen Kontakt an: Das Ticket eines ganz neuen Kunden wird verknüpft, sobald die Synchronisierung den Kontakt übertragen hat. Das passiert über „Jetzt synchronisieren“ oder ein zugeordnetes Label, nicht bei jeder Nachricht.
Siehe auch: WhatsApp + HubSpot CRM: die Kontaktsynchronisierung
Einrichtung Schritt für Schritt
Du brauchst HubSpot Service Hub, einen Benutzer, der Eigenschaften, Schlüssel und Webhook-Abonnements anlegen darf, eine n8n-Instanz, die HubSpot und Spun über HTTPS erreichen, und eine App für den Antwort-Webhook: eine ältere private App (Legacy Private App, lege sie vor dem 26. Oktober 2026 an, ab dann lässt HubSpot für bestehende Accounts keine neuen mehr zu) oder eine projektbasierte App, die mit der HubSpot CLI gebaut wird und einen Entwickler braucht.
- 1
Lege zwei Ticketeigenschaften an
Spun chat id (einzeiliger Text) und Spun reply (mehrzeiliger Text). Füge Spun reply der Seitenleiste des Tickets hinzu, damit Agenten das Feld sehen.
- 2
Lege einen Schlüssel für API-Aufrufe an
Einen Service-Schlüssel oder das Zugriffstoken deiner älteren privaten App, mit den Ticket- und Kontakt-Berechtigungen (Scopes) aus der Einrichtungsanleitung, in n8n als Credential vom Typ Header Auth gespeichert.
- 3
Importiere den Workflow
Führe einmal seinen Einrichtungshelfer aus, um deine Ticket-Pipelines und Ticketstatus aufzulisten, und kopiere die IDs in den Settings-Node.
- 4
Sag ihm, ob die Kontaktsynchronisierung läuft
Lass die Einstellung für die Kontaktsynchronisierung eingeschaltet, wenn die HubSpot-Kontaktsynchronisierung von Spun verbunden ist oder wenn du unsicher bist.
- 5
Abonniere mit der App die Ticketänderungen
Richte den Webhook der App auf die Antwort-URL des Workflows, mit einem Abonnement auf die Eigenschaft Spun reply, und füge das Client-Secret der App in den Workflow ein.
- 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 HubSpot 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 HubSpot erscheint ein Ticket; gib eine Antwort in Spun reply ein, speichere, und die Antwort kommt auf dem Telefon an.
Siehe auch: Doku: HubSpot Service Hub über n8n, die vollständige Einrichtungsanleitung · WhatsApp + n8n: die API und die Webhooks dahinter
Was du vor dem Aufbau wissen solltest
- HubSpot-Webhooks sind signiert, und der Workflow prüft die Signatur. Die eigenen Ereignisse von Spun sind mit HMAC signiert.
- Medien kommen als 24 Stunden gültiger Link ins Ticket, nicht als HubSpot-Datei.
- Die API-Limits von HubSpot gelten pro Schlüssel (100 oder 190 Anfragen pro 10 Sekunden, dazu ein Tageslimit pro Account). Eine neue Unterhaltung kostet vier oder fünf Aufrufe, eine spätere Nachricht zwei.
- 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