← API 參考
接收事件

conversation.updated

會話層級設定發生變化——靜音 / 取消靜音、封存、置頂或標記已讀。

依設定類型的載荷

Muted until a time

{
  "id": "evt_c1a7e4d9b2",
  "type": "conversation.updated",
  "provider": "whatsapp",
  "account_id": "acc_8c21d0",
  "occurred_at": "2026-06-08T12:40:00Z",
  "data": {
    "conversation": { "id": "8613912345678@s.whatsapp.net", "type": "user" },
    "muted": true,
    "mute_until": "2026-06-09T12:40:00Z",
    "event": { "kind": "conversation_updated" }
  }
}

Pinned

{
  "id": "evt_c2b8f5e0c3",
  "type": "conversation.updated",
  "provider": "whatsapp",
  "account_id": "acc_8c21d0",
  "occurred_at": "2026-06-08T12:42:30Z",
  "data": {
    "conversation": { "id": "8613912345678@s.whatsapp.net", "type": "user" },
    "pinned": true,
    "event": { "kind": "conversation_updated" }
  }
}

備註

  • 會話層級本地狀態發生變化。data.conversation 標識會話；每則事件通常只改變一個設定欄位：muted / mute_until / mute_forever、archived、pinned 或 read。
  • 這是目前連線帳號本地聊天列表的狀態。例如 archived=false 表示該帳號取消封存此會話，read=false 表示標記為未讀。