← API 参考
接收事件

group.updated

群组元信息变化——名称、成员或设置。

按变更类型的载荷

Renamed

{
  "id": "evt_g7a1c4e9b2",
  "type": "group.updated",
  "provider": "whatsapp",
  "account_id": "acc_8c21d0",
  "occurred_at": "2026-06-08T13:02:11Z",
  "data": {
    "conversation": { "id": "120363041234567890@g.us", "type": "group" },
    "actor": { "id": "8613800138000@s.whatsapp.net", "type": "user" },
    "changes": [
      { "kind": "renamed", "name": "Order Support — VIP" }
    ],
    "event": { "kind": "group_updated" }
  }
}

Members added / removed

{
  "id": "evt_g8b2d5f0c3",
  "type": "group.updated",
  "provider": "whatsapp",
  "account_id": "acc_8c21d0",
  "occurred_at": "2026-06-08T13:05:40Z",
  "data": {
    "conversation": { "id": "120363041234567890@g.us", "type": "group" },
    "actor": { "id": "8613800138000@s.whatsapp.net", "type": "user" },
    "changes": [
      { "kind": "member_added", "members": ["8613912345678@s.whatsapp.net", "8613998765432@s.whatsapp.net"] },
      { "kind": "member_removed", "members": ["8613900001111@s.whatsapp.net"] }
    ],
    "event": { "kind": "group_updated" }
  }
}

Admin promoted / demoted

{
  "id": "evt_g9c3e6a1d4",
  "type": "group.updated",
  "provider": "whatsapp",
  "account_id": "acc_8c21d0",
  "occurred_at": "2026-06-08T13:08:15Z",
  "data": {
    "conversation": { "id": "120363041234567890@g.us", "type": "group" },
    "actor": { "id": "8613800138000@s.whatsapp.net", "type": "user" },
    "changes": [
      { "kind": "promoted", "members": ["8613912345678@s.whatsapp.net"] },
      { "kind": "demoted", "members": ["8613900001111@s.whatsapp.net"] }
    ],
    "event": { "kind": "group_updated" }
  }
}

Avatar changed (WhatsApp)

{
  "id": "evt_g0d4f7b2e5",
  "type": "group.updated",
  "provider": "whatsapp",
  "account_id": "acc_8c21d0",
  "occurred_at": "2026-06-08T13:09:30Z",
  "data": {
    "conversation": { "id": "120363041234567890@g.us", "type": "group" },
    "actor": { "id": "8613800138000@s.whatsapp.net", "type": "user" },
    "changes": [
      { "kind": "avatar_changed", "removed": false, "picture_id": "165247318762345" }
    ],
    "event": { "kind": "group_updated" }
  }
}

备注

  • data.conversation 是群，data.actor 是做出变更的人，data.changes[] 是这次快照里发生的变更列表——一个事件可能一次带多个变更（比如改名 + member_added）。event.kind 为 group_updated。
  • changes[] 支持 renamed、description_changed、member_added / member_removed / promoted / demoted、dissolved 与 avatar_changed。WhatsApp 头像变化提供 removed 与可选 picture_id（无 URL）；Telegram 可能提供 avatar_url 与 photo_id。