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

{
  "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": "[email protected]",
    "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).