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 ofint, 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 ofMessage– 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.