order.received

EVENTOorder.receiveddesde M12envelope v1

Pedido recebido.

Quando é emitido

Um cliente fez um pedido pelo carrinho do catálogo. A mensagem também chega em message.received (tipo order). Valores em milésimos da moeda (total na unidade). O token do pedido fica no servidor: leia os itens com Detalhes de um pedido. Pedidos do próprio número (de outro aparelho) não geram este evento.

Campos de `data`

Campo	Tipo	Descrição
`order_id`	`string`	Id do pedido (GET /orders/{order_id}).
`message_id`	`string`	Id do LiteZap da mensagem de pedido.
`chat`	`string`	Conversa do cliente.
`item_count`	`integer`	Quantidade de itens.
`total_amount_1000`	`integer`	Total em milésimos (total: na unidade).
`currency`	`string`	Moeda (BRL).
`note`	`string`	Mensagem do cliente com o pedido.
`status`	`string`	inquiry, accepted ou declined.

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

{
  "id": "evt_5d9f3b7a1c2e4068",
  "type": "order.received",
  "version": 1,
  "instance_id": "inst_7f3a9c2e5b1d4086",
  "timestamp": "2026-10-21T15:00:00.000Z",
  "data": {
    "order_id": "1234567890",
    "message_id": "msg_b52e7c1a9d3f4086",
    "wa_message_id": "3EB0A1B2C3D4E5F6A7B8",
    "chat": "[email protected]",
    "seller": "[email protected]",
    "item_count": 3,
    "total_amount_1000": 119800,
    "total": 119.8,
    "currency": "BRL",
    "title": "Loja X",
    "note": "sem cebola",
    "status": "inquiry",
    "push_name": "Ana",
    "timestamp": "2026-10-21T15:00:00Z"
  }
}

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": ["order.received"] no webhook, ou?types=order.received no SSE.

Equivalente na Z-API: Pedido recebido.