> This is a page from the ElevenLabs documentation. For an index of the documentation, fetch https://elevenlabs.io/docs/llms.txt. # Twenty Seu recepcionista pode reconhecer chamadores que já estão no Twenty e adicionar novos chamadores como pessoas, com nome, número de telefone e o motivo da ligação, para que sua equipe de vendas possa fazer o acompanhamento. O Reception se conecta ao [servidor MCP](/docs/pt/reception-ai/integrations/mcp-server) integrado do Twenty, que funciona no Twenty Cloud e no Twenty auto-hospedado. Você também pode criar [ferramentas de webhook](/docs/pt/reception-ai/integrations/webhooks) para a API REST do Twenty, mas o servidor MCP exige menos configuração: ele fornece ao seu recepcionista ferramentas prontas para encontrar e adicionar pessoas, já associadas aos campos do seu workspace, incluindo o campo de motivo da ligação abaixo. ## Configuração ### Adicione um campo para o motivo da ligação As pessoas no Twenty não têm um campo de notas próprio. Para registrar o motivo da ligação no perfil delas, acesse **Configurações** → **Modelo de dados**, abra **Pessoas** e adicione um campo de **Texto** chamado `Call reason`. Apenas administradores do workspace podem alterar o modelo de dados. ### Crie uma função para o Reception.ai Acesse **Configurações** → **Membros** → **Funções** e crie uma função que possa apenas ler e criar Pessoas. Você atribuirá a chave de API a ela na próxima etapa. ### Crie uma chave de API Acesse **Configurações** → **Desenvolvedores** → **API** e selecione **+ Criar chave**. Dê um nome a ela, por exemplo, `Reception.ai`, e copie-a imediatamente: o Twenty a mostra apenas uma vez. Em seguida, abra a função que você criou, acesse a aba **Atribuição** e atribua a chave a ela. > **Warning** > > A chave de API pode ler e alterar tudo o que a função dela permitir. Não a compartilhe em documentos compartilhados e > exclua-a no Twenty caso ela seja exposta. ### Adicione o servidor MCP No Reception.ai, acesse **Integrações**, selecione **Adicionar integração** e escolha **Servidor MCP**. | Campo | Valor | | -------------------- | ---------------------------------------------------------------------- | | **Nome** | Twenty | | **Tipo de servidor** | HTTP com streaming | | **URL do servidor** | O endereço do seu workspace seguido de `/mcp`, conforme listado abaixo | | **Token secreto** | Sua chave de API | | Onde o Twenty é executado | URL do servidor | | ------------------------- | -------------------------------------------------------------------------- | | Twenty Cloud | A URL do seu workspace, por exemplo, `https://mycompany.twenty.com/mcp` | | Auto-hospedado | A URL pública da sua instância, por exemplo, `https://crm.example.com/mcp` | Você pode copiar o endereço exato em **Configurações** → **IA** → **MCP** no Twenty. Não adicione `?mode=meta` à URL: esse modo fornece ao seu recepcionista uma única ferramenta que pode executar qualquer ação. Selecione **Ativar**. O Reception.ai envia a chave como um token bearer e lista as ferramentas do Twenty. ### Atribua ferramentas O Twenty lista uma ferramenta para cada ação em cada objeto. Abra a aba **Ferramentas** e atribua apenas estas ao **Cliente** (recepcionista): * `find_many_people`: encontre o chamador pelo número de telefone. * `create_one_person`: adicione um novo chamador com nome, número de telefone e motivo da ligação. Deixe as ferramentas de atualização e exclusão, assim como as ferramentas para outros objetos, sem atribuição. ### Adicione um procedimento Adicione um [procedimento](/docs/pt/reception-ai/receptionist/rules-and-procedures) para novos leads: primeiro, procure o chamador pelo número de telefone; crie uma pessoa apenas quando não houver correspondência e sempre preencha nome, sobrenome, número de telefone e motivo da ligação. Adicione uma regra para que seu recepcionista nunca leia registros do CRM para os chamadores. ### Teste [Teste seu recepcionista](/docs/pt/reception-ai/receptionist/testing) ligando de um número salvo para uma pessoa no Twenty e, em seguida, como um novo chamador que quer uma cotação. A nova pessoa aparece em **Pessoas** com o motivo da ligação preenchido. ## Limitações * O Twenty armazena o código de chamada do país separadamente do restante do número. Chamadores salvos sem código do país ou em um formato diferente podem não ser encontrados, então um chamador recorrente pode ser adicionado duas vezes. * Nessa configuração, seu recepcionista não cria notas, tarefas nem oportunidades. Sua equipe acessa novas pessoas pela lista **Pessoas**, por exemplo, com uma visualização filtrada por **Motivo da ligação**. * Instâncias auto-hospedadas precisam de uma versão do Twenty que inclua o servidor MCP, e a URL pública deve estar acessível pela internet via HTTPS. * A API do Twenty permite 100 solicitações por minuto. Workspaces movimentados com outras integrações podem atingir o limite. ## Solução de problemas | Problema | O que verificar | | ------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Nenhuma ferramenta é listada | Use o tipo de servidor **HTTP com streaming** e verifique se a URL termina em `/mcp`. Em instalações auto-hospedadas, a configuração `SERVER_URL` deve ser sua URL pública. | | Uma ferramenta retorna um erro de permissão | A função da chave não pode ler ou criar Pessoas. Edite a função em **Configurações** → **Membros** → **Funções**. | | Chamadores conhecidos não são encontrados | Armazene números de telefone com o código do país e em um único formato. | | O motivo da ligação está vazio | Selecione **Atualizar ferramentas** depois de adicionar o campo `Call reason` e, em seguida, selecione **Atualizar** na ferramenta alterada. | | Você alterou a chave | Edite a integração e use **Alternar token secreto (opcional)**. A chave salva nunca é mostrada novamente. |