---
title: "Conexões de API"
description: "Transforme qualquer API HTTP em uma função que seu agente pode chamar durante a conversa: cole um comando cURL e o assistente cria a definição da ferramenta, os parâmetros e a autenticação."
---

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 da conta no seu próprio backend. Defina o endpoint uma vez em **Conexões → APIs** (`/dashboard/api-connections`); os agentes que tiverem a conexão vinculada 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

<Steps>
  <Step title="Clique em Nova conexão de API">
    A caixa de diálogo é aberta no assistente. Cole um exemplo de **comando cURL**,
    **especificação OpenAPI/Swagger**, **exportação do Postman**, **interface
    TypeScript** ou **esquema Zod** na caixa.
  </Step>
  <Step title="Clique em Analisar">
    O ThunderPhone infere toda a conexão a partir do que você colou — URL,
    método, cabeçalhos e um esquema 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.
  </Step>
  <Step title="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ê.
  </Step>
  <Step title="Validar e salvar">
    Ao salvar, é executada primeiro uma solicitação de teste em tempo real para o 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 será armazenada
    com o selo **Validada**.
  </Step>
</Steps>

Se o assistente não encontrar uma URL de solicitação no que você colou, 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 isto?
Tente 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 esquema de parâmetros (**Adicionar propriedade** para cada
  argumento que o agente pode fornecer).
- **JSON** — a mesma definição em JSON bruto, para colar ou ajustar
  diretamente uma especificação de ferramenta.

Um painel de **Testar solicitação** (opcional) permite executar 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 salva apenas em caso de sucesso.

Os valores dos cabeçalhos são somente para gravação. Depois de salvos, eles são criptografados e nunca mais exibidos, nem no dashboard nem na API. Ao editar uma conexão, um cabeçalho salvo mostra o nome com pontos no lugar do valor e uma indicação **Salvo**: deixe como está para manter o valor salvo ou digite um novo para substituí-lo. As solicitações de teste e as chamadas ao vivo usam o valor salvo. **Clonar** copia os valores salvos para a nova conexão.

<Tip>
  Forneça descrições em linguagem simples para os parâmetros ("Endereço de e-mail do cliente,
  por exemplo, jane@example.com"). O agente escolhe os argumentos com base nessas
  descrições em tempo real, durante a chamada.
</Tip>

## 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. Movê-la a remove daqui; os agentes que a utilizavam podem precisar
  ser reconfigurados.
- **Excluir** — permanente; os agentes que usam a conexão precisarão ser
  reconfigurados.

## Vincule-a a um agente

Adicione a conexão a um agente na seção de conexões de API do criador
([Criar um agente](/pt/guides/build-an-agent)). A lista mostra quais agentes
usam cada conexão, para que você possa ver rapidamente o que uma alteração afeta.

## Próximas etapas

<CardGroup cols={2}>
  <Card title="Integrações de ferramentas via API" icon="code" href="/pt/guides/build-tool-integration">
    Crie e gerencie as mesmas conexões programaticamente.
  </Card>
  <Card title="Conectar aplicativos" icon="cable" href="/pt/guides/connect-apps">
    Conexões pré-configuradas com Google, Slack, HubSpot, Salesforce e Cal.com.
  </Card>
  <Card title="Adicionar um servidor MCP" icon="server" href="/pt/guides/mcp-servers">
    Exponha um servidor inteiro de ferramentas aos seus agentes.
  </Card>
  <Card title="Referência da API de integrações" icon="book" href="/api-reference/integrations">
    Todos os campos do recurso de integração.
  </Card>
</CardGroup>