Guia: Usar a resposta no seu fluxo
Esta página: https://commentwatchdog.com/pt-BR/help/http-requests/use-the-answer-in-your-flow
Tópico: Requisições HTTP
Tempo: cerca de 4 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 final: Valores da resposta da API usados nas suas próximas mensagens e condições, ou salvos na pessoa para depois.
Contexto: Dê um nome à resposta uma vez, e todo campo que ela devolve pode entrar em mensagens, requisições e condições posteriores por esse nome, como {{order.items[0].name}} ou {{order.$status}}. Teste a requisição de verdade com valores de exemplo e a etapa lista os campos que voltaram com os valores, prontos para inserir. Um valor que vale guardar além desta conversa pode ser salvo no contato: como e-mail, telefone ou nome da pessoa, ou como um campo salvo que execuções e condições futuras também leem.

Antes de começar:
1. O teste faz a chamada real a partir do nosso servidor, com valores de exemplo no lugar das variáveis.
2. Até 30 requisições de teste por minuto por pessoa.
3. A resposta é lida até 512 KB; até 20 valores salvos no contato por etapa.

Passos:
Passo 1 de 4: Dê um nome à resposta e envie uma requisição de teste.
Onde: Na seção Resposta da etapa, abaixo de Headers: Nome da resposta (por exemplo ship), depois Valores de exemplo para as variáveis (por exemplo 80010000 para zip), depois Enviar requisição de teste. Depois que um teste rodou, o botão mostra Testar de novo.
Link: https://app.commentwatchdog.com/pt-BR/inbox (Abra o app)
Captura: https://commentwatchdog.com/media/shots/dm-node-http-more.pt-BR.webp (A seção Resposta: Nome da resposta, o valor de exemplo, Enviar requisição de teste.)
Captura: https://commentwatchdog.com/media/shots/dm-node-http-more-phone.pt-BR.webp (A seção Resposta no celular.)
Você deve ver: Abaixo do botão: o status (200), o tempo que levou e por qual saída ela seguiria, Segue pelo caminho Sucesso ou Segue pelo caminho Falha. Resposta, Headers e O que foi enviado, abaixo dos campos, abrem a resposta bruta e exatamente o que foi enviado.

Passo 2 de 4: Escolha o campo que você precisa em Campos que voltaram.
Onde: Abaixo do resultado, Campos que voltaram lista cada valor da resposta pelo lugar onde ele fica, com o valor embaixo: Código de status 200, cep 80010-000, localidade Curitiba. O botão de copiar de uma linha copia a variável dela, por exemplo {{ship.localidade}}. As etapas seguintes também encontram esses valores no botão de variáveis, em De chamadas de API.
Captura: https://commentwatchdog.com/media/shots/dm-http-test.pt-BR.webp (Campos que voltaram: cada valor da resposta, com copiar e Salvar no contato na linha.)
Captura: https://commentwatchdog.com/media/shots/dm-http-test-phone.pt-BR.webp (O mesmo em um celular.)
Você deve ver: Abaixo da lista: Insira qualquer um depois com o botão de variáveis. Copie um para colar você mesmo. Os campos continuam listados (do último teste) depois que você fecha a etapa.

Passo 3 de 4: Salve um valor no contato, se ele precisar durar além desta conversa.
Onde: Salvar no contato, na linha de um campo, abre quatro opções: O e-mail dela, O telefone dela, O nome dela ou Um campo salvo. O botão da linha passa a mostrar a escolha, e o valor é listado em Salvo no contato, abaixo dos campos, onde você pode mudar o destino ou remover.
Captura: https://commentwatchdog.com/media/shots/dm-http-save.pt-BR.webp (Salvar no contato, aberto em um campo: O e-mail dela, O telefone dela, O nome dela, Um campo salvo.)
Captura: https://commentwatchdog.com/media/shots/dm-http-save-phone.pt-BR.webp (O mesmo em um celular.)
Você deve ver: Em Salvo no contato: o lugar do campo na resposta (localidade), para onde ele vai e Último teste: com o valor que ele leu (Curitiba).

Passo 4 de 4: Use em uma mensagem ou em uma condição.
Onde: Em uma mensagem posterior, aperte o botão de variáveis {x} ao lado de Inserir, abaixo do texto. A lista abre em De chamadas de API: o código de status da resposta (ship.$status, com 200 do último teste) e o valor que você guardou como variável (city). Insira um, por exemplo: Boa notícia! O café chega em {{city}} em 3 a 5 dias úteis. Em uma Condição, confira o valor ou o código de status.
Captura: https://commentwatchdog.com/media/shots/dm-http-use.pt-BR.webp (A mensagem depois de Sucesso, com {{city}} no texto: o botão de variáveis aberto em De chamadas de API.)
Captura: https://commentwatchdog.com/media/shots/dm-http-use-phone.pt-BR.webp (O mesmo em um celular.)
Você deve ver: A mensagem mostra a variável entre chaves duplas, aqui {{city}}, no painel e na etapa; em uma execução de teste, ela mostra o valor real.

Se algo estiver errado:
Problema: Não apareceu no último teste
Solução: O caminho que você salvou não está na resposta mais recente. Teste de novo com valores de exemplo que tragam esse campo.
Problema: Uma mensagem mostra a variável vazia
Solução: O valor é usado antes que a etapa HTTP dele possa ter rodado, ou a requisição seguiu pela saída Falha. O criador avisa quando uma resposta é usada antes da etapa dela.
Problema: Teste a requisição para ver os campos que ela devolve
Solução: Nenhum teste rodou ainda. Preencha os valores de exemplo e aperte Enviar requisição de teste.
Problema: Testes demais em um minuto
Solução: Até 30 testes por minuto por pessoa. Espere um instante e teste de novo.

Perguntas frequentes:
Pergunta: Posso salvar um valor da API no contato?
Resposta: Sim. Salvar no contato, em qualquer campo da resposta: como e-mail, telefone ou nome da pessoa, ou como um campo salvo que execuções e condições futuras também leem.
Pergunta: Uma condição pode conferir a resposta da API?
Resposta: Sim. Todo campo de uma resposta com nome é uma variável que uma Condição pode conferir e, com Conta como sucesso em Qualquer resposta, o código de status também.
Pergunta: A requisição de teste chama a API de verdade?
Resposta: Sim. Ela faz a chamada real a partir do nosso servidor com os seus valores de exemplo e mostra a resposta, os headers e exatamente o que foi enviado, com os segredos mascarados.

Guias relacionados:
- Enviar uma requisição HTTP a partir de um fluxo: https://commentwatchdog.com/pt-BR/help/http-requests/send-an-http-request-from-a-flow
- Campos personalizados: https://commentwatchdog.com/pt-BR/help/people/custom-fields
- Montar a requisição com IA: https://commentwatchdog.com/pt-BR/help/http-requests/build-the-request-with-ai

Texto simples deste guia: https://commentwatchdog.com/pt-BR/help/http-requests/use-the-answer-in-your-flow.md
Todos os guias para assistentes: https://commentwatchdog.com/pt-BR/help/llms.txt