Usar a resposta no seu fluxo

Para agentes

Guia: Usar a resposta no seu fluxo

Esta página: https://commentwatchdog.com/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 terminar: 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.

Etapas

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 de tela: 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 de tela: 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 de tela: 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 de tela: 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 de tela: 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 de tela: 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 de tela: 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 de tela: 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/help/http-requests/send-an-http-request-from-a-flow

Campos personalizados: https://commentwatchdog.com/help/people/custom-fields

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/use-the-answer-in-your-flow.md

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