Einrichtungsanleitung

HubSpot Service Hub WhatsApp: Mach aus Unterhaltungen HubSpot-Tickets

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

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.
Wie Nachrichten im Ticket protokolliert werden (Beispiel)
[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. 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. 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. 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. 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. 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. 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. 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. 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

Häufige Fragen

Kann HubSpot Service Hub Tickets aus WhatsApp erstellen?

Ja. Mit Spun und dem n8n-Workflow wird jede 1:1-Unterhaltung auf WhatsApp zu einem Ticket in der Pipeline und dem Ticketstatus deiner Wahl, und jede Nachricht wird im Ticket und in der Kontakt-Timeline protokolliert.

Wie antworten Agenten aus einem HubSpot-Ticket auf WhatsApp?

Die Agenten geben die Antwort in die Eigenschaft Spun reply am Ticket ein und speichern. Der Text wird von deiner eigenen Nummer per WhatsApp an den Kunden gesendet, im Ticket protokolliert, und das Feld wird geleert.

Was ist der Unterschied zur HubSpot-CRM-Kontaktsynchronisierung?

Die Kontaktsynchronisierung gleicht Kontakte zwischen Spun und HubSpot ab und erstellt keine Tickets. Dieser Workflow erstellt und aktualisiert Tickets und bearbeitet nie einen Kontakt. Beide laufen parallel.

Was brauche ich auf der HubSpot-Seite?

Service Hub, zwei benutzerdefinierte Ticketeigenschaften, einen Schlüssel für API-Aufrufe und eine App für den Antwort-Webhook: eine ältere private App, die vor dem 26. Oktober 2026 angelegt wurde, oder eine projektbasierte App, gebaut mit der HubSpot CLI, die einen Entwickler braucht.

Ist das eine App aus dem HubSpot Marketplace?

Nein. Es ist ein n8n-Workflow, den du in dein eigenes n8n importierst, Cloud oder selbst gehostet, mit einer Einrichtungsanleitung in der Spun-Doku.

WhatsApp-Unterhaltungen als HubSpot-Tickets

Spun macht aus deiner bestehenden WhatsApp-Nummer einen gemeinsamen Team-Posteingang mit Labels, Zuweisung und KI-Zusammenfassungen, dazu die HubSpot-Kontaktsynchronisierung sowie die Webhooks und die API, die dieser Workflow nutzt. Kostenlose Testphase.

Kostenlos starten

Alle Integrationen ansehen