Todos os blocos até aqui trabalham dentro da Heyoo. Este sai para fora: chama uma API externa no meio da conversa e traz a resposta para o fluxo. É o bloco que consulta um pedido no seu sistema, checa um CPF ou busca um horário na agenda.

Painel do nó Requisição HTTP com método e URL — Método e URL — e a URL aceita variáveis do fluxo.

Método e endereço

GET — buscar informação
POST — criar
PUT — alterar
DELETE — apagar

A URL aceita variáveis do fluxo, e é isso que a torna útil: .../pedidos/{{{numero_pedido}}} coloca na consulta o número que a pessoa digitou.

Cabeçalhos e corpo

Nos cabeçalhos vai a autenticação da sua API; no corpo vai o que você envia — e ele só faz sentido em POST e PUT. Os dois também aceitam variáveis.

Os dois campos são JSON — e JSON não perdoaUma vírgula sobrando e a chamada nem sai. É a origem mais comum de “o bloco não faz nada”.

Trazer a resposta para o fluxo

Chamar a API sem guardar o retorno não serve para nada. O mapeamento tem duas colunas: o nome da variável que você quer criar e onde achar o valor na resposta — o caminho usa ponto, como body.user.name. Cada linha vira uma variável disponível em todos os blocos seguintes.

Editor de mapeamento da resposta em variáveis — Sem esse mapeamento, a resposta chega e se perde.

API fora do ar não trava o fluxo — e esse é o problemaSe o outro sistema falhar, o fluxo segue para o próximo bloco com as variáveis vazias. Coloque uma Condição logo depois checando se a variável veio preenchida: sem isso, o cliente recebe uma mensagem com campo em branco.

Antes de escrever URL na mão, olhe os templatesOs fluxos do GestoDentis, do Guia Odonto e do TikTok Shop já vêm com esses nós montados, apontando para as pontes da própria Heyoo e com a chave injetada no import. Escrever do zero só vale quando o sistema é seu e não tem conector pronto.