Guida di configurazione

Integrazione WhatsApp Jira: richieste di Service Management da WhatsApp

Guida alla configurazione e workflow n8n importabileUltima verifica: ottobre 2026

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. 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. 2

    Aggiungi un campo “WhatsApp number”

    Un campo di testo breve nel tipo di richiesta che le conversazioni WhatsApp devono usare.

  3. 3

    Individua le tue transizioni

    La transizione che risolve una richiesta e, facoltativamente, una che la riapre.

  4. 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. 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. 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. 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. 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

Domande frequenti

Jira Service Management può ricevere messaggi WhatsApp?

Sì, tramite Spun e un workflow n8n. Ogni conversazione WhatsApp diventa una richiesta nel tuo progetto di servizi e i messaggi successivi vengono aggiunti come commenti.

Come rispondono gli agenti su WhatsApp da Jira?

Con un commento pubblico sulla richiesta. Un webhook firmato di Jira lo invia al workflow, che lo manda al cliente su WhatsApp dal tuo numero. I commenti interni restano in Jira.

Le richieste vengono aperte a nome del cliente?

No. Ogni richiesta viene aperta da un unico account di integrazione, e il nome e il numero del cliente vengono scritti nella richiesta. Non vengono creati account cliente in Jira.

Spun memorizza il mio token API di Jira?

No. Il token vive nelle credenziali del tuo n8n. Spun vede solo il lato WhatsApp e le risposte che il workflow gli chiede di inviare.

È un’app del marketplace di Jira?

No. È un workflow n8n che importi nel tuo n8n, Cloud o self-hosted, con una guida alla configurazione nella documentazione di Spun.

Conversazioni WhatsApp come richieste Jira

Spun trasforma il tuo numero WhatsApp esistente in una casella condivisa del team con etichette, assegnazione e riepiloghi IA, più i webhook e l’API che questo workflow usa. Prova gratuita.

Inizia gratis: 7 giorni con tutto incluso

Vedi tutte le integrazioni