label.updated

EVENTOlabel.updateddesde M10envelope v1

Etiqueta alterada.

Quando é emitido

Etiqueta do WhatsApp Business criada, renomeada, recolorida ou apagada (kind: edit), ou aplicada/ removida de uma conversa (chat) ou mensagem (message), pela API (source: api) ou no celular (source: device). O sync completo logo após parear grava as etiquetas sem gerar eventos.

Campos de data

Campo	Tipo	Descrição
kind	string	edit, chat ou message.
label_id	string	Id da etiqueta.
name	string	edit: nome (opcional).
color	integer	edit: índice da cor (opcional).
deleted	boolean	edit: apagada (opcional).
chat	string	chat/message: a conversa (opcional).
labeled	boolean	chat/message: estado novo (opcional).
source	string	api ou device.

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_3e7a1c9d5b2f8046",
  "type": "label.updated",
  "version": 1,
  "instance_id": "inst_7f3a9c2e5b1d4086",
  "timestamp": "2026-10-18T12:32:00.000Z",
  "data": {
    "kind": "chat",
    "label_id": "5",
    "chat": "5511988887777@s.whatsapp.net",
    "labeled": true,
    "source": "device",
    "timestamp": "2026-10-18T12:32: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": ["label.updated"] no webhook, ou?types=label.updated no SSE.

Equivalente na Z-API: (sem equivalente).