Spun mantiene WhatsApp sul numero che i tuoi clienti usano già e lo collega a Jira Service Management tramite un workflow nel tuo n8n. Ogni conversazione WhatsApp diventa una richiesta nel tuo progetto di servizi, i messaggi successivi vengono aggiunti come commenti e un commento pubblico di un agente torna al cliente su WhatsApp.
Questa è la configurazione WhatsApp per Jira Service Management pensata per i team che gestiscono già l’assistenza in Jira: gli agenti continuano a lavorare le richieste dove sono, i clienti continuano a scrivere dove sono. Il token API di Jira resta nel tuo n8n; Spun non lo riceve né lo memorizza mai.
Cosa fa il workflow WhatsApp per Jira Service Management
- Il primo messaggio di una conversazione apre una richiesta del tipo di richiesta che scegli, con nome, numero e messaggio del cliente nella descrizione e il numero in un campo per il numero WhatsApp.
- I messaggi successivi vengono aggiunti alla richiesta aperta come commenti pubblici, preceduti dal nome e dal numero del mittente.
- Un commento pubblico di un agente viene inviato al cliente su WhatsApp come testo. I commenti interni non escono mai da Jira.
- Le risposte che il tuo team invia dalla Posta in arrivo di Spun vengono aggiunte come commenti interni, così entrambe le parti possono rispondere.
- Archiviare la conversazione in Spun esegue la tua transizione di risoluzione, e toglierla dall’archivio riapre la richiesta quando è impostata una transizione di riapertura. Anche la risoluzione in Jira può archiviare la conversazione in Spun, un’opzione che resta disattivata finché non la attivi.
Ogni richiesta viene aperta da un unico account di integrazione, un agente del progetto di servizi. Il workflow non crea né associa clienti Jira, quindi le notifiche ai clienti di Jira per queste richieste arrivano alla casella email di quell’account, non al cliente.
Configurazione passo per passo
Ti servono un sito Jira Service Management con un progetto di servizi, un account di integrazione che sia agente in quel progetto (se la licenza viene fatturata dipende dal tuo piano Jira), un amministratore Jira una sola volta per creare il webhook e un’istanza n8n che Jira e Spun possano raggiungere via HTTPS.
- 1
Crea un token API per l’account di integrazione
Dopo aver effettuato l’accesso con quell’account, crea un token API e salvalo in n8n come credenziale Basic Auth. Resta nel tuo n8n.
- 2
Aggiungi un campo “WhatsApp number”
Un campo di testo breve nel tipo di richiesta che le conversazioni WhatsApp devono usare.
- 3
Individua le tue transizioni
La transizione che risolve una richiesta e, facoltativamente, una che la riapre.
- 4
Importa il workflow
Apri il nodo Settings del workflow e incolla l’URL del tuo sito, il service desk, il tipo di richiesta, la chiave del progetto, l’ID del campo, le transizioni e l’ID dell’account di integrazione.
- 5
Crea il webhook di Jira
Come amministratore Jira, un webhook verso l’URL di risposta del workflow su Comment: created, filtrato con JQL sul tuo progetto e protetto con un segreto. Jira firma ogni consegna e il workflow la verifica.
- 6
Crea una chiave API di Spun
“Impostazioni”, poi “Webhook”, poi “Gestisci chiavi API”, con l’ambito “Invia messaggi”. Spunta anche “Chiudi e riapri le conversazioni” se la risoluzione in Jira deve archiviare la conversazione in Spun.
- 7
Iscrivi Spun al workflow
Aggiungi un webhook per messaggi in arrivo, messaggi in uscita, conversazione chiusa e conversazione riaperta, con il modello di payload impostato su raw, e incolla nel workflow il segreto di firma del webhook.
- 8
Invia un messaggio di prova
Scrivi alla linea da un altro telefono. In Jira compare una richiesta; aggiungi un commento pubblico come agente e la risposta arriva sul telefono.
Vedi anche: Documentazione: Jira Service Management tramite n8n, la guida completa alla configurazione · WhatsApp + n8n: l’API e i webhook alla base
Cosa sapere prima di costruire
- Le chat di gruppo vengono saltate.
- I file multimediali entrano nella richiesta come link valido per 24 ore, non come allegato Jira. Le risposte da Jira sono solo testo; gli allegati di un commento non vengono inoltrati.
- Jira accetta 20 scritture su una richiesta in 2 secondi e 100 in 30 secondi. Durante una lunga raffica di messaggi, quelli in eccesso non vengono aggiunti alla richiesta; restano nella Posta in arrivo di Spun e l’esecuzione di n8n può essere ripetuta.
- Una richiesta aperta per conversazione. I commenti più lunghi di 32.000 caratteri vengono troncati.
- Ogni evento consegnato usa token IA del tuo piano Spun. Il modo in cui questo viene conteggiato per l’uso come helpdesk è ancora in fase di revisione.
Vedi anche: Tutte le integrazioni helpdesk per WhatsApp · WhatsApp come helpdesk