Enviar uma requisição HTTP a partir de um fluxo

Para agentes

Guia: Enviar uma requisição HTTP a partir de um fluxo

Esta página: https://commentwatchdog.com/help/http-requests/send-an-http-request-from-a-flow

Tópico: Requisições HTTP

Tempo: cerca de 5 minutos

Quem pode fazer: Proprietário, Administrador ou Gerente

Autor: https://anantgupta.xyz (Anant Gupta, fundador do CommentWatchDog)

Comece no app: https://app.commentwatchdog.com/pt-BR/inbox

Resultado ao terminar: Seu fluxo envia dados para outro sistema, ou lê dados dele, e segue pela saída Sucesso ou Falha.

Contexto: A etapa Requisição HTTP chama a API de outro sistema no meio de uma conversa: consultar um pedido, conferir um código postal, mandar um novo lead para o seu CRM. Ela roda em qualquer ponto de um fluxo, no Instagram e no Facebook. Um só formulário reúne tudo: o método e o endereço, a autenticação, um body, parâmetros de consulta e headers, com tudo o que você sabe da pessoa preenchido por variáveis. Uma resposta boa segue por Sucesso; um erro, um timeout ou nenhuma resposta segue por Falha, e assim a pessoa nunca fica esperando.

Antes de começar

1. A etapa Requisição HTTP vem com o criador de fluxos, no Starter e acima (e no passe de DM de 7 dias no Mini e no Lite).

2. A etapa só chama para fora: outros sistemas não conseguem chamar um fluxo.

3. A autenticação é um Bearer token, Basic auth ou uma chave de API; as chaves são salvas criptografadas e nunca mais exibidas.

Etapas

Passo 1 de 5: Adicione uma etapa Requisição HTTP.

Onde: Abra o fluxo no canvas. No painel Etapas, à esquerda, digite HTTP em Buscar etapas e arraste Requisição HTTP para o canvas, ou clique nela para adicionar depois da etapa selecionada. No celular, Adicionar etapa, depois Requisição HTTP.

Link: https://app.commentwatchdog.com/pt-BR/inbox (Abra o app)

Captura de tela: https://commentwatchdog.com/media/shots/dm-node-http.pt-BR.webp (A etapa Requisição HTTP no canvas, com as configurações abertas à direita.)

Captura de tela: https://commentwatchdog.com/media/shots/dm-node-http-phone.pt-BR.webp (As configurações da etapa no celular.)

Você deve ver: A etapa no canvas com duas saídas, Sucesso e Falha, e as configurações abertas ao lado.

Passo 2 de 5: Escolha o método e digite o endereço.

Onde: Em Endereço, perto do topo das configurações: o método à esquerda (GET, que abre em POST, PUT, PATCH e DELETE), depois o campo de endereço, depois o botão de variáveis {x}, que insere valores que mudam a cada pessoa, por exemplo https://viacep.com.br/ws/{{zip}}/json/. Uma variável no endereço é codificada para você.

Captura de tela: https://commentwatchdog.com/media/shots/dm-node-http.pt-BR.webp (O endereço, com a variável {{zip}} dentro; o método à esquerda, o botão de variáveis à direita.)

Captura de tela: https://commentwatchdog.com/media/shots/dm-node-http-phone.pt-BR.webp (O mesmo em um celular.)

Você deve ver: A etapa no canvas mostra o método e o endereço.

Passo 3 de 5: Preencha o que a API pede: autenticação, body, parâmetros, headers.

Onde: O formulário continua abaixo do endereço, uma seção depois da outra. Autenticação: Sem autenticação, Bearer token, Basic auth ou Chave de API (enviada em um header ou na query string). Body (não vale para GET; um GET envia os valores como parâmetros de consulta): JSON com até 40 campos, cada um enviado como Texto, Número, Verdadeiro/falso ou JSON (um ponto na chave cria um nível dentro do outro), Formulário, Bruto (JSON, texto simples ou XML) ou Nenhum. Parâmetros de consulta: até 20 linhas, adicionadas ao endereço como chave=valor. Headers: até 20 linhas; tranque uma linha para manter o valor em segredo. Enviar esta linha desliga uma linha sem apagá-la.

Captura de tela: https://commentwatchdog.com/media/shots/dm-node-http.pt-BR.webp (Autenticação, a primeira seção abaixo do endereço.)

Captura de tela: https://commentwatchdog.com/media/shots/dm-node-http-phone.pt-BR.webp (O mesmo em um celular.)

Você deve ver: Cada seção vai sendo preenchida: Adicionar um parâmetro e Adicionar um header contam as linhas (0/20, 1/20). Uma chave que você digita é salva criptografada e depois aparece como Salvo e oculto, com Substituir.

Passo 4 de 5: Abra Mais opções para o sucesso, o limite de tempo e as novas tentativas.

Onde: Mais opções, recolhido no fim do formulário; a linha mostra as escolhas atuais (por exemplo Só uma resposta 2xx · 8 s · Uma vez). Conta como sucesso: Só uma resposta 2xx, ou Qualquer resposta (aí confira o código de status em uma Condição). Limite de tempo: 3, 5, 8 ou 10 s (8 por padrão). Tentar de novo em caso de erro: Não tentar de novo, Uma vez ou Duas vezes, quando não há resposta ou vem um 5xx, só para requisições que podem ser enviadas duas vezes sem risco.

Captura de tela: https://commentwatchdog.com/media/shots/dm-node-http-more.pt-BR.webp (Mais opções, no fim do formulário, com as escolhas atuais na mesma linha.)

Captura de tela: https://commentwatchdog.com/media/shots/dm-node-http-more-phone.pt-BR.webp (O mesmo em um celular.)

Você deve ver: A linha de Mais opções mostra o que você escolheu.

Passo 5 de 5: Conecte Sucesso e Falha.

Onde: Arraste do ponto de Sucesso até a próxima etapa (uma mensagem que usa a resposta), e de Falha até o que deve acontecer no lugar (avisar sua equipe, passar para uma pessoa ou uma mensagem gentil). No celular, escolha cada etapa em Próximos passos, no fim das configurações. Uma saída Falha sem nada conectado encerra a execução como falha, e a barra avisa você.

Captura de tela: https://commentwatchdog.com/media/shots/dm-node-http.pt-BR.webp (As duas saídas da etapa, Sucesso e Falha, cada uma conectada à sua próxima etapa.)

Captura de tela: https://commentwatchdog.com/media/shots/dm-node-http-more-phone.pt-BR.webp (No celular: Sucesso e Falha em Próximos passos, cada uma com a etapa a que leva.)

Você deve ver: As duas saídas conectadas; a barra mostra Pronto para ativar quando não sobra nada para corrigir.

Se algo estiver errado

Problema: Bloqueada

Solução: O endereço aponta para dentro de uma rede privada (ou para loopback ou um endereço de metadados de nuvem), então é recusado por segurança. Use o endereço público da API.

Problema: Tempo esgotado

Solução: A API demorou mais que o limite de tempo definido em Mais opções (10 segundos no máximo). A execução seguiu pela saída Falha.

Problema: Pausado após falhas

Solução: O endereço falhou 5 vezes seguidas, então as chamadas ficam pausadas por um minuto e depois são tentadas de novo.

Problema: Endereço inválido

Solução: O endereço não é um link http ou https válido depois de preencher as variáveis. Confira se a variável tem valor neste ponto do fluxo.

Perguntas frequentes

Pergunta: Um fluxo pode chamar qualquer API?

Resposta: Sim, qualquer API acessível na internet pública com GET, POST, PUT, PATCH ou DELETE, sem autenticação, com Bearer token, Basic auth ou uma chave de API. Endereços dentro de redes privadas são recusados por segurança.

Pergunta: Outro sistema pode enviar dados para dentro de um fluxo?

Resposta: Não. A etapa Requisição HTTP só chama de dentro do fluxo para fora; não existe webhook de entrada que inicie ou alimente um fluxo.

Pergunta: Qual é o tempo máximo que uma requisição HTTP pode esperar?

Resposta: 10 segundos, o máximo que o limite de tempo permite (8 por padrão). As pessoas estão no meio do chat, então quanto menos espera, melhor.

Pergunta: Minhas chaves de API estão seguras?

Resposta: Os valores de autenticação e qualquer linha marcada como segredo são criptografados quando você salva, vinculados à sua conta e nunca mais exibidos, nem no histórico de execuções.

Guias relacionados

Usar a resposta no seu fluxo: https://commentwatchdog.com/help/http-requests/use-the-answer-in-your-flow

Colar um comando cURL: https://commentwatchdog.com/help/http-requests/paste-a-curl-command

Montar a requisição com IA: https://commentwatchdog.com/help/http-requests/build-the-request-with-ai

Texto simples deste guia: https://commentwatchdog.com/help/http-requests/send-an-http-request-from-a-flow.md

Todos os guias para assistentes: https://commentwatchdog.com/help/llms.txt