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