Freshdesk | ElevenLabs Documentation

Con uno strumento webhook, la tua receptionist può aprire un ticket Freshdesk ogni volta che un chiamante segnala un problema o chiede aiuto, così il tuo team può occuparsene. Con i piani Growth, Pro ed Enterprise, puoi anche collegare il server MCP di Freshdesk per cercare i ticket esistenti.

Crea ticket

Ottieni la chiave API

In Freshdesk, seleziona la tua immagine del profilo, apri Impostazioni del profilo e seleziona Visualizza chiave API. Copia la chiave. Funziona come account dell’agente, quindi i ticket vengono creati con le tue autorizzazioni.

Crea l’header di autorizzazione

Freshdesk usa la chiave API come nome utente e X come password. Codificala in un terminale, sostituendo YOUR_API_KEY con la tua chiave:

printf 'YOUR_API_KEY:X' | base64

Il valore dell’header è Basic seguito dall’output.

Non incollare la tua chiave API in un codificatore online. Chiunque disponga della chiave o dell’header codificato può leggere e modificare i tuoi ticket.

Crea lo strumento webhook

Vai a Integrazioni, seleziona Aggiungi integrazione e scegli Strumento webhook.

Campo	Valore
Nome	`create_freshdesk_ticket`
Descrizione	”Apri un ticket di assistenza quando un chiamante segnala un problema o ha bisogno di aiuto dal team.”
Metodo	POST
URL	`https://YOURDOMAIN.freshdesk.com/api/v2/tickets`
Header della richiesta	`Authorization`: `Basic` seguito dalla chiave codificata
Parametri del body	`name` (stringa, obbligatorio): “Il nome completo del chiamante.” `phone` (stringa): “Il numero di telefono del chiamante.” `email` (stringa): “L’indirizzo email del chiamante, se lo ha fornito.” `subject` (stringa, obbligatorio): “Un breve riepilogo del problema.” `description` (stringa, obbligatorio): “Ciò che il chiamante ha segnalato, con le sue parole e tutti i dettagli forniti.” `status` (numero, obbligatorio): “Sempre il valore esatto `2`.” `priority` (numero, obbligatorio): “Sempre il valore esatto `1`.” `source` (numero, obbligatorio): “Sempre il valore esatto `3`.”
Assegna agli agenti	Receptionist

Sostituisci YOURDOMAIN con il tuo sottodominio Freshdesk. Seleziona Abilita.

Provalo

Prova la tua receptionist segnalando un problema. Il ticket viene visualizzato in Freshdesk.

I valori fissi creano il ticket come Aperto (stato 2) con priorità Bassa (priorità 1) e lo contrassegnano come proveniente da Telefono (origine 3). Per permettere alla receptionist di impostare la priorità, descrivi invece i valori, ad esempio: “1 per bassa, 2 per media, 3 per alta, 4 per urgente.”

Freshdesk richiede un numero di telefono o un’email per trovare o creare il richiedente. Indica alla tua receptionist di raccogliere sempre il numero di telefono del chiamante.

Cerca ticket con il server MCP

Il server MCP di Freshdesk è disponibile nei piani Growth, Pro ed Enterprise. Usalo per permettere alla tua receptionist di cercare i ticket esistenti di un chiamante. Le azioni MCP vengono conteggiate in una quota annuale che dipende dal tuo piano.

In Reception.ai, vai a Integrazioni, seleziona Aggiungi integrazione e scegli Server MCP.

Campo	Valore
Nome	Freshdesk
Tipo di server	HTTP in streaming
URL del server	`https://YOURDOMAIN.freshdesk.com/mcp`
Header HTTP	`Authorization`: la tua chiave API, senza prefisso

Lascia vuoto Token segreto, così Reception.ai invia l’header Authorization esattamente come lo hai inserito. Usa il tuo sottodominio freshdesk.com anche se hai un dominio personalizzato. Seleziona Abilita.

Apri la scheda Strumenti e assegna alla Client (receptionist) gli strumenti di ricerca dei ticket, come fetchSearchTickets e fetchTicket. Lascia non assegnati gli strumenti che aggiornano ticket, agenti, gruppi o articoli.

Risoluzione dei problemi

Problema	Cosa verificare
401 da Freshdesk	Codifica la chiave aggiungendo `:X` alla fine e inizia il valore dell’header con `Basic` e uno spazio.
400 relativo al richiedente	Il ticket richiede un numero di telefono o un’email, oltre al nome. Assicurati che la receptionist li raccolga.
400 relativo a stato o priorità	`status`, `priority` e `source` devono essere parametri numerici, non stringhe.
Il server MCP non elenca strumenti	Usa il tuo sottodominio `freshdesk.com` e inserisci la chiave API non elaborata nell’header `Authorization`, senza `Basic` né `Bearer`.