Bloco Requisição HTTP: Integre APIs Externas no Fluxo

O bloco “Requisição HTTP (API)” conecta o seu fluxo do WhatsApp a qualquer sistema. No meio da conversa o AgeuBot chama a sua API, guarda a resposta em variáveis e continua o atendimento — criando cadastros, consultando pedidos ou liberando testes sem ninguém digitar nada.

O que dá para fazer

• Criar acesso/teste automático — o cliente pede, o sistema gera usuário e senha e o bot já responde com os dados.
• Consultar informação — status do pedido, saldo, validade do plano, dados de um CEP.
• Cadastrar no seu sistema — mandar nome, telefone e respostas do fluxo direto para o CRM/ERP.
• Validar antes de seguir — conferir se o CPF existe, se o cliente está em dia, se há vaga na agenda.
• Avisar outro sistema — disparar um webhook quando o cliente concluir uma etapa.

Onde encontrar

Passo 1 — Método e endereço (URL)

Escolha o método (GET, POST, PUT, PATCH ou DELETE) e informe o endereço. Só endereços https:// são aceitos.

Você pode usar variáveis na URL — elas são substituídas pelos dados do contato e codificadas automaticamente:

https://api.seusistema.com/criar-teste?whats={{telefone}}
https://api.seusistema.com/pedidos/{{numero_pedido}}
https://viacep.com.br/ws/{{cep}}/json/

{{nome}} e {{telefone}} sempre existem. Qualquer variável capturada antes — pelo bloco Capturar Dados ou pelo Menu — também pode ser usada.

Passo 2 — Cabeçalhos (headers)

Servem para autenticação e formato. Clique em + Adicionar header e preencha nome e valor:

Content-Type: application/json
Authorization: Bearer SEU_TOKEN_AQUI
X-API-Key: sua-chave

Passo 3 — Corpo da requisição (body)

Usado em POST, PUT e PATCH. Escreva o JSON com as variáveis entre chaves duplas:

{
  "nome": "{{nome}}",
  "whats": "{{telefone}}",
  "plano": "{{plano_escolhido}}"
}

Passo 4 — Guardar a resposta em variáveis

É aqui que a resposta da API vira mensagem no WhatsApp. Suponha que a sua API devolva:

{
  "sucesso": true,
  "data": {
    "username": "cliente_8842",
    "password": "Xy7k92",
    "validade": "3 dias"
  }
}

Em Extrair da resposta, informe o caminho do campo e o nome da variável que você quer criar:

Depois é só usar nos blocos seguintes:

Prontinho, {{nome}}! 🎉

Usuário: *{{usuario}}*
Senha: *{{senha}}*
Válido por {{validade}}.

Passo 5 — Tempo limite

Quanto o bot espera pela resposta antes de desistir. Aceita de 3 a 30 segundos (padrão: 10). Se a sua API costuma demorar, aumente — mas lembre que o cliente fica esperando do outro lado.

As duas saídas: Sucesso e Erro

O bloco tem duas saídas, e ligar as duas é obrigatório para o fluxo nunca travar:

Exemplo completo (copiar e colar)

Fluxo “quero um teste”: pergunta o nome, chama a API, entrega usuário e senha — e, se der problema, chama um atendente.

{
  "nodes": [
    { "id": 1, "type": "start", "x": 60, "y": 160,
      "data": { "label": "Início", "triggerMode": "any", "triggers": "teste, quero testar" } },

    { "id": 2, "type": "input", "x": 340, "y": 160,
      "data": { "label": "Pergunta o nome", "inputPrompt": "Qual o seu nome?",
                "inputVariable": "nome", "inputValidation": "any" } },

    { "id": 3, "type": "http", "x": 620, "y": 160,
      "data": {
        "label": "Criar teste no sistema",
        "httpMethod": "POST",
        "httpUrl": "https://api.seusistema.com/criar-teste",
        "httpHeaders": [
          { "key": "Content-Type",  "value": "application/json" },
          { "key": "Authorization", "value": "Bearer SEU_TOKEN" }
        ],
        "httpBody": "{\"nome\": \"{{nome}}\", \"whats\": \"{{telefone}}\"}",
        "httpTimeoutSec": 15,
        "httpExtractions": [
          { "path": "data.username", "variable": "usuario" },
          { "path": "data.password", "variable": "senha" }
        ]
      } },

    { "id": 4, "type": "content", "x": 900, "y": 70,
      "data": { "label": "Deu certo",
        "message": "Prontinho, {{nome}}! 🎉\n\nUsuário: *{{usuario}}*\nSenha: *{{senha}}*" } },

    { "id": 5, "type": "content", "x": 900, "y": 270,
      "data": { "label": "Deu erro",
        "message": "Ops, não consegui gerar agora. Já chamei um atendente pra te ajudar!" } },

    { "id": 6, "type": "transfer", "x": 1180, "y": 270,
      "data": { "label": "Chamar atendente", "transferMessage": "Transferindo para um atendente..." } }
  ],

  "connections": [
    { "fromNode": 1, "fromPort": "next",    "toNode": 2 },
    { "fromNode": 2, "fromPort": "next",    "toNode": 3 },
    { "fromNode": 3, "fromPort": "success", "toNode": 4 },
    { "fromNode": 3, "fromPort": "error",   "toNode": 5 },
    { "fromNode": 5, "fromPort": "next",    "toNode": 6 }
  ]
}

Teste antes de publicar

Limites e segurança

• Somente HTTPS — endereços http:// são bloqueados.
• Endereços internos/privados são bloqueados (proteção contra acesso indevido ao servidor).
• A resposta é lida até 1 MB; o excedente é descartado.
• Tempo limite entre 3 e 30 segundos.
• Proteção anti-loop: o mesmo bloco roda no máximo 5× por minuto e 20× a cada 10 minutos por contato — evita ciclos infinitos de chamadas.

Problemas comuns

Artigos relacionados

• Guardar a escolha do menu em variável e limpar dados do contato
• Como criar um fluxo de conversa
• Tipos de blocos do editor visual
• Usar a API pública do AgeuBot
• Configurar webhooks e API