Skip to main content
As conexões de API são funções HTTP personalizadas que seus agentes podem chamar durante uma conversa — consultar um pedido, criar um ticket, buscar o status de uma conta no seu próprio backend. Você define o endpoint uma vez em Conexões → APIs (/dashboard/api-connections); os agentes que tiverem a conexão anexada poderão invocá-la sempre que a conversa exigir. Há duas formas de criar uma: cole algo que o assistente possa analisar ou configure a conexão manualmente.

​
O caminho rápido: colar e analisar

1

Clique em Nova conexão de API

A caixa de diálogo é aberta no assistente. Cole uma comando cURL de exemplo, uma especificação OpenAPI/Swagger, uma exportação do Postman, uma interface TypeScript ou um schema Zod na caixa.
2

Clique em Analisar

O ThunderPhone infere toda a conexão a partir do conteúdo colado — URL, método, cabeçalhos e um schema de parâmetros derivado dos parâmetros de consulta e do corpo da solicitação encontrados. Os cabeçalhos que você colou (incluindo cabeçalhos de autenticação) são incluídos na configuração do endpoint.
3

Confirme os campos destacados

A configuração inferida é aberta com os campos estimados destacados para revisão. Ajuste nomes, descrições e tipos de parâmetros para que o agente entenda quando e como chamar a função — a descrição é o que o modelo lê.
4

Validar e salvar

Ao salvar, uma solicitação de teste ao vivo é executada primeiro no seu endpoint. Se a solicitação falhar, a conexão não será salva — corrija a URL, os cabeçalhos de autenticação ou o corpo e tente novamente. Em caso de sucesso, a conexão é armazenada com o selo Validada.
Se o assistente não conseguir encontrar uma URL de solicitação no conteúdo colado, ele informará isso — inclua um endpoint http(s) completo e tente novamente.

​
Configuração manual

Clique em Configurar manualmente → no assistente (ou em Quer que a IA infira isso? Tentar o assistente → para voltar). O criador manual tem dois editores:
  • Visual — campos de formulário para o nome de exibição, nome da função, URL da solicitação, método (POST, GET, PUT, PATCH, DELETE), cabeçalhos personalizados e o schema de parâmetros (Adicionar propriedade para cada argumento que o agente pode fornecer).
  • JSON — a mesma definição como JSON bruto, para colar ou ajustar diretamente uma especificação de ferramenta.
Um painel de Solicitação de teste (opcional) permite enviar a solicitação configurada antes de salvar e mostra o status, a latência e uma prévia da resposta. Validar e salvar sempre executa esse teste e só salva em caso de sucesso.
Dê aos parâmetros descrições em linguagem simples (“Endereço de e-mail do cliente, por exemplo, jane@example.com”). O agente escolhe argumentos com base nessas descrições em tempo real, durante a chamada.

​
Gerencie suas conexões

Cada linha de conexão mostra seu status de validação — Validada, Não testada ou Erro — seu nome de função e quais agentes a utilizam. No menu de ações da linha, você pode:
  • Editar — reabrir a configuração.
  • Clonar — duplicá-la como ponto de partida (a cópia começa como Não testada).
  • Histórico de revisões — visualizar versões anteriores e restaurar uma no editor.
  • Transferir — copiar ou mover a conexão para outra organização à qual você pertence. Mover a remove daqui; os agentes que a utilizavam podem precisar de reconfiguração.
  • Excluir — permanente; os agentes que usam a conexão precisarão ser reconfigurados.

​
Anexe-a a um agente

Adicione a conexão a um agente na seção de conexões de API do criador (Criar um agente). A lista mostra quais agentes usam cada conexão, para que você veja rapidamente o que uma alteração afeta.

​
Próximas etapas

Integrações de ferramentas via API

Crie e gerencie as mesmas conexões de forma programática.

Conectar apps

Conexões pré-criadas para Google, Slack, HubSpot, Salesforce e Cal.com.

Adicionar um servidor MCP

Exponha um servidor de ferramentas inteiro aos seus agentes.

Referência da API de integrações

Todos os campos do recurso de integração.