Skip to main content
O menu Integrações do painel conecta contas de apps externos ao projeto. São mais de mil apps (Google Agenda, Gmail, HubSpot, Notion, Pipedrive, Calendly…), já integrados à Zatten: não há conta extra para criar nem nada para configurar fora do painel. Depois de conectada, a conta pode ser usada pelo agente como ferramenta: consultar a agenda, criar um negócio no CRM, gravar numa planilha. Esta página cobre a conexão. Escolher as ações e colocá-las no agente está em Integrações como ferramentas do agente.

​
Onde fica no painel

Menu Integrações (/integrations), com o subtítulo “Conecte aplicativos externos para o seu agente usar como ferramentas”. A tela lista os apps com busca (Buscar integração…), filtro por categoria e ordenação (Mais usadas, Nome (A–Z), Conectadas primeiro). Cada card mostra Conectado, Pendente ou Não conectado. Para saber se um app existe, busque pelo nome nessa tela. Não há lista fixa nesta documentação: o catálogo tem mais de mil apps e é atualizado sozinho. Só admin e editor conectam e desconectam.

​
Sem custo e sem limite

As integrações não têm custo nem limite de uso para a agência. Conecte quantos apps quiser em cada projeto, com uma conta por app (por exemplo, um Gmail por projeto).

​
Como conectar

1

Abra o projeto certo

A conexão é do projeto aberto no painel, não da conta da agência. Confira o nome do projeto antes de conectar.
2

Encontre o app

Busque pelo nome em Buscar integração….
3

Clique em Conectar

Há dois jeitos, conforme o app:
  • OAuth: abre uma janela do próprio app (Google, HubSpot…) para o dono da conta entrar e autorizar. Ao fechar, o card passa a mostrar Conectado.
  • Credencial: o card mostra Requer chave de API. Abre um formulário pedindo a chave de API, o token ou usuário e senha do app. Os campos vêm do próprio app.
4

Confira as ações

No card do app, Lista de ferramentas mostra as ações que ele oferece.
5

Coloque as ações no agente

Conectar não basta: adicione as ações no editor do agente (Tools → Adicionar → Aplicativos) e publique a versão. O passo a passo está em Integrações como ferramentas do agente.

​
Desconectar

No card conectado, Desconectar. O agente perde acesso às ações daquele app até a conta ser conectada de novo. No LangChain Agent, as ações do app continuam no agente e o modelo continua vendo-as: quando ele chama uma, a chamada falha e ele recebe o erro. Tire as ações do agente se a conta não vai voltar.

​
Regras da conexão

  • A conta fica presa ao projeto. Cada projeto tem as próprias conexões. Conectar o Google Agenda no projeto A não vale para o projeto B. Um projeto nunca usa a conta de outro.
  • Uma conta por app em cada projeto. Para trocar a conta (outro e-mail, outra empresa), desconecte e conecte de novo.
  • Tentativas antigas que não terminaram (expiradas ou com falha) são limpas quando se conecta de novo.
  • O catálogo é atualizado a cada hora.
  • Ficam fora do catálogo: WhatsApp (o canal já é da Zatten), apps internos do provedor e apps que não pedem autenticação.

​
Pelo MCP

A conexão não viaja no template: ela é uma autorização da conta do cliente final, não configuração. O que viaja são as ações dos apps dentro do bloco langchain. Ao aplicar um template num projeto onde o app não está conectado, as ações entram no agente mesmo assim, e cada chamada falha até alguém conectar a conta pela tela Integrações. Conecte antes de publicar a versão. Conectar é sempre uma pessoa, no painel: o OAuth pede o login do dono da conta. O assistente só guia.

​
Armadilhas

  • Conectar com a conta errada. A conta conectada é a que o agente usa para todos os leads. Conecte com a conta do cliente final (a agenda da clínica), não com a da agência.
  • Projeto errado aberto. A conexão vai para o projeto do painel. Confira o nome antes.
  • Conectar não basta. O agente só usa o app depois de as ações estarem no agente e a versão ser publicada.
  • Token expirado do lado do app. Se o dono trocar a senha ou revogar o acesso, a conexão para de funcionar. Desconecte e conecte de novo.
  • Duplicar ou importar o projeto leva as ações, mas não a conexão. Conecte de novo no projeto novo.

​
Perguntas frequentes

Abra o menu Integrações e busque pelo nome do app. São mais de mil.
Use uma tool HTTP para a API do app (Tools: HTTP).
Não. As integrações já fazem parte da Zatten. Basta conectar a conta do app (o Google, o HubSpot…) na tela Integrações.
Não. Não têm custo nem limite de uso para a agência. Você pode conectar quantos apps quiser no projeto, com uma conta por app (por exemplo, um Gmail por projeto).
Saem os parâmetros que o agente envia na ação para o app (ex.: nome e horário para criar um evento no Google Agenda). Avalie isso com o cliente final, como em qualquer integração.

​
Para saber mais