Guida di configurazione

Integrazione WhatsApp Zendesk: le due strade oneste

Guida alla configurazione e workflow n8n importabileUltima verifica: Ottobre 2026

Ci sono due modi onesti per far funzionare WhatsApp con Zendesk, e sono molto diversi. La prima strada è il canale WhatsApp di Zendesk: ufficiale e basato sulla Business API, il che significa un numero dedicato, l'approvazione dei modelli, costi per messaggio e niente gruppi WhatsApp. La seconda strada lascia WhatsApp sul numero che usi già, con Spun come spazio di lavoro WhatsApp, e un workflow WhatsApp Zendesk nel tuo n8n trasforma ogni conversazione in un ticket Zendesk.

Questa pagina descrive la seconda strada e dice con onestà quando la prima è più adatta: se tutto il tuo supporto vive dentro Zendesk e vuoi WhatsApp come un canale di ticket in più, alle condizioni economiche dell'API, usa il canale di Zendesk. Se WhatsApp è il tuo canale principale con i clienti e Zendesk è un sistema tra tanti, tenerlo sul tuo numero reale con una casella del team di solito serve meglio i clienti.

1. Ticket Zendesk da WhatsApp: cosa fa il workflow

Ogni conversazione WhatsApp individuale sulla linea diventa un ticket Zendesk, senza dover prima applicare un'etichetta. I messaggi successivi vengono aggiunti allo stesso ticket, e un commento pubblico di un agente torna al cliente su WhatsApp.

  • Il richiedente è un utente Zendesk che il workflow trova o crea in base al numero di telefono del cliente, e il ticket viene creato per quell'utente.
  • I commenti pubblici degli agenti in Zendesk vengono inviati al cliente su WhatsApp come testo, dal tuo numero. I commenti privati restano interni.
  • Le risposte che il tuo team invia dalla Posta in arrivo di Spun diventano commenti privati sul ticket, così entrambe le parti possono rispondere e il ticket conserva l'intero scambio.
  • Archiviare la conversazione in Spun risolve il ticket, e toglierla dall'archivio lo riapre. Anche risolvere in Zendesk può archiviare la conversazione in Spun, un'opzione disattivata finché non la attivi. In nessuno dei due casi il workflow invia un messaggio di stato al cliente.
  • Ogni risposta viene inviata con l'id del commento Zendesk come chiave di idempotenza, così una risposta ritentata non viene inviata due volte.

Le chat di gruppo vengono saltate. I media arrivano nel ticket come link valido per 24 ore.

2. Configuralo

Ti servono un amministratore Zendesk che possa creare webhook, trigger e un client OAuth, un agente di integrazione come “Spun WhatsApp” e un'istanza n8n che Zendesk e Spun possano raggiungere via HTTPS. La guida alla configurazione elenca ogni valore e dove trovarlo.

  1. 1

    Crea un client OAuth

    Con l'accesso dell'agente di integrazione, aggiungi un client OAuth nel Centro amministrativo di Zendesk e una credenziale OAuth2 in n8n con il grant client credentials. Un token API è la soluzione di riserva.

  2. 2

    Importa il workflow

    Apri il suo nodo Settings e incolla l'URL del tuo Zendesk e l'id utente dell'agente di integrazione. Un gruppo, un brand e un campo ticket “Spun line” sono facoltativi.

  3. 3

    Crea il webhook Zendesk e il trigger di risposta

    Un webhook che punta all'URL di risposta del workflow, e un trigger che lo chiama quando un ticket con il tag spun riceve un commento pubblico. Incolla il segreto di firma del webhook nel workflow.

  4. 4

    Crea una chiave API Spun

    “Impostazioni”, poi “Webhook”, poi “Gestisci Chiavi API”, con l'ambito “Invia messaggi”. Spunta anche “Chiudi e riapri le conversazioni” se risolvere in Zendesk deve archiviare la conversazione in Spun.

  5. 5

    Iscrivi Spun al workflow

    Aggiungi un webhook per messaggi in arrivo, messaggi in uscita, conversazione chiusa e conversazione riaperta, con il “Formato del payload” impostato su “Dati grezzi”, e incolla il suo segreto di firma nel workflow.

  6. 6

    Invia un messaggio di prova

    Scrivi alla linea da un altro telefono. In Zendesk compare un ticket; rispondi con un commento pubblico e la risposta arriva sul telefono.

La risposta che il workflow invia per un commento pubblico
POST https://api.spun.com/api/integrations/send-message
Authorization: Bearer wap_YOUR_KEY
Content-Type: application/json

{
  "to": "14155552671",
  "text": "Thanks for waiting, your replacement ships today.",
  "idempotency_key": "<Zendesk comment id>"
}

Vedi anche: Documentazione: Zendesk tramite n8n, la guida completa alla configurazione · WhatsApp + n8n: l'API e i webhook che ci stanno sotto

Cosa sapere prima di costruire

  • È un ponte, non una fusione di canali: le conversazioni WhatsApp vivono in Spun, i ticket vivono in Zendesk, e il workflow li tiene allineati. Se ti serve WhatsApp come canale Zendesk con un suo numero, quella è la prima strada, con i suoi costi e i suoi limiti.
  • È un workflow n8n che importi, non un'app del marketplace di Zendesk. Il lato Spun usa una chiave API; il lato Zendesk usa un client OAuth.
  • La chiusura da Zendesk chiama gli endpoint di chiusura e riapertura di Spun, che richiedono l'ambito “Chiudi e riapri le conversazioni” sulla chiave.
  • Zendesk consente 30 aggiornamenti per ticket ogni 10 minuti, 5 nuovi utenti al minuto e 5.000 commenti per ticket. L'API di Spun consente 60 richieste al minuto per chiave.
  • Ogni evento consegnato consuma token IA del tuo piano Spun. Il modo in cui viene conteggiato per l'uso come helpdesk è ancora in fase di revisione.
  • Molti team scoprono che il livello dei ticket era la parte facoltativa: etichette, assegnazione e attività di Spun coprono da sole il ticketing basato sulla chat. Guarda la pagina dell'helpdesk WhatsApp.

Vedi anche: WhatsApp come helpdesk vero e proprio (senza Zendesk) · Tutte le integrazioni WhatsApp con un helpdesk · WhatsApp + Zapier e Make (l'API completa)

Domande frequenti

Zendesk ha un suo canale WhatsApp?

Sì, basato sulla Business API: ufficiale e integrato, ma con un numero dedicato, regole sui modelli, costi per messaggio e nessun supporto per i gruppi. Questa pagina descrive l'alternativa: tenere WhatsApp sul tuo numero attuale in Spun e creare i ticket Zendesk tramite un workflow n8n.

Un messaggio WhatsApp può creare automaticamente un ticket Zendesk?

Sì. Con il workflow, ogni conversazione WhatsApp individuale diventa un ticket Zendesk per un richiedente trovato o creato in base al numero di telefono, e i messaggi successivi vengono aggiunti allo stesso ticket.

Gli agenti possono rispondere su WhatsApp da Zendesk?

Sì. Un commento pubblico sul ticket viene inviato al cliente su WhatsApp dal tuo numero reale. Le risposte inviate dalla Posta in arrivo di Spun vengono aggiunte al ticket come commenti privati, così entrambe le parti possono rispondere.

Quale strada costa meno?

La strada Spun non ha costi per messaggio della Business API. Ogni evento consegnato al workflow consuma token IA del tuo piano Spun, e il modo in cui viene conteggiato per l'uso come helpdesk è ancora in fase di revisione. Il canale di Zendesk aggiunge i costi per conversazione della Business API al prezzo di Zendesk.

Supporto WhatsApp sul tuo numero

Spun trasforma il tuo numero WhatsApp attuale in una casella condivisa per il supporto, con code, 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