delete_messages()

Client.delete_messages()

Delete messages, including service messages.

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 (iterable) – A list of Message identifiers to delete or a single message id. Iterators and Generators are also accepted.

  • 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

bool – True on success, False otherwise.

Example

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

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

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