> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt. # Freshdesk Con uno [strumento webhook](/docs/it/reception-ai/integrations/webhooks), 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](#look-up-tickets-with-the-mcp-server) 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: ```bash printf 'YOUR_API_KEY:X' | base64 ``` Il valore dell'header è `Basic ` seguito dall'output. > **Warning** > > 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](/docs/it/reception-ai/receptionist/testing) 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](/docs/it/reception-ai/integrations/mcp-server) 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`. |