Confirms that a message you sent reached the recipient's device.

💡 Only sent for user chats. Groups and channels acknowledge with messageAck alone.


Event

method is "messageDelivered".

Field Type Returned Description
method String Yes "messageDelivered"
reference Long Yes The reference from your original message.
message_id String Yes The server-assigned id of the original message.
date Long Optional Unix Epoch timestamp in milliseconds of delivery.

SDKs

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.

Example

Event

{
  "method": "messageDelivered",
  "message_id": "d1_w37zpuwx126404",
  "reference": 111111119
}