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

# Intercom

Conecte o [servidor MCP](/docs/pt/reception-ai/integrations/mcp-server) hospedado do Intercom para que sua recepcionista possa reconhecer quem liga e é seu cliente, verificar suas conversas abertas e responder a perguntas com base nos artigos da sua Central de ajuda.

> **Warning**
>
> As conversas podem conter detalhes privados. Instrua sua recepcionista, nas instruções dela ou em um
> [procedimento](/docs/pt/reception-ai/receptionist/rules-and-procedures), a compartilhar detalhes da conversa
> somente depois de confirmar que quem liga é o contato, por exemplo, verificando o número de telefone ou
> e-mail.

## Configuração

### Crie um app privado

No Intercom, abra o **Hub do desenvolvedor** e crie um novo app para seu espaço de trabalho. Abra o app e acesse **Configurar** → **Autenticação**. Em seguida, copie o token de acesso.

Verifique se as permissões do app incluem leitura de usuários, empresas e conversas, além de leitura de artigos. Adicione permissão de gravação em conversas somente se quiser que sua recepcionista deixe notas internas.

### Adicione o servidor MCP

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

| Campo                | Valor                                             |
| -------------------- | ------------------------------------------------- |
| **Nome**             | Intercom                                          |
| **Tipo de servidor** | HTTP com streaming                                |
| **URL do servidor**  | A URL da região do seu espaço de trabalho, abaixo |
| **Token secreto**    | Seu token de acesso                               |

| Região do espaço de trabalho           | URL do servidor                   |
| -------------------------------------- | --------------------------------- |
| EUA (você entra em app.intercom.com)   | `https://mcp.intercom.com/mcp`    |
| UE (você entra em app.eu.intercom.com) | `https://mcp.eu.intercom.com/mcp` |

Selecione **Ativar**. O Reception.ai envia o token como token bearer e lista as ferramentas do Intercom.

### Atribua ferramentas

Abra a guia **Ferramentas** e atribua estas ao **Cliente** (recepcionista):

* `search_contacts` e `get_contact`: encontram quem ligou e seus dados.
* `search_conversations` e `get_conversation`: verificam o status das solicitações de quem ligou.
* `search_articles` e `get_article`: respondem a perguntas da sua Central de ajuda.

Opcionalmente, atribua `add_internal_note` para que sua recepcionista possa adicionar um resumo da ligação à conversa de quem ligou. As notas são visíveis apenas para sua equipe. Deixe `create_article` e `update_article` sem atribuição.

### Teste

[Teste sua recepcionista](/docs/pt/reception-ai/receptionist/testing) ligando de um número salvo em um contato de teste e perguntando sobre uma conversa aberta.

## Limitações

O servidor MCP do Intercom não oferece suporte a espaços de trabalho hospedados na Austrália.

## Solução de problemas

| Problema                                    | O que verificar                                                                                                |
| ------------------------------------------- | -------------------------------------------------------------------------------------------------------------- |
| Nenhuma ferramenta é listada                | Use o tipo de servidor **HTTP com streaming** e a URL da região do seu espaço de trabalho.                     |
| Uma ferramenta retorna um erro de permissão | Adicione a permissão ausente ao app no **Hub do desenvolvedor**.                                               |
| A recepcionista não encontra quem ligou     | O Intercom compara números de telefone conforme estão salvos no contato. Salve os números em um único formato. |
| Você alterou o token                        | Edite a integração e use **Rotacionar token secreto (opcional)**. O token salvo nunca é exibido novamente.     |