delete_messages()¶
- async 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).message_ids (
int
| Iterable ofint
) – 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)