get_direct_messages_chat_topic_history()

Client.get_direct_messages_chat_topic_history()

Return messages in the topic in a channel direct messages chat administered by the current user.

The messages are returned in reverse chronological order.

Usable by Users Bots
Parameters:

  • chat_id (int | str) – Unique identifier (int) or username (str) of the target chat.

  • topic_id (int) – Identifier of the topic which messages will be fetched.

  • limit (int, optional) – Limits the number of messages to be retrieved. By default, no limit is applied and all messages are returned.

  • offset (int, optional) – Sequential number of the first message to be returned. Negative values are also accepted and become useful in case you set offset_id or offset_date.

  • offset_id (int, optional) – Identifier of the first message to be returned.

  • offset_date (datetime, optional) – Pass a date as offset to retrieve only older messages starting from that date.

  • min_id (int, optional) – If a positive value was provided, the method will return only messages with IDs more than min_id.

  • max_id (int, optional) – If a positive value was provided, the method will return only messages with IDs less than max_id.

  • reverse (bool, optional) – Pass True to retrieve the messages from oldest to newest.

Returns:

Generator – A generator yielding Message objects.

Example

async for message in app.get_direct_messages_chat_topic_history(chat_id, topic_id):
    print(message.text)