Como configurar blocos de requisição http
O bloco Requisição HTTP permite que o robô se conecte diretamente a APIs externas para enviar ou buscar informações durante o fluxo. Com ele, o bot consegue integrar-se a sistemas internos e externos e qualquer serviço que disponibilize uma API.
O que é possível fazer com blocos de requisição http:
Realizar chamadas HTTP nos seguintes métodos:
GET - pedir informações;
POST - enviar novo item;
PUT - substituir ou atualizar tudo;
DELETE - remover item.
Utilizar variáveis do bot em qualquer campo da requisição (URL, headers, parâmetros ou body).
Transformar a resposta da API em novas variáveis para uso em blocos seguintes.
Criar condições baseadas:
no status da resposta (ex.: 200, 400, 404 etc.)
no conteúdo retornado (ex.: campos específicos do JSON)
Selecionar quantidade de tentativas em caso de falha e tempo de timeout.
Como configurar blocos de requisição http
No Menu Principal, acesse Mais opções > Robôs.
Crie um novo Robô em + Adicionar > Fluxograma ou utilize um robô fluxograma já existente, clicando nos três pontinhos (⋮) > Editar
Dentro do construtor, no canto esquerdo, vá até a seção Automações e selecione o bloco Enviar Requisição HTTP (logo abaixo de “Enviar webhook”).
A primeira etapa da configuração do bloco é constituída em três áreas principais:
Configurações básicas:
Nome da requisição - Identifica essa requisição dentro do robô (especialmente útil quando você tem várias chamadas diferentes);
URL do endpoint - Endereço da API que será acessada.
A URL não é validada no momento da configuração. Se estiver errada, a requisição será feita e retornará erro, visível no Histórico de Erros do robô.
Dica: Em requisições aninhadas, você pode utilizar uma url que foi retornada anteriormente por uma requisição já realizada. Isso também funciona com outros campos do robô.
Método HTTP - Selecione o método da requisição:
GET – consultar informações
POST – enviar informações
PUT – atualizar
DELETE – remover
Configurações internas:
Cabeçalhos cadastrados (Headers) - É opcional, permite cadastrar diversos cabeçalhos, além de editar ou apagar um cabeçalho já adicionado anteriormente. Para cadastrar, preencha:
Chave do cabeçalho;
Valor do cabeçalho;
Clique em Adicionar cabeçalho;
Repita o processo quantas vezes seja necessário.
Corpo da requisição (Body) - Formatos aceitos:
JSON - Digite ou cole o JSON no campo indicado;
XML - Digite ou cole o XML no campo indicado;
Formulário - Preencha:
Nome;
Valor;
Clique em Adicionar campo;
Repita o processo quantas vezes seja necessário.
Sem corpo.
Requisição assíncrona (opcional) - Por padrão, vem desativada (requisição síncrona). A diferença será explicada em diante. Para ativá-la, clique na chave ao lado.
Tentativas e timeout:
Número de tentativas - Quantas vezes o bloco deve tentar novamente em caso de falha. Escolha entre 1 a 5 tentativas.
Tempo do timeout - Tempo máximo de espera pela resposta da API. Escolha entre 30 a 120 segundos.
IMPORTANTE: Para configurar corretamente, é fundamental que você conheça a API que está consumindo (métodos, URLs, dados esperados, formato de resposta etc.).
Após preencher todas as informações da etapa 1, clique em Continuar.
Na segunda etapa do bloco - configurações de resposta - você poderá mapear os dados retornados pela API e salvá-los em variáveis para usar em qualquer parte do fluxo.
Para cadastrá-las, preencha:
Chave na resposta - É o nome exato do dado que vem na resposta da sua requisição. Ou seja, é o “caminho” que o robô deve seguir dentro do método para encontrar a informação que você quer guardar;
Nome da variável - É o nome que você quer dar para armazenar esse dado dentro do robô. Depois disso, poderá usar essa variável em outros blocos;
Clique Adicionar variável;
Repita o processo quantas vezes seja necessário.
As variáveis podem ser usadas em:
blocos de mensagem
blocos condicionais
novos blocos de requisição
verificações dentro do fluxo
Atenção:
Variáveis não podem ter nomes duplicados.
É necessário usá-las após o bloco onde foram criadas.
O “root” da resposta SEMPRE é
response.
Após cadastrar todas variáveis, clique em Aplicar e o bloco "Enviar requisição HTTP" será criado com sucesso.
Como utilizar condicionais ligadas ao bloco de requisição http
Você pode conectar blocos de condição após blocos de requisição para poder validar informações retornadas nessas requisições. Para isso, selecione o bloco "Configurar condição" e arraste-o para o ambiente do robô, conectando-o após o bloco "Enviar requisição HTTP".
É possível validar:
O código de status da requisição: selecione "Código de status" em Variável, nas configurações do bloco de condições. Exemplos de uso:
Se status = 200 → seguir fluxo de sucesso.
Se status = 404 → informar que o dado não foi encontrado.
Se status = 500 → tentar outra ação ou encerrar.
Valores de variáveis: selecione "Propriedades da resposta" em Variável, nas configurações do bloco de condições. Exemplo:
Se
estado = "SP"→ enviar mensagem específica.Se
cepestiver vazio → pedir outro dado.
Requisição Síncrona x Assíncrona
Síncrona (padrão)
O robô espera a resposta da API.
O fluxo só continua após receber o retorno.
Ideal para consultas rápidas (CEP, CPF, status de pedido etc.).
Se a API demorar, pode gerar timeout.
Assíncrona
O robô não espera a API responder.
Fica com status
PENDINGaté que o callback seja recebido com a resposta.A resposta chega depois via callback.
Ideal para APIs lentas, processamentos complexos ou quando a resposta não é crítica para o fluxo imediato.
Importante:
Requisições pendentes por mais de 24h são encerradas automaticamente por timeout.
O callback precisa ser autenticado via token.
Histórico de Erros
Se algo der errado no robô, você poderá visualizar no histórico de erros:
No Menu Principal, acesse Mais Opções > Robô;
Clique nos 3 pontinhos ao lado do robô que deseja visualizar e Histórico de erros.
Ali você verá:
requisições com falha
detalhes do erro
timestamp
contexto da execução
Além disso, dentro do chamado, você pode acompanhar em tempo real as requisições sendo executadas e erros gerados.
Exemplos práticos de ações realizáveis com Bloco HTTP
Last updated