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 表示标记为未读。