O bloco API Request faz uma chamada HTTP a um sistema externo (CRM, ERP, planilha, serviço de CEP, qualquer API) e traz a resposta para dentro do fluxo, onde ela vira variável. Com ele, o fluxo consulta o status de um pedido, valida um cupom ou registra o lead em outro sistema.
Onde encontrar (caminho até a tela):
- Bloco API Request: Automações › Construtor de fluxo › (abrir o fluxo) › Integrações › API Request
Como configurar
| Campo | Para que serve |
|---|---|
| Método HTTP | GET, POST, PUT, PATCH ou DELETE |
| URL da requisição | O endereço, por exemplo https://api.exemplo.com/pedidos/{{pedido}} |
| Headers (JSON) | Cabeçalhos em JSON, por exemplo a chave de acesso: {"Authorization": "Bearer ..."} |
| Body (JSON) | O corpo da chamada, para POST, PUT e PATCH. Aceita variáveis, por exemplo {"nome": "{{name}}"} |
| Extrair variáveis da resposta | Pares Path JSON e Nome da variável. Se a API devolve { data: { id: 123 } }, use o path data.id e o nome user_id: a partir dali, {{user_id}} vale 123. Use o botão + para mais pares |
| Salvar resposta completa em | Opcional. Guarda a resposta inteira em uma variável |
Botão Testar
O botão Testar faz a chamada de verdade e mostra o resultado (por exemplo Testado com sucesso! Status: 200). Use com cuidado em APIs que criam ou alteram dados, porque o teste executa a chamada.
O que acontece
- O sistema troca as variáveis na URL e no corpo.
- Faz a chamada, esperando no máximo 30 segundos.
- Extrai os valores indicados e os guarda como variáveis do fluxo.
- O fluxo segue para o próximo bloco.
Atenção às variáveis. Na URL e no corpo, são trocadas as variáveis
{{name}},{{number}},{{email}}e as variáveis do fluxo. Os headers não recebem variáveis. As variáveis de sistema, como{{firstName}}ou{{ms}}, não são trocadas neste bloco.
Erros não aparecem. Se a API falhar (fora do ar, resposta de erro, tempo esgotado), o fluxo continua normalmente e as variáveis ficam vazias. Quando o próximo passo depende da resposta, use uma Bloco Condição logo depois para tratar o caso de variável vazia.
Exemplo: consultar o status de um pedido
- Bloco Bloco Pergunta: Qual o número do pedido?, salvando em
pedido. - Bloco API Request: GET em
https://api.exemplo.com/pedidos/{{pedido}}, extraindostatuspara a variávelstatusPedido. - Bloco de conteúdo:
O status do seu pedido é: {{statusPedido}}.
Perguntas frequentes
A variável saiu vazia.
Confira o path JSON (diferencia maiúsculas e minúsculas), se a API respondeu com sucesso e se o bloco Pergunta anterior gravou o dado usado na URL.
Preciso de uma chave de acesso.
Coloque nos Headers, em JSON. Como os headers não aceitam variáveis, use uma chave fixa da sua empresa.
Dá para enviar o nome do cliente?
Sim, no corpo ou na URL: {{name}}.
O que fazer se a API demora?
O limite é 30 segundos. Passado isso, o fluxo segue sem a resposta.
Meus dados ficam seguros?
As chaves que você escreve nos headers ficam gravadas no fluxo. Use chaves com permissões mínimas.