Confirms that the recipient has read one or more of your messages.
💡 The field is
message_ids(plural) and carries an array — one event can acknowledge several messages at once. Only sent for user chats.
method is "messageSeen".
| Field | Type | Returned | Description |
|---|---|---|---|
method |
String | Yes | "messageSeen" |
message_ids |
Array of String | Yes | The messages the user has now read. |
No SDK has a dedicated callback for this event. It arrives on the generic handler for unrecognised methods, with the raw JSON object.
| SDK | Callback |
|---|---|
| Java | onReceive(JSONObject obj) |
| JavaScript | onReceiveObj(obj) — receives a JSON string, so parse it first |
| Python | on_receive_obj(self, obj) |
Read the method field to tell this event apart from the others that land there.
{
"method": "messageSeen",
"message_ids": ["d1_w37zpuwx126404", "d1_y7Zt2lJr126176"]
}