Integrações
Como funcionam as integrações
Onde conectar (Contas pessoais, Conexões do agente e Integrações do espaço), como as credenciais ficam guardadas, as permissões e como desconectar.
Integração é o que transforma um assistente que fala sobre o seu trabalho num assistente que trabalha com os seus dados: o número real de sessões do site, o card verdadeiro do Notion, o pedido que acabou de entrar na loja.
Três lugares para conectar
| Lugar | Onde fica | Para quê |
|---|---|---|
| Contas pessoais | Menu do usuário → Contas pessoais | As suas contas externas (por exemplo, o seu Notion pessoal). A tela mostra quais agentes usam cada conta. |
| Conexões de um agente | Formulário do agente → Conexões | Serviços ligados a um agente que você criou. A seção aparece depois que o agente existe. |
| Integrações do espaço | Página do espaço → Integrações (ou Ctrl+K → Integrações do espaço) |
Serviços da empresa, usados pelos agentes do espaço. Só o dono e os administradores do espaço conectam; os membros usam. |
As conexões de cada agente que você usa também aparecem em Seus Agentes, no menu do usuário.
A tela de conexões
A tela de Conexões de um agente e a de Integrações do espaço têm a mesma organização, com busca e filtros por categoria:
- Conectadas: os serviços já ligados, em cards com Gerenciar.
- Integrações: conexões nativas do BXat, por login ou por chave. Cada uma traz uma skill que o agente lê.
- Conectores MCP: servidores que publicam as próprias ferramentas para o agente usar.
Os botões mudam conforme o estado: Conectar, Reconectar (quando a credencial expirou), Equipar e Remover (para conectores sem login, como PubMed e bioRxiv). Os que ainda não estão disponíveis aparecem como "em breve".
Gerenciar abre os detalhes da conexão: tipo, login, acesso, como funciona, quando usar, ferramentas, o recurso escolhido (a propriedade do GA4, a conta do Google Ads) e Desconectar, com confirmação.
Como se conecta
- Login (OAuth): Notion, Google Analytics, Google Ads. Você vai à tela oficial do serviço, autoriza lá e volta. O BXat nunca vê a sua senha.
- Chave de API: VTEX. Você gera as credenciais no painel do serviço e o BXat valida com uma chamada de teste antes de salvar.
Alguns serviços pedem um passo a mais depois do login: escolher a propriedade do GA4 (dá para trocar depois com Trocar propriedade) ou a conta de anúncios do Google Ads.
Cada conexão tem um guia que o agente consulta para saber quando e como usar aquele serviço.
Onde as credenciais ficam
Tokens e chaves vão para cofres cifrados, nunca em texto puro no banco. São dois cofres separados: o das suas contas pessoais e o das conexões de cada agente. As credenciais só são usadas para atender ao que você pede em conversa, e cada uso de ferramenta fica registrado.
O modelo de permissões
- Mínimo necessário: os acessos pedidos são os menores que atendem ao caso de uso. A maior parte das integrações é somente leitura.
- Escrita com confirmação: no Notion, o agente só cria ou edita conteúdo depois que você confirma na conversa. Excluir, nunca: operações de exclusão não são oferecidas aos agentes.
- Google Ads: as seis alterações por proposta ficam em breve até serem habilitadas. Quando habilitadas, cada alteração exige revisão da pessoa autorizada, que clica em Confirmar no card, e fica registrada. O acesso pode ser revogado a qualquer momento no Google e na tela de Integrações.
- Orçamento por resposta: o agente faz no máximo 4 consultas a conectores por resposta. Isso mantém as conversas rápidas e o uso das APIs sob controle.
Desconectando
Qualquer conexão pode ser desfeita a qualquer momento, na mesma tela em que foi criada. Desconectar apaga as credenciais do cofre, e o agente perde a ferramenta na hora. Em Contas pessoais, a confirmação mostra quais agentes deixam de usar a conta.
E se algo falhar?
Se um serviço estiver fora do ar ou a credencial expirar, o agente diz isso na conversa em vez de inventar uma resposta. Reconectar resolve a maior parte dos casos.