status.received

EVENTOstatus.receiveddesde M10envelope v1

Status de um contato.

Quando é emitido

Um contato publicou um status (story), recebido com a instância conectada. Opt-in: só sai para quem pede o tipo explicitamente (status.received ou status.*); * não inclui. O status fica no log (GET /status) e a mídia baixa por media.url.

Campos de data

Campo	Tipo	Descrição
id	string	Id do LiteZap (use em /status/{msg_id}/reply).
chat	string	Sempre status@broadcast.
sender	string	Autor do status.
type	string	text, image, video...
text	string	Texto ou legenda (opcional).
media	object	Mídia com url de download (opcional).

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_4d2a8c6e0b1f3957",
  "type": "status.received",
  "version": 1,
  "instance_id": "inst_7f3a9c2e5b1d4086",
  "timestamp": "2026-10-18T12:30:00.000Z",
  "data": {
    "id": "msg_7a3c1e9d5b2f4086",
    "wa_message_id": "3A1B2C3D4E5F6A7B8C9D",
    "chat": "status@broadcast",
    "sender": "[email protected]",
    "from_me": false,
    "push_name": "Ana",
    "source": "contact",
    "type": "image",
    "text": "Praia hoje",
    "media": {
      "id": "med_2c8e4a6f0b1d3957",
      "kind": "image",
      "mime": "image/jpeg",
      "url": "/v1/instances/inst_7f3a9c2e5b1d4086/media/med_2c8e4a6f0b1d3957"
    },
    "timestamp": "2026-10-18T12:30: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": ["status.received"] no webhook, ou?types=status.received no SSE.

Relacionados: message.received

Equivalente na Z-API: Webhook de status.