Twenty
Reconheça chamadores e adicione novos leads ao CRM Twenty pelo servidor MCP.
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 integrado do Twenty, que funciona no Twenty Cloud e no Twenty auto-hospedado. Você também pode criar ferramentas de webhook 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.
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.
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 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 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.