Ci sono due modi per usare WhatsApp con Freshdesk. Freshdesk offre un suo canale WhatsApp tramite la WhatsApp Business API, il che significa un numero registrato sull'API, modelli approvati per i messaggi fuori dalla finestra di 24 ore e costi per messaggio. L'altro modo lascia WhatsApp sul numero che i tuoi clienti usano già, con Spun come spazio di lavoro WhatsApp, e collega WhatsApp e Freshdesk tramite un workflow nel tuo n8n.
Questa pagina descrive la seconda strada, il workflow WhatsApp Freshdesk: ogni conversazione individuale diventa un ticket Freshdesk, i messaggi successivi vengono aggiunti al ticket, e la nota pubblica di un agente torna al cliente su WhatsApp. Se tutto il tuo supporto gira già in Freshdesk e i prezzi della Business API ti vanno bene, il canale di Freshdesk è la scelta più semplice.
Cosa fa il workflow WhatsApp Freshdesk
- Ogni conversazione WhatsApp individuale diventa un ticket con l'origine Chat, i tag spun e whatsapp e l'id della chat Spun in un campo personalizzato.
- Il richiedente viene associato a un contatto Freshdesk in base al telefono, poi al cellulare, in formato internazionale. Se non c'è corrispondenza, viene creato un contatto con solo nome e numero. I contatti esistenti non vengono mai modificati e non viene mai aggiunto un indirizzo email.
- I messaggi successivi vengono aggiunti come note pubbliche sul lato cliente del thread, preceduti dal nome e dal numero del mittente. Un ticket in stato “Pending” o “Resolved” torna “Open”.
- Gli agenti rispondono con una nota pubblica, e la nota arriva al cliente su WhatsApp come testo. Le note private restano interne.
- Le risposte che il tuo team invia dalla Posta in arrivo di Spun compaiono come note private, così entrambe le parti possono rispondere.
- Archiviare in Spun chiude il ticket (o lo risolve, a seconda di un'impostazione), e toglierlo dall'archivio lo riapre. Anche chiudere in Freshdesk può archiviare la conversazione in Spun, un'opzione disattivata finché non la attivi.
- Dopo che un ticket è “Closed”, il messaggio successivo apre un nuovo ticket che indica il numero del ticket precedente.
L'API di Freshdesk non ha un'origine ticket WhatsApp, quindi questi ticket usano l'origine Chat più il tag whatsapp. I report filtrati sul canale WhatsApp di Freshdesk non li includono; filtra invece sul tag.
Rispondi con una nota pubblica, non con il pulsante “Reply”
Su un ticket WhatsApp, gli agenti rispondono con “Add note” e rendono pubblica la nota. Il pulsante “Reply” invia un'email, e un cliente creato dal workflow non ha un indirizzo email. Una nota pubblica è ciò che la regola di automazione invia al workflow, ed è ciò che arriva al cliente su WhatsApp.
Configurazione, passo dopo passo
Per la sincronizzazione bidirezionale ti serve Freshdesk Growth o superiore, perché le note degli agenti raggiungono il workflow tramite una regola di automazione che chiama un webhook. Con Free e Sprout i messaggi WhatsApp diventano comunque ticket, ma le note non possono essere rimandate indietro. Ti servono anche un amministratore Freshdesk, un agente di integrazione come “Spun WhatsApp” con la sua chiave API e un'istanza n8n che Freshdesk e Spun possano raggiungere via HTTPS.
- 1
Crea la credenziale con la chiave API
Con l'accesso dell'agente di integrazione, copia la chiave API da “Profile settings” e aggiungila in n8n come credenziale Basic Auth.
- 2
Aggiungi un campo ticket “Spun chat id”
Un campo di testo a riga singola, non obbligatorio per gli agenti né per la chiusura, più un campo facoltativo “Spun line”.
- 3
Importa il workflow
Apri il suo nodo Settings e incolla l'URL del tuo Freshdesk, il nome API del campo chat id e l'id dell'agente di integrazione.
- 4
Scegli l'URL di risposta e il segreto
Dai al nodo di risposta un percorso lungo e casuale, imposta una seconda stringa casuale come segreto Freshdesk e attiva il workflow.
- 5
Crea la regola di automazione
Nella scheda “Ticket Updates”, una regola che si attiva quando un agente aggiunge una nota a un ticket con il tag spun e che chiama l'URL di risposta del workflow con l'header X-Spun-Secret.
- 6
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 chiudere in Freshdesk 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 “Formato del payload” impostato su “Dati grezzi”, e incolla il suo segreto di firma nel workflow.
- 8
Invia un messaggio di prova
Scrivi alla linea da un altro telefono. In Freshdesk compare un ticket; rispondi con una nota pubblica e la risposta arriva sul telefono. Durante questa prima prova controlla le notifiche email ai richiedenti.
Vedi anche: Documentazione: Freshdesk tramite n8n, la guida completa alla configurazione · WhatsApp + n8n: l'API e i webhook che ci stanno sotto
Cosa sapere prima di costruire
- Freshdesk non firma i suoi webhook, quindi il workflow controlla un header con un segreto condiviso a ogni risposta. Gli eventi di Spun sono firmati con HMAC.
- I media entrano nel ticket come link valido per 24 ore, non come allegato. Gli allegati di una nota dell'agente non vengono inoltrati.
- Le chat di gruppo vengono saltate.
- Il limite API di Freshdesk vale per account al minuto (Growth 100, Pro 400, Enterprise 700) ed è condiviso con le tue altre app. Una nuova conversazione richiede fino a 5 chiamate e un messaggio successivo 2 o 3. Freshdesk consente 1.000 chiamate webhook all'ora e mette in coda le altre.
- 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.
Vedi anche: Tutte le integrazioni WhatsApp con un helpdesk · WhatsApp come helpdesk vero e proprio