Onde fica: Configuração › Integrações
Integrações reúne três abas com finalidades diferentes: Agente, Extração de dados e WhatsApp. Este artigo cobre a aba Agente. Nela você conecta APIs REST externas para seu agente consultar dados ou executar ações durante a conversa, além do que ele já faz no seu CRM. Os nomes das outras duas abas confundem: Extração de dados sugere puxar informação de fora pra dentro da Academia, e WhatsApp sugere configuração ligada ao canal. O que este artigo cobre, porém, é a aba Agente.
O que uma integração é
Uma integração é a conexão em si: um endereço base e uma forma de autenticação, como Bearer Token. Ela não faz nada sozinha: é a porta de entrada por onde passam os endpoints que você cria dentro dela.
- Abra Configuração › Integrações, na aba Agente.
- Clique em Nova API e informe nome, URL base e tipo de autenticação.
- Clique em Testar conexão antes de seguir.
- Abra Endpoints pra criar as ações que seu agente vai poder chamar.
Cada integração mostra a URL base, o tipo de autenticação e um resumo de estado: quantos endpoints existem, quantos estão ativos e quantos ainda faltam configurar.
Qual caminho escolher pra manter seus dados atualizados
Existem três jeitos de trazer o que você vende pra dentro da Academia, e cada um tem seu custo.
Integração direta com o sistema que você já usa é o destino ideal: atualizou lá, vale aqui, sem digitação dupla. É o que este artigo ensina a montar, sempre feito junto com o time da Interage.
Planilha no formato da plataforma funciona hoje e é simples de montar, mas exige disciplina: alguém precisa lembrar de atualizar ela toda vez que algo muda. Datasets explica como importar uma planilha pronta.
O site como fonte funciona bem quando ele já é atualizado por obrigação, porque nesse caso ele nunca fica pra trás da realidade.
De endpoint a ferramenta do agente
Cada endpoint que você cria vira uma ferramenta que seu agente pode chamar numa conversa real. Alguns dados desse endpoint você fixa uma vez: um remetente, um tipo de mensagem. Outros vêm do contato ou da conversa em cada chamada, como o e-mail de quem está falando.
| Campo | O que é |
|---|---|
| Nome | Identifica o endpoint pra você, dentro da Academia |
| Nome da ferramenta | O nome que seu agente vê e usa pra chamar essa ação |
| Método e caminho | A chamada HTTP que acontece por trás, na API externa |
| Parâmetro fixo | Valor que não muda: você define uma vez, na configuração |
| Parâmetro dinâmico | Valor que vem do contato ou da conversa a cada chamada |