get_scheduled_messages()

async Client.get_scheduled_messages()

Get one or more scheduled messages from a chat.

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 of int, optional) – Pass a single message identifier or an iterable of message ids (as integers) to get specific scheduled messages. If not passed, all scheduled messages are returned.

Returns:

Message | List of Message – In case message_ids was a single integer, a single message is returned (or None if not found). Otherwise, a list of messages is returned.

Example

# Get all scheduled messages
await app.get_scheduled_messages(chat_id)

# Get specific scheduled message
await app.get_scheduled_messages(chat_id, 12345)

# Get multiple specific scheduled messages
await app.get_scheduled_messages(chat_id, [12345, 12346])
Raises:

ValueError – In case of invalid arguments.