group.updated

EVENTOgroup.updateddesde M8envelope v1

Grupo alterado.

Quando é emitido

Mudança num grupo em que o número está, feita no celular, por outro membro ou pela API. Sai um evento por tipo de mudança (kind): participants_added (reason: invite = entrou por link), participants_removed, participants_promoted, participants_demoted, join_request (pedido de entrada em grupo com aprovação), join_request_revoked (pedido cancelado ou recusado), subject (name), description ("" = removida), photo (removed), settings (só os campos que mudaram; a aprovação de entrada sai depois, lida do grupo), invite_link_reset, joined (o número foi adicionado ou criou o grupo), deleted, suspended/unsuspended, community_linked/community_unlinked (group). filters.chat: group do webhook casa com ele.

Campos de data

Campo	Tipo	Descrição
chat	string	JID do grupo.
kind	string	Tipo da mudança.
actor	string	Quem fez a mudança (opcional).
participants	array	Participantes afetados (participants_*, join_request).
reason	string	participants_added/joined: invite quando por link (opcional).
name	string	subject, joined (opcional).
description	string	description (opcional).
removed	boolean	photo: foto removida (opcional).
settings	object	settings: announce, locked, approval_required, ephemeral_seconds (opcional).
group	string	community_linked/unlinked: o grupo (opcional).
timestamp	string	Quando aconteceu.

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

Participante adicionado

{
  "id": "evt_2b7d0f4a9c1e6358",
  "type": "group.updated",
  "version": 1,
  "instance_id": "inst_7f3a9c2e5b1d4086",
  "timestamp": "2026-10-18T11:00:00.000Z",
  "data": {
    "chat": "[email protected]",
    "kind": "participants_added",
    "actor": "[email protected]",
    "participants": [
      "[email protected]"
    ],
    "timestamp": "2026-10-18T11:00:00Z"
  }
}

Configurações

{
  "id": "evt_8e3a1c6f0b2d9475",
  "type": "group.updated",
  "version": 1,
  "instance_id": "inst_7f3a9c2e5b1d4086",
  "timestamp": "2026-10-18T11:01:00.000Z",
  "data": {
    "chat": "[email protected]",
    "kind": "settings",
    "actor": "[email protected]",
    "settings": {
      "announce": true
    },
    "timestamp": "2026-10-18T11:01: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": ["group.updated"] no webhook, ou?types=group.updated no SSE.

Relacionados: message.received

Equivalente na Z-API: Webhook de recebimento (notificações de grupo).