> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thunderphone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Conexões de API

> Transforme qualquer API HTTP em uma função que seu agente pode chamar durante a conversa — cole um comando cURL e deixe o assistente fazer o resto.

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

<Steps>
  <Step title="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.
  </Step>

  <Step title="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.
  </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, 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**.
  </Step>
</Steps>

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.

<Tip>
  Dê aos parâmetros descrições em linguagem simples ("Endereço de e-mail do cliente,
  por exemplo, [jane@example.com](mailto:jane@example.com)"). O agente escolhe 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. 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](/pt/guides/build-an-agent)). A lista mostra quais agentes
usam cada conexão, para que você veja 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 de forma programática.
  </Card>

  <Card title="Conectar apps" icon="cable" href="/pt/guides/connect-apps">
    Conexões pré-criadas para Google, Slack, HubSpot, Salesforce e Cal.com.
  </Card>

  <Card title="Adicionar um servidor MCP" icon="server" href="/pt/guides/mcp-servers">
    Exponha um servidor de ferramentas inteiro 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>