Receiving Events
conversation.updated
A conversation-level setting changed — muted/unmuted, archived, pinned, or marked read.
Payload by setting
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" }
}
}Notes
- A conversation-level local state changed. data.conversation identifies the chat; exactly one setting usually changes per event: muted / mute_until / mute_forever, archived, pinned, or read.
- This is a local chat-list state for the connected account. For example archived=false means this account unarchived the chat; read=false means it was marked unread.