Um agente que só conversa não resolve nada. As APIs REST do seu ERP, do prontuário ou do sistema de pedidos viram ferramentas que ele chama durante a conversa — e a Hal-AI expõe a própria API pública para que o seu time construa por cima da plataforma.
Sem conector proprietário: se o sistema tem API REST, ele entra.
Três caminhos de integração
🔌
API do seu sistema
Endpoint, cabeçalhos de autenticação e descrição — e o agente passa a consultar e agir ali.
🧩
Servidores MCP
Model Context Protocol configurado por agente, ao lado das APIs REST cadastradas.
🛠️
API pública Hal-AI
REST versionada, autenticada por chave, com escopos por recurso e documentação OpenAPI.
Ferramentas do agente
As APIs do seu sistema viram ferramentas do agente
O agente não recebe um script de integração. Ele recebe uma lista de ferramentas com descrição em texto e decide, a cada turno da conversa, qual chamar — se é que precisa chamar alguma.
O que se cadastra
O endpoint — a URL da chamada REST no seu ERP, prontuário, sistema de pedidos ou sistema interno.
Os cabeçalhos de autenticação — o que o seu sistema exige para aceitar a requisição.
A descrição — em português, o que aquela chamada faz e quando faz sentido usá-la. É por essa descrição que o agente escolhe a ferramenta.
O que muda na conversa
O cliente pergunta pelo pedido; o agente consulta o sistema de pedidos e responde com o dado real. O paciente pede um horário; o agente consulta a agenda e devolve o que existe. Não há desvio dentro de um fluxo: a consulta é uma ação do agente, como qualquer outra.
O gestor registra o endpoint, a autenticação e a descrição da ferramenta dentro da configuração daquele agente.
2
O agente passa a enxergar a ferramenta
A ferramenta entra na lista daquele agente — não da plataforma inteira. Cada agente carrega o próprio conjunto.
3
Consulta e ação durante o atendimento
O agente decide chamar, lê a resposta do seu sistema e continua a conversa com o dado em mãos.
Não é chatbot com fluxo. É um agente operacional treinado para trabalhar.
Importador de endpoints
A integração começa por uma conversa, não por um projeto
Cadastrar dezenas de endpoints à mão é trabalho de integrador. A Hal-AI resolve isso com uma ferramenta que lê a documentação da fonte, lista o que existe e implementa as ferramentas — conversando com o gestor a cada passo.
1
Aponte a fonte
O gestor indica a documentação da API que quer conectar. O Squad lê a fonte no lugar de alguém abrir a documentação linha por linha.
2
Veja os endpoints listados
O Squad devolve a lista dos endpoints disponíveis. O gestor pergunta o que quiser sobre qualquer um deles e recebe o detalhamento em texto.
3
Escolha o que entra
Nem tudo que a documentação expõe deveria virar ferramenta do agente. O gestor decide o recorte — o que consultar, o que pode agir, o que fica de fora.
4
As ferramentas são implementadas
O Squad implementa as ferramentas escolhidas e elas passam a existir para o agente. O que era um projeto de semanas vira uma conversa.
Terminado o importador, é assim que o recorte escolhido aparece dentro da configuração do agente: cada endpoint aprovado vira uma ferramenta com nome, método, caminho e estado próprio. Ao lado ficam os servidores MCP conectados àquele agente e as ferramentas nativas da plataforma que estão ligadas para ele. O que ficou de fora do recorte continua listado, apagado, para que ninguém precise adivinhar por que o agente não consegue fazer aquilo.
Hal-AI · Ferramentas e APIs do agenteConfiguração
Agente Logística · Transportes MeridianoFerramentas disponíveis para este agente durante a conversa — endpoints do sistema, servidores MCP e recursos nativos.+ Importar endpoints
Buscar ferramenta por nome ou rota…Todas 5Ativas 3Fora do recorte 1
Endpoints importados e transformados em ferramentas do agente
Ferramenta
Método e caminho
Estado
api_get_pedido
GET /pedidos/{numero}
Ativa
api_get_rastreio_rota
GET /rotas/{rota}/rastreio
Ativa
api_get_janela_entrega
GET /entregas/janelas
Ativa
api_post_reagendamento
POST /entregas/reagendar
Em teste
api_del_pedido
DELETE /pedidos/{numero}
Fora do recorte
AutenticaçãoCabeçalho por ambiente — guardado na plataforma, nunca no texto do prompt.
Descrição de api_get_rastreio_rotaConsulta a posição atual e o próximo ponto de parada de uma rota.
Use quando o cliente perguntar onde está a entrega dele.
Nunca prometa horário que não esteja na resposta da rota.É por essa descrição em português que o agente decide chamar a ferramenta — não há fluxo nem palavra-chave por trás.
Servidores MCP conectados
Vinculados a este agente, não à conta inteira. As ferramentas que cada servidor expõe entram na mesma lista.
Pergunta do cliente sobre o Pedido 4471: o agente leu a rota, viu a janela de entrega e respondeu com o dado do sistema.
O que você está vendo
No alto, a aba APIs aberta dentro da configuração de um único agente, ao lado de Personalidade, Memória e MCPs. A faixa azul logo abaixo é o rastro do importador: 24 rotas lidas na documentação, 5 implementadas, com o nome das duas ferramentas que o Squad usou para chegar lá. Cada linha da tabela é uma ferramenta com método, caminho e estado — ativa, em teste ou fora do recorte — e, abaixo dela, o campo de autenticação e a descrição em português que o agente lê antes de decidir chamar aquela rota.
A vantagem
Tudo o que aquele agente alcança cabe em uma tela só: dá para conferir o inventário sem abrir código nem um console de integração à parte, e para ver antes da conversa que o reagendamento ainda está em teste. A credencial fica guardada na plataforma e não no texto do prompt, então girar uma chave deixa de ser reescrita de instrução. E os servidores MCP e as ferramentas nativas aparecem na mesma coluna, sem precisar cruzar duas configurações para descobrir por que o agente não conseguiu fazer alguma coisa.
Só na Hal-AI
Essa lista não foi montada por um integrador: um Squad leu a documentação, listou as rotas e implementou as que o gestor aprovou conversando — a mesma auto-configuração com que ele ajusta contexto, conhecimento e agenda de si mesmo. E o recorte que sai da conversa é uma allowlist: o DELETE que existe na API do cliente continua listado e desligado, porque nunca virou ferramenta. Numa automação de fluxo, cada chamada é desenhada à mão no editor, e o que ninguém desenhou também não aparece para ninguém ver.
Além das APIs REST cadastradas uma a uma, a plataforma aceita servidores MCP. As ferramentas que o servidor expõe ficam disponíveis para aquele agente durante a conversa.
Por agente, não por conta — o agente de vendas e o agente de pós-venda podem ter servidores diferentes.
Convive com as APIs REST — o agente escolhe entre as duas origens de ferramenta pelo que a tarefa pede.
Padrão aberto — se o seu time já mantém um servidor MCP para uso interno, ele serve aqui.
🧩
Servidores MCP
Configuração por agente, ferramentas expostas pelo servidor.
🔌
APIs REST
Endpoints do seu sistema com autenticação e descrição.
🌐
Leitura de web
O agente abre uma página e usa o conteúdo na resposta.
🔎
Pesquisa na internet
Busca como ferramenta, quando a resposta não está na empresa.
API pública Hal-AI
A plataforma inteira também é uma API
A via contrária da integração: em vez do agente chamar o seu sistema, o seu sistema comanda a plataforma. A API pública é REST, versionada em /api/v1 e autenticada por chave.
Como a API se comporta
Versionada — o caminho carrega a versão, para que uma evolução da plataforma não quebre a sua integração de ontem.
Escopos por recurso — cada chave habilita apenas os recursos que você marcar. Uma chave de leitura de relatórios não envia mensagem.
Chave de idempotência nos envios — repetir a mesma requisição por causa de um timeout não gera duas mensagens para o cliente.
Envelope de resposta padronizado e paginação — o mesmo formato em todos os recursos, com paginação nas listagens.
Rate limit por chave — o limite acompanha a chave, e não a conta inteira.
Documentação OpenAPI/Swagger publicada — as telas de Chaves de API e de Documentação ficam dentro do console, restritas ao administrador da empresa.
A empresa da chave é sempre a da chave: não existe parâmetro de empresa que possa ser forjado numa requisição.
Hal-AI · Chaves de API e documentaçãoConsole da empresa
Chaves de API · Transportes MeridianoTela restrita ao administrador da empresa. Cada chave habilita apenas os escopos marcados e carrega o próprio limite de requisições.+ Nova chave
Chaves de APIDocumentação
API pública v1Especificação OpenAPI publicada no consoleAbrir documentaçãobase /api/v1 · envelope { data, meta } · paginação nas listagens
Chave integracao-erpclientes:lermensagens:enviaratendimento:transferirequipe:escreverEscopos por recurso: o que não foi marcado é recusado, mesmo que o caminho exista na documentação.
Chave painel-diretoriarelatorios:lermensagens:enviarcampanhas:escreverUma chave de leitura de relatórios não envia mensagem. O limite de requisições acompanha a chave, e não a conta inteira.
Chamadas recentes à API pública, com método, caminho, chave usada, status e tempo de resposta
Método e caminho
Chave
Status
Tempo
POST /api/v1/mensagens
integracao-erp
201
128 ms
POST /api/v1/mensagens
integracao-erp
200 repetida
34 ms
GET /api/v1/clientes?pagina=2
integracao-erp
200
96 ms
GET /api/v1/relatorios/consumo
painel-diretoria
200
210 ms
POST /api/v1/campanhas
painel-diretoria
403 escopo
18 ms
POST /api/v1/squads/{squad}/executar
integracao-erp
202 em execução
72 ms
201 POST /api/v1/mensagens Idempotency-Key: aviso-pedido-4471
09:41:02POST /api/v1/mensagens — chave integracao-erp09:41:02{ "data": { "id": "msg_8f21", "estado": "enfileirada" },09:41:02 "meta": { "requisicao": "req_2c90", "repetida": false } }09:41:07Mesma chave de idempotência reenviada — devolveu msg_8f21, "repetida": true09:42:15403 — a chave painel-diretoria não tem o escopo campanhas:escrever
O mesmo envelope em todos os recursos v1
Servidores MCP conectados
O caminho de ida: enquanto o seu sistema comanda a plataforma pela API pública, os agentes alcançam ferramentas externas por servidores MCP vinculados a cada agente.
A tela de Chaves de API do console, aberta ao lado da aba de Documentação. Em cima, duas chaves da mesma empresa com escopos diferentes: uma integração de ERP que lê clientes e envia mensagem, e uma chave de diretoria que só puxa relatórios. Embaixo, as chamadas recentes com método, caminho, chave, status e tempo — e um exemplo de resposta com o envelope data e meta.
A vantagem
O escopo é conferido na chave, não na intenção de quem chama: a tentativa de criar campanha com a chave de relatórios volta 403 em 18 ms e fica registrada na mesma lista. E a chave de idempotência resolve o problema clássico do envio: o reenvio depois de um timeout devolveu o mesmo msg_8f21 com "repetida": true, em vez de mandar duas mensagens para o cliente.
Só na Hal-AI
A última linha da lista é o que quase nenhuma API de atendimento expõe: POST /api/v1/squads/{squad}/executar. O seu sistema não dispara apenas uma mensagem — ele aciona um agente-mestre e acompanha a execução, os logs e o desfecho que o próprio Squad declarou ao terminar.
O que uma chave alcança
Recursos expostos pela API pública Hal-AI e o que cada um permite
Recurso
O que a chave permite fazer
Canais
Listar e criar canais da empresa.
Clientes e mensagens
Ler clientes e o histórico de mensagens.
Envio
Enviar mensagem e template, com chave de idempotência.
Atendimento
Transferir e encerrar chat, ligar e desligar o bot.
Equipe
Gerenciar filas, operadores e supervisores.
Campanhas
Criar campanhas e acompanhar o andamento.
Conteúdo
Gerir templates oficiais e respostas rápidas.
Relatórios
Puxar relatórios e consumo.
Squads
Disparar um Squad e acompanhar a execução, os logs e o desfecho declarado por ele.
Já vem conectado
As integrações que a plataforma já traz de fábrica
Antes de qualquer integração sua, a Hal-AI já conversa com a infraestrutura que sustenta o atendimento: canal oficial, e-mail, telefonia, cobrança e notificação no navegador.
Meta / WhatsApp Cloud APIMeta Embedded SignupAWS SESStripeAsterisk / SIPWeb PushServidores MCPAPIs REST do clienteLeitura de webPesquisa na internet
💬
Meta / WhatsApp Cloud API
Envio de mensagem, mídia, opções interativas, contato e localização; templates oficiais; qualidade e saúde do número. A ativação de WABAs e telefones passa pelo Embedded Signup da Meta.
Esta é a lista do que existe hoje na plataforma. Qualquer outro sistema entra pelo caminho das APIs REST cadastradas como ferramenta ou por um servidor MCP.
Perguntas frequentes
O que costumam perguntar sobre integração
Preciso de um conector pronto para o meu sistema?
Não. Se o seu sistema expõe uma API REST, ela vira ferramenta do agente: você cadastra o endpoint, os cabeçalhos de autenticação e a descrição do que aquela chamada faz. Não existe uma lista fechada de sistemas suportados — ERP, prontuário e sistema de pedidos entram pelo mesmo caminho.
O que é o importador de endpoints?
É uma ferramenta que lê a documentação de uma fonte, lista os endpoints disponíveis e implementa as ferramentas correspondentes. O Squad faz isso conversando com o gestor: ele detalha cada endpoint encontrado e o gestor decide o que entra para o agente e o que fica de fora.
A Hal-AI suporta servidores MCP?
Sim. Servidores Model Context Protocol são configurados por agente, e as ferramentas que o servidor expõe passam a ficar disponíveis para aquele agente durante a conversa, ao lado das APIs REST cadastradas.
A API pública da Hal-AI permite disparar um Squad?
Sim. Além de canais, clientes, mensagens, envio, filas, operadores, campanhas, templates e relatórios, a API pública expõe o disparo de um Squad e o acompanhamento da execução, com os logs e o desfecho declarado pelo próprio Squad. As chaves e a documentação OpenAPI ficam no console, restritas ao administrador da empresa.
Traga a documentação da sua API e a gente mostra o agente usando ela
Nossa equipe conversa sobre os sistemas que o agente precisaria consultar, o que ele poderia executar sozinho e o que deve continuar passando por uma pessoa.