agent.order_draft

EVENTOagent.order_draftdesde M5benvelope v1

Rascunho de pedido.

Quando é emitido

O Atendente LiteZap (modo facilitador de pedido) montou o pedido e pediu confirmação ao cliente. Os preços unitários vêm do catálogo do agente quando o nome bate (in_catalog: true) e o total é recalculado pelo motor; itens fora do catálogo vêm com o preço citado pela IA (all_items_in_catalog: false: confira). A confirmação do cliente é a próxima mensagem dele.

Campos de data

Campo	Tipo	Descrição
chat	string	Chat do cliente.
items	array	name, quantity, unit_price, subtotal, in_catalog.
total	number	Total recalculado.
currency	string	Moeda do agente (BRL).
all_items_in_catalog	boolean	Todos os itens casaram com o catálogo.
address	string	Endereço (ou retirada).
notes	string	Observações.

O envelope (id, type, version, instance_id, timestamp,data) está em Visão geral. Campos novos podem ser adicionados emdata sem mudar a versão: ignore os que não conhecer.

Exemplos

Corpo do POST

{
  "id": "evt_4e0a2c8f6b1d3957",
  "type": "agent.order_draft",
  "version": 1,
  "instance_id": "inst_7f3a9c2e5b1d4086",
  "timestamp": "2026-10-18T19:20:00.000Z",
  "data": {
    "chat": "5511999999999@s.whatsapp.net",
    "message_id": "msg_1a2b3c4d5e6f7a8b",
    "agent_id": "agt_5b1d3f9a7c2e4086",
    "agent_name": "Bia",
    "mode": "pedido",
    "items": [
      {
        "name": "Pizza Margherita",
        "quantity": 2,
        "unit_price": 45,
        "subtotal": 90,
        "in_catalog": true
      }
    ],
    "total": 90,
    "currency": "BRL",
    "all_items_in_catalog": true,
    "address": "Rua B, 5",
    "notes": "sem cebola",
    "customer_name": "Ana"
  }
}

Entrega e ordem

• Por webhook: pelo menos uma vez, com retry por até 24 horas. O mesmo evento pode chegar duas vezes: deduplique porX-LiteZap-Event-Id. Veja Entrega e retentativas.
• A ordem entre eventos não é garantida (retentativas reordenam): use timestamp.
• Por SSE: ao vivo, sem replay. Veja Tempo real com SSE.
• Para assinar só este tipo: "events": ["agent.order_draft"] no webhook, ou?types=agent.order_draft no SSE.

Relacionados: agent.lead

Equivalente na Z-API: (sem equivalente).