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

# Zoho CRM

Zoho MCP ti consente di creare un [server MCP](/docs/it/reception-ai/integrations/mcp-server) con gli strumenti Zoho CRM che scegli. Connettilo affinché la tua receptionist possa riconoscere i chiamanti già presenti nel tuo CRM e aggiungere nuovi chiamanti come lead. L'API di Zoho CRM usa token di accesso che scadono ogni ora, quindi gli strumenti webhook non possono connettersi direttamente.

## Configurazione

### Crea un server MCP in Zoho

Accedi alla console Zoho MCP per il tuo data center Zoho, ad esempio `mcp.zoho.com` o `mcp.zoho.eu`. Seleziona **Create MCP Server**, inserisci un nome e seleziona **Create**.

### Aggiungi strumenti Zoho CRM

Apri **Tools** e seleziona **Add Tools**. Filtra per Zoho CRM e seleziona solo gli strumenti necessari alla tua receptionist, ad esempio quelli per cercare record, recuperare un record e creare record. Seleziona **Add Now**.

Escludi gli strumenti che aggiornano o eliminano record oppure che modificano moduli, campi o workflow del tuo CRM.

### Autorizza la connessione in anticipo

Per impostazione predefinita, gli strumenti Zoho usano **Authorize on Demand**, che richiede l'accesso a Zoho in un browser la prima volta che viene eseguito uno strumento. La tua receptionist non può completare l'accesso durante una chiamata, quindi autorizza invece la connessione nella console:

1. Apri **Connections** → **Zoho Services**, seleziona **Edit**, scegli **Authorize via Connections** e seleziona **Update**.
2. Seleziona il menu (**…**) accanto alla connessione e seleziona **Authorize**.
3. Accedi come l'utente Zoho per cui deve agire la tua receptionist e consenti l'accesso.

Gli strumenti possono fare tutto ciò che il ruolo CRM di questo utente consente. Valuta di creare un utente dedicato con un ruolo limitato ai moduli necessari alla tua receptionist.

### Copia l'URL MCP

Apri **Connect** e copia l'URL MCP. L'URL contiene una chiave che dà accesso agli strumenti del tuo CRM, quindi trattala come un segreto.

### Aggiungi il server MCP

In Reception.ai, vai a **Integrations**, seleziona **Add integration** e scegli **MCP Server**.

| Campo              | Valore            |
| ------------------ | ----------------- |
| **Nome**           | Zoho CRM          |
| **Tipo di server** | Streamable HTTP   |
| **URL del server** | L'URL MCP copiato |

Lascia vuoto **Secret Token**, perché la chiave è già nell'URL. Seleziona **Enable**.

### Assegna gli strumenti

Apri la scheda **Tools** e assegna gli strumenti di ricerca, recupero e creazione al **Client** (receptionist).

### Provalo

[Testa la tua receptionist](/docs/it/reception-ai/receptionist/testing) con una chiamata da un numero già presente in Zoho CRM, poi con un nuovo chiamante. Il nuovo chiamante comparirà come lead.

> **Note**
>
> Le chiamate al server Zoho MCP usano i tuoi crediti API Zoho CRM, come gli altri accessi API.

## Risoluzione dei problemi

| Problema                                                   | Cosa controllare                                                                                                             |
| ---------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| Non è elencato alcuno strumento                            | Usa il tipo di server **Streamable HTTP** e l'URL completo da **Connect**.                                                   |
| Gli strumenti non riescono per un errore di autorizzazione | La connessione è ancora impostata su **Authorize on Demand** o non è ancora autorizzata. Autorizzala nella console Zoho MCP. |
| I chiamanti noti non vengono trovati                       | Zoho confronta i numeri di telefono nel formato in cui sono memorizzati. Memorizza i numeri in un unico formato.             |
| Uno strumento mostra il badge **Changed**                  | Hai modificato lo strumento in Zoho. Rivedilo nella scheda **Tools** e seleziona **Update**.                                 |
| L'URL MCP è stato condiviso per errore                     | Seleziona **Regenerate API Key** in **Connect** nella console Zoho MCP, quindi aggiorna **Server URL** in Reception.ai.      |