Integrações

Como funcionam as integrações

Conectar serviços externos aos agentes com segurança — o cofre de credenciais, o modelo de permissões e como desconectar.

Integração é o que transforma um assistente que fala sobre o seu trabalho em um 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.

Conectando

As conexões vivem em dois lugares:

• Nas suas Conexões pessoais — serviços da sua conta (Google Agenda, Drive), disponíveis nas suas conversas.
• Nas Conexões de um agente — serviços conectados a um agente específico, que passam a fazer parte das ferramentas dele. Para agentes de equipe, é assim que o time inteiro se beneficia de uma única conexão.

Na maioria dos serviços a conexão é por OAuth: você é levado à tela oficial do serviço (Google, Notion, Slack…), autoriza lá, e volta — o BXat nunca vê a sua senha. Alguns serviços usam credenciais de API geradas no painel do próprio serviço (caso da VTEX); nesses, o BXat valida a credencial com uma chamada de teste antes de gravar.

Conectar já equipa: serviço conectado a um agente vira ferramenta disponível nas conversas com ele, conforme as permissões e a liberação do ambiente. No Google Ads, as seis alterações por proposta ficam em breve até serem habilitadas. Cada alteração exige revisão e confirmação da pessoa autorizada no card e fica registrada. O acesso pode ser revogado a qualquer momento no Google e na tela de Integrações.

Onde as credenciais ficam

Tokens e chaves vão para um cofre cifrado — criptografia simétrica em repouso, nunca em texto puro no banco. As credenciais só transitam para atender ao que você pedir em conversa, e cada uso de ferramenta fica em registro de auditoria.

O modelo de permissões

• Mínimo necessário: os escopos pedidos são os menores que atendem ao caso de uso — a maior parte das integrações é somente leitura.
• Edição sem destruição: quando um agente tem permissão de escrita (como no Notion), ele pode criar e editar conteúdo, mas operações de exclusão não são disponibilizadas — nem por engano, nem por pedido.
• Orçamento por resposta: há um teto de consultas a serviços externos por resposta, que 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 imediatamente.

E se algo falhar?

Se um serviço conectado estiver fora do ar ou a credencial expirar, o agente diz isso na conversa em vez de inventar uma resposta. Reconectar o serviço resolve a maior parte dos casos.