> 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

O Zoho MCP permite criar um [servidor MCP](/docs/pt/reception-ai/integrations/mcp-server) com as ferramentas do Zoho CRM que você escolher. Conecte-o para que sua recepcionista possa reconhecer quem liga e já está no seu CRM e adicionar novas pessoas como leads. A API do próprio Zoho CRM usa tokens de login que expiram a cada hora, portanto as ferramentas de webhook não conseguem se conectar diretamente a ela.

## Configuração

### Crie um servidor MCP no Zoho

Entre no console do Zoho MCP do seu data center Zoho, como `mcp.zoho.com` ou `mcp.zoho.eu`. Selecione **Create MCP Server**, insira um nome e selecione **Create**.

### Adicione ferramentas do Zoho CRM

Abra **Tools** e selecione **Add Tools**. Filtre por Zoho CRM e marque apenas as ferramentas de que sua recepcionista precisa, como ferramentas para pesquisar registros, obter um registro e criar registros. Selecione **Add Now**.

Não inclua ferramentas que atualizam ou excluem registros, nem que alteram os módulos, campos ou workflows do seu CRM.

### Autorize a conexão antecipadamente

As ferramentas do Zoho usam **Authorize on Demand** por padrão, o que solicita um login do Zoho em um navegador na primeira vez que uma ferramenta é executada. Sua recepcionista não pode concluir esse login durante uma chamada, então autorize a conexão no console:

1. Abra **Connections** → **Zoho Services**, selecione **Edit**, escolha **Authorize via Connections** e selecione **Update**.
2. Selecione o menu (**…**) ao lado da conexão e selecione **Authorize**.
3. Entre como o usuário do Zoho pelo qual sua recepcionista deve atuar e permita o acesso.

As ferramentas podem fazer tudo o que a função de CRM desse usuário permitir. Considere usar um usuário dedicado com uma função limitada aos módulos de que sua recepcionista precisa.

### Copie a URL do MCP

Abra **Connect** e copie a URL do MCP. A URL contém uma chave que dá acesso às ferramentas do seu CRM, então trate-a como um segredo.

### Adicione o servidor MCP

No Reception.ai, acesse **Integrações**, selecione **Adicionar integração** e escolha **Servidor MCP**.

| Campo                | Valor                        |
| -------------------- | ---------------------------- |
| **Nome**             | Zoho CRM                     |
| **Tipo de servidor** | Streamable HTTP              |
| **URL do servidor**  | A URL do MCP que você copiou |

Deixe **Secret Token** em branco, porque a chave já está na URL. Selecione **Ativar**.

### Atribua ferramentas

Abra a guia **Ferramentas** e atribua as ferramentas de pesquisa, obtenção e criação ao **Cliente** (recepcionista).

### Teste

[Teste sua recepcionista](/docs/pt/reception-ai/receptionist/testing) com uma chamada de um número que já está no Zoho CRM e depois com uma nova pessoa ligando. A nova pessoa aparecerá como lead.

> **Note**
>
> As chamadas ao servidor Zoho MCP usam seus créditos de API do Zoho CRM, assim como outros acessos à API.

## Solução de problemas

| Problema                                         | O que verificar                                                                                                            |
| ------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------- |
| Nenhuma ferramenta está listada                  | Use o tipo de servidor **Streamable HTTP** e a URL completa em **Connect**.                                                |
| As ferramentas falham com um erro de autorização | A conexão ainda está definida como **Authorize on Demand** ou ainda não foi autorizada. Autorize-a no console do Zoho MCP. |
| Pessoas conhecidas não são encontradas           | O Zoho compara os números de telefone conforme estão armazenados. Armazene os números em um único formato.                 |
| Uma ferramenta mostra o selo **Alterado**        | Você alterou a ferramenta no Zoho. Revise-a na guia **Ferramentas** e selecione **Atualizar**.                             |
| A URL do MCP foi compartilhada por engano        | Selecione **Regenerate API Key** em **Connect** no console do Zoho MCP e atualize a **URL do servidor** no Reception.ai.   |