delete_messages()

Client.delete_messages()

Delete messages, including service messages.

Usable by Users Bots
Parameters:

  • chat_id (int | str) – Unique identifier (int) or username (str) of the target chat. For your personal cloud (Saved Messages) you can simply use “me” or “self”. For a contact that exists in your Telegram address book you can use his phone number (str). You can also use chat public link in form of t.me/<username> (str).

  • message_ids (int | Iterable of int) – An iterable of message identifiers to delete (integers) or a single message id.

  • revoke (bool, optional) – Deletes messages on both parts. This is only for private cloud chats and normal groups, messages on channels and supergroups are always revoked (i.e.: deleted for everyone). Defaults to True.

Returns:

int – Amount of affected messages

Example

# Delete one message
await app.delete_messages(chat_id, message_id)

# Delete multiple messages at once
await app.delete_messages(chat_id, list_of_message_ids)

# Delete messages only on your side (without revoking)
await app.delete_messages(chat_id, message_id, revoke=False)