Spun lässt WhatsApp auf der Nummer, die deine Kunden schon nutzen, und verbindet es über einen Workflow in deinem eigenen n8n mit Jira Service Management. Jede WhatsApp-Unterhaltung wird zu einer Anfrage in deinem Serviceprojekt, spätere Nachrichten kommen als Kommentare hinzu, und ein öffentlicher Kommentar eines Agenten geht per WhatsApp an den Kunden zurück.
Das ist die WhatsApp-Einrichtung für Jira Service Management für Teams, die ihren Support schon in Jira verfolgen: Agenten bearbeiten Anfragen weiter dort, wo sie sind, Kunden schreiben weiter dort, wo sie schreiben. Das Jira-API-Token bleibt in deinem n8n; Spun erhält oder speichert es nie.
Was der WhatsApp-Workflow für Jira Service Management macht
- Die erste Nachricht einer Unterhaltung erstellt eine Anfrage mit dem Anfragetyp deiner Wahl, mit Name, Nummer und Nachricht des Kunden in der Beschreibung und der Nummer in einem Feld für die WhatsApp-Nummer.
- Spätere Nachrichten werden der offenen Anfrage als öffentliche Kommentare hinzugefügt, mit Name und Nummer des Absenders davor.
- Ein öffentlicher Kommentar eines Agenten wird dem Kunden per WhatsApp als Text gesendet. Interne Kommentare verlassen Jira nie.
- Antworten, die dein Team aus dem Spun-Posteingang sendet, werden als interne Kommentare hinzugefügt, sodass beide Seiten antworten können.
- Archivierst du die Unterhaltung in Spun, wird dein Übergang zum Lösen ausgeführt, und das Zurückholen aus dem Archiv öffnet die Anfrage wieder, wenn ein Übergang zum Wiedereröffnen festgelegt ist. Das Lösen in Jira kann die Unterhaltung auch in Spun archivieren, eine Option, die aus bleibt, bis du sie einschaltest.
Jede Anfrage wird von einem einzigen Integrationskonto erstellt, einem Agenten im Serviceprojekt. Der Workflow legt keine Jira-Kunden an und ordnet auch keine zu, daher gehen die Kundenbenachrichtigungen von Jira zu diesen Anfragen an das Postfach dieses Kontos, nicht an den Kunden.
Einrichtung Schritt für Schritt
Du brauchst eine Jira-Service-Management-Site mit einem Serviceprojekt, ein Integrationskonto, das Agent in diesem Projekt ist (ob der Platz berechnet wird, hängt von deinem Jira-Plan ab), einmalig einen Jira-Admin zum Anlegen des Webhooks und eine n8n-Instanz, die Jira und Spun über HTTPS erreichen.
- 1
Erstelle ein API-Token für das Integrationskonto
Melde dich mit diesem Konto an, erstelle ein API-Token und speichere es in n8n als Credential vom Typ Basic Auth. Es bleibt in deinem n8n.
- 2
Füge ein Feld „WhatsApp number“ hinzu
Ein kurzes Textfeld im Anfragetyp, den WhatsApp-Unterhaltungen nutzen sollen.
- 3
Schlage deine Übergänge nach
Den Übergang, der eine Anfrage löst, und optional einen, der sie wieder öffnet.
- 4
Importiere den Workflow
Öffne seinen Settings-Node und füge die URL deiner Site, den Service Desk, den Anfragetyp, den Projektschlüssel, die Feld-ID, die Übergänge und die ID des Integrationskontos ein.
- 5
Erstelle den Jira-Webhook
Als Jira-Admin einen Webhook auf die Antwort-URL des Workflows für Comment: created, per JQL auf dein Projekt gefiltert und mit einem Secret geschützt. Jira signiert jede Zustellung, und der Workflow prüft die Signatur.
- 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 Lösen in Jira 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 Jira erscheint eine Anfrage; füge als Agent einen öffentlichen Kommentar hinzu, und die Antwort kommt auf dem Telefon an.
Siehe auch: Doku: Jira Service Management über n8n, die vollständige Einrichtungsanleitung · WhatsApp + n8n: die API und die Webhooks dahinter
Was du vor dem Aufbau wissen solltest
- Gruppenchats werden übersprungen.
- Medien kommen als 24 Stunden gültiger Link in die Anfrage, nicht als Jira-Anhang. Antworten aus Jira sind reiner Text; Anhänge an einem Kommentar werden nicht weitergeleitet.
- Jira nimmt 20 Schreibvorgänge auf eine Anfrage in 2 Sekunden an und 100 in 30 Sekunden. Bei einer langen Serie von Nachrichten werden die überzähligen nicht zur Anfrage hinzugefügt; sie bleiben im Spun-Posteingang, und der n8n-Lauf kann wiederholt werden.
- Eine offene Anfrage pro Unterhaltung. Kommentare mit mehr als 32.000 Zeichen werden gekürzt.
- 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