get_scheduled_messages()¶

Client.get_scheduled_messages()¶

Get one or more scheduled messages from a chat by using message identifiers.

You can retrieve up to 200 messages at once.

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) – Pass a single message identifier or an iterable of message ids (as integers) to get the content of the message themselves.

Returns:¶

Message | List of Message – In case message_ids was not a list, a single message is returned, otherwise a list of messages is returned.

Example

# Get one scheduled message
await app.get_scheduled_message(chat_id, 12345)

# Get more than one scheduled message (list of messages)
await app.get_scheduled_message(chat_id, [12345, 12346])

Raises:¶

ValueError – In case of invalid arguments.