Integrações Externas
Conecte CRMs, agenda, e-mail, bancos de dados, servidores MCP e APIs próprias aos seus agentes.
Visão geral
Integrações conectam contas de sistemas externos ao workspace. Elas não são pontos de conversa: cada conta conectada disponibiliza ferramentas que o agente executa durante o atendimento — criar um lead no CRM, checar a agenda, mandar um e-mail, consultar seu banco de dados.
O fluxo é sempre o mesmo:
- Conecte a conta em Integrações
- As ferramentas aparecem na página Ferramentas
- Ative por agente em Agentes → [agente] → Ferramentas
- O agente usa quando o contexto pedir
A página de Integrações
Duas seções:
- Conectadas — Contas já configuradas, com data de conexão e a opção de desconectar
- Disponíveis para conectar — Catálogo, com busca
Desconectar apaga as credenciais salvas e remove as ferramentas que dependem daquela conta em todos os agentes.
O que dá para conectar
| Categoria | Integrações |
|---|---|
| CRM | HubSpot, Salesforce, Pipedrive, Zoho CRM, RD Station, Ploomes, Agendor, PipeRun, Bitrix24 |
| Agenda | Google Calendar |
| Produtividade | Slack, Trello, Typeform |
| Mensageria | SendGrid (e-mail), Twilio SMS |
| Dados | Postgres externo (consulta somente leitura) |
| Genéricas | Webhook, MCP Server, API personalizada |
O catálogo evolui; a lista que vale é a que aparece em Integrações no seu workspace.
Métodos de conexão
OAuth
Usado por serviços como HubSpot e Google Calendar: você clica em Conectar, é redirecionado para o provedor, autoriza e volta com a conta ativa. O Take Sales nunca vê a sua senha e o acesso pode ser revogado do lado do provedor.
Credenciais manuais
A maioria das integrações pede campos específicos (API token, client id/secret, domínio, número de origem). O formulário mostra exatamente o que cada serviço precisa e onde encontrar cada valor.
OAuth2 client credentials
Para APIs próprias que emitem token: informe URL do token, client id, client secret, e opcionalmente scope, audience e como enviar as credenciais do client (corpo da requisição ou HTTP Basic). O token é renovado automaticamente.
Por segurança, o client secret não é exibido depois de salvo. Para trocá-lo, conecte a conta novamente.
MCP Server
A integração MCP Server conecta qualquer servidor Model Context Protocol sobre Streamable HTTP. As ferramentas expostas pelo servidor são descobertas automaticamente e podem ser ligadas e desligadas por agente, como qualquer outra.
MCP é o caminho mais curto quando o seu time já mantém um servidor de ferramentas: em vez de recriar cada endpoint como custom tool, conecte o servidor e sincronize as ferramentas.
Postgres externo
Conecte um banco Postgres seu para o agente consultar dados em tempo real (catálogo, estoque, status de pedido). As consultas são validadas antes de executar e restritas a leitura.
Use um usuário de banco somente leitura, com acesso apenas às tabelas necessárias. A validação da plataforma é uma camada de proteção, não substituto de permissão no banco.
API personalizada
Para serviços sem integração pronta, use API personalizada: dê um nome e defina os campos de credencial que a sua API precisa. Depois, crie as custom tools que apontam para os endpoints — manualmente ou colando um cURL. Veja Ferramentas e Custom Tools.
Regras por ferramenta
Cada ferramenta aceita regras em texto ("Regras de [nome da integração]"), dizendo ao agente quando usá-la e o que nunca fazer com ela. Exemplo:
Só agende em dias úteis, das 9h às 18h.
Sempre confirme o e-mail do cliente antes de criar o evento.
Essas regras entram no contexto do agente junto com a descrição da ferramenta.
Controle de acesso por agente
Cada agente ativa só as ferramentas de que precisa:
- Agente de vendas: criar contato e negociação no CRM
- Agente de suporte: consultar pedido e abrir chamado
- Agente institucional: nenhuma integração
Ferramentas que escrevem (criar, atualizar, excluir) merecem nível de risco confirm, para que o visitante confirme antes da execução. Veja Fila de aprovação.
Onde acompanhar o uso
- Analytics → Qualidade do agente → Ferramentas e integrações — Chamadas, erros, latência média e último uso
- Conversas → Logs — Cada execução, com parâmetros, resposta e a requisição em cURL para reproduzir