接收事件
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" }
}
}備註
- data.conversation 是群組，data.actor 是做出變更的人，data.changes[] 是這次快照裡發生的變更清單——一個事件可能一次帶多個變更（例如改名 + member_added）。event.kind 為 group_updated。
- changes[] 的每一項都有自己的 kind：renamed（name）、description_changed（description）、member_added / member_removed / promoted / demoted（members[] 為成員 id）、dissolved。開啟審批的入群申請走單獨的 group.join_request 事件，不在這裡。