# 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-05-27T06:55:54.636Z

## Página

- Título: Webhook HTTP (Saída) do Chatbot
- URL humana: https://agilize.app/docs/desenvolvedores/webhooks/messenger-chatbot/chatbot/post-messenger-chatbot-nodehttpwebhook
- Leitura completa para IA: https://agilize.app/docs/llms.txt
- Descrição: Estrutura enviada pelo node NodeHttpWebhook para a URL configurada no fluxo. Este endpoint deve ser implementado pelo cliente/terceiro para receber os dados e reagir conforme necessário.

## Seções

- Evento
- Como receber
- Payload
- Respostas
- Boas práticas

## Conteúdo da página

## Evento

```http
POST messenger/chatbot/NodeHttpWebhook
```

## Como receber

Configure uma URL HTTPS pública para receber este evento e responda rapidamente com status de sucesso após aceitar o payload.

## Payload

- Content-Type: application/json

| Campo | Tipo | Obrigatório | Valores / Exemplo | Descrição |
| --- | --- | --- | --- | --- |
| roomId | string | Sim |  | ID da sala (room) no banco |
| chId | string | Sim |  | Identificador do canal. No WhatsApp (chSrc=1) é o número do cliente. |
| chSrc | integer | Sim |  | Canal de origem (1=WhatsApp, 2=Facebook, 3=Instagram, 4=SMS) |
| message | string,null | Não |  | Texto da mensagem atual (quando houver) |
| interactiveReply | string,null | Não |  | Resposta interativa do usuário (payload/id) quando aplicável |
| currNodeId | string | Sim |  | ID do node atual no fluxo |
| vars | object | Sim |  | Variáveis persistidas no contexto do fluxo (roomData.vars) |
| media | NodeHttpWebhookMedia \| null | Não |  | Mídia/arquivo quando a mensagem contém anexo |
| _waReferral | NodeHttpWebhookReferral \| null | Não |  | Referral do WhatsApp quando o webhook de mensagem veio com message.referral |

#### Estruturas internas

**media**

```json
{
  "url": "string (uri)",
  "mimeType": "string"
}
```

**_waReferral**

```json
{
  "body": "string",
  "ctwa_clid": "string",
  "headline": "string",
  "image": {
    "id": "string"
  },
  "source_id": "string",
  "source_type": "string",
  "source_url": "string"
}
```

Exemplo básico recebido:

```json
{
  "roomId": "valor",
  "chId": "valor",
  "chSrc": 1,
  "currNodeId": "valor",
  "vars": {}
}
```

## Respostas

| Status | Descrição | Conteúdo |
| --- | --- | --- |
| 200 | Qualquer resposta 2xx é considerada sucesso |  |
| 500 | Erro no processamento do receiver |  |

## Boas práticas

- Trate reenvios como possibilidade real.
- Valide o payload antes de executar regras de negócio.
- Registre o identificador do evento ou do registro recebido para auditoria.