Acao: Chamada de API / Webhook

Quando usar

Use este node sempre que precisar se comunicar com um sistema externo via HTTP. Exemplos comuns:

• Enviar dados de um formulario para uma API de CRM ou ERP


• Consultar informacoes em uma API externa (cotacao, CEP, status de pedido)


• Disparar uma acao em outro sistema via webhook (ex: criar lead no HubSpot, enviar mensagem no Slack)


• Integrar com qualquer servico que tenha uma API REST

---

Como funciona

O node executa uma requisicao HTTP com o metodo, URL, headers e body que voce configurar. Apos a chamada, os dados de resposta (status, corpo e headers) ficam disponiveis como variaveis para os nodes seguintes.

O fluxo segue pela saida Sucesso* se a requisicao for completada (independente do status HTTP), ou pela saida *Erro se houver falha na conexao.

---

Configuracoes

Metodo HTTP

Define o verbo HTTP da requisicao. Selecione pelo menu dropdown.

| Metodo | Uso tipico |
|--------|-----------|
| GET | Consultar/buscar dados |
| POST | Enviar/criar dados |
| PUT | Substituir um recurso inteiro |
| PATCH | Atualizar parcialmente um recurso |
| DELETE | Remover um recurso |

URL

Endereco completo da API ou webhook de destino. Aceita variaveis dinamicas (ex: `https://api.exemplo.com/users/{{trigger.userId}}`).

Headers

Lista de cabecalhos HTTP personalizados a serem enviados na requisicao. Cada header tem:

• Key -- nome do cabecalho (ex: `Authorization`, `Content-Type`, `X-API-Key`)


• Value -- valor do cabecalho. Aceita variaveis dinamicas.

Use o botao + para adicionar novos headers e o icone de lixeira para remover.

Body (apenas para POST, PUT e PATCH)

Define o corpo da requisicao. Visivel somente quando o metodo nao e GET ou DELETE.

Tipo de Body:

| Tipo | Descricao |
|------|-----------|
| None | Nenhum corpo sera enviado |
| Raw | Corpo em texto livre (JSON ou texto puro) |

Formato Raw:

| Formato | Descricao |
|---------|-----------|
| JSON | Conteudo no formato JSON. Inclui botao "beautify" para formatar automaticamente. |
| Text | Texto livre sem formatacao especifica. |

O campo de body aceita variaveis dinamicas, permitindo inserir dados de nodes anteriores diretamente no corpo da requisicao.

---

Dados de saida

Os nodes seguintes podem acessar os dados retornados pela chamada HTTP:

| Variavel | Tipo | Descricao |
|----------|------|-----------|
| `status` | Numero | Codigo de status HTTP da resposta (ex: 200, 201, 404, 500) |
| `body` | Objeto | Corpo da resposta (JSON parseado automaticamente) |
| `headers` | Objeto | Cabecalhos retornados na resposta |

---

Saidas do node

| Saida | Quando ativa |
|-------|-------------|
| Sucesso | A requisicao foi completada (qualquer status HTTP) |
| Erro | Falha na conexao, timeout ou erro interno |

---

Dicas

• Sempre inclua o header `Content-Type: application/json` ao enviar JSON no body -- muitas APIs exigem isso.


• Use o botao beautify para formatar o JSON do body e facilitar a leitura e edicao.


• Para autenticacao, adicione um header `Authorization` com o valor `Bearer {{seu_token}}` ou o formato exigido pela API.


• Voce pode usar variaveis de nodes anteriores tanto na URL quanto nos headers e no body. Exemplo: `https://api.exemplo.com/pedidos/{{tabela_buscar.rows[0].id}}`.


• Este node pode ser usado como ferramenta do Chatbot IA, permitindo que o agente faca chamadas a APIs externas automaticamente durante uma conversa.


• Para testar, experimente apontar a URL para um servico como webhook.site e verificar se os dados chegam corretamente.