# Agilize Docs para IA - Página atual

Este arquivo contém uma versão focada e legível por IA da página aberta na documentação pública da Agilize.
Use esta versão quando a pergunta do usuário estiver restrita ao documento atual.

Última geração: 2026-09-27T02:11:39.226Z

## Página

- Título: Requisição HTTP (Delegar)
- URL humana: https://agilize.app/docs/configuracao/referencias/nodes-fluxos-do-bot/requisicao-http-delegar
- Leitura completa para IA: https://agilize.app/docs/llms.txt
- Descrição: Delegue o processamento do fluxo para um endpoint HTTP próprio.

## Seções

- Quando usar
- Campos de configuração
- Entradas e saídas
- Exemplo prático
- Como funciona a delegação
- Exemplo de implementação
- Boas práticas e riscos comuns
- Como testar

## Conteúdo da página

# Requisição HTTP (Delegar)

Delegue o processamento do fluxo para um endpoint HTTP próprio. Este node deve ser usado dentro de fluxos do bot, sempre conectado a uma jornada com objetivo claro, rota esperada e tratamento para exceções.

## Quando usar

- Use quando uma API própria precisa decidir o próximo comportamento da conversa.
- Aplique em regras complexas, integrações customizadas e jornadas que precisam manter estado fora do builder.

## Campos de configuração

- **URL Requisição**: endpoint que receberá a requisição.

## Entradas e saídas

- Entradas: recebe 1 entrada.
- Saídas: possui 1 saída.
- Com `keepHere: true`, permanece no node e envia a próxima mensagem recebida novamente ao endpoint.
- Com `keepHere: false`, segue pela única saída conectada ao próximo passo do fluxo.

## Exemplo prático

Envie a mensagem atual para uma API própria, receba variáveis atualizadas e decida se o fluxo deve permanecer aguardando novas mensagens.

## Como funciona a delegação

---
title: "Ciclo da requisição HTTP delegada"
caption: "O campo keepHere define se a próxima mensagem volta ao endpoint ou se a conversa avança no fluxo da Agilize."
definition: |
  flowchart LR
    A[Mensagem chega ao node] --> B[Agilize envia POST ao endpoint]
    B --> C[Endpoint retorna messages, vars e keepHere]
    C --> D{keepHere?}
    D -->|true| E[Aguarda nova mensagem]
    E --> B
    D -->|false| F[Segue pela saída do node]
---

Ao executar o node, a Agilize envia um `POST` para a URL configurada. O payload inclui o número sequencial da execução (`seq`), identificadores da conversa e do canal, a mensagem atual, a resposta interativa quando houver e as variáveis já disponíveis no fluxo.

O endpoint deve responder com JSON usando estes campos:

| Campo | Função |
| --- | --- |
| `messages` | Lista de mensagens que a Agilize enviará ao contato. Cada item pode conter texto, arquivo ou botões. |
| `keepHere` | Use `true` para aguardar outra mensagem neste node; use `false` para continuar pela saída. |
| `vars` | Variáveis que serão persistidas e disponibilizadas aos próximos nodes e templates. |

Somente os valores retornados dentro de `vars` são persistidos no contexto do fluxo. Para consultar todos os campos do payload, formatos de mensagem e exemplo de retorno, veja a [referência técnica do NodeHttpDelegate](/docs/desenvolvedores/referencia-tecnica/webhooks/messenger-chatbot/chatbot/post-messenger-chatbot-nodehttpdelegate).

## Exemplo de implementação

Consulte o [template JavaScript com Express](https://github.com/agilizeapp/agilize-delegate-chatbot-template-js/blob/main/src/app.js). O exemplo envia texto, PDF, imagem e botões, mantém a primeira interação no node e depois retorna uma variável antes de continuar o fluxo.

## Boas práticas e riscos comuns

- O endpoint externo precisa responder dentro do tempo esperado.
- Use `vars` para devolver dados que serão usados por próximos nodes.
- Controle loops quando o retorno mantiver a conversa no mesmo node.
- Consulte a documentação e exemplo para estruturar seu serviço.
- Use para integrações customizadas e regras complexas.

## Como testar

- Retorne `keepHere: true` e confirme que a conversa permanece no node aguardando uma nova mensagem.
- Envie uma nova mensagem ou selecione um botão e confirme que `seq` foi incrementado e `interactiveReply` chegou quando aplicável.
- Retorne `keepHere: false` com uma variável em `vars` e confirme que a saída foi seguida e que o próximo node recebeu o valor.
- Simule erro HTTP, timeout e retorno vazio para validar o caminho de contingência do fluxo.

## Guias relacionados

- [Referência técnica do NodeHttpDelegate](/docs/desenvolvedores/referencia-tecnica/webhooks/messenger-chatbot/chatbot/post-messenger-chatbot-nodehttpdelegate)
- [Nodes de fluxos do bot](/docs/configuracao/referencias/nodes-fluxos-do-bot)
- [Guia geral de fluxos do bot](/docs/configuracao/fluxos-automacoes/guia-geral-de-fluxos-do-bot)
- [Fluxos do bot](/docs/configuracao/fluxos-automacoes/fluxos-do-bot)