search_chat_messages


Description:

public async FoundChatMessages search_chat_messages (int64 chat_id, string query, MessageSender sender_id, int64 from_message_id, int32 offset, int32 limit, SearchMessagesFilter filter, int64 message_thread_id, int64 saved_messages_topic_id) throws TDLibError

Searches for messages with given words in the chat. Returns the results in reverse chronological order, i.e. in order of decreasing message_id. Cannot be used in secret chats with a non-empty query Client.search_secret_messages must be used instead), or without an enabled message database. For optimal performance, the number of returned messages is chosen by TDLib and can be smaller than the specified limit. A combination of query, sender_id, filter and message_thread_id search criteria is expected to be supported, only if it is required for Telegram official application implementation

Parameters:

chat_id

Identifier of the chat in which to search messages

query

Query to search for

sender_id

Identifier of the sender of messages to search for; pass null to search for messages from any sender. Not supported in secret chats

from_message_id

Identifier of the message starting from which history must be fetched; use 0 to get results from the last message

offset

Specify 0 to get results from exactly the message from_message_id or a negative offset to get the specified message and some newer messages

limit

The maximum number of messages to be returned; must be positive and can't be greater than 100. If the offset is negative, the limit must be greater than -offset. For optimal performance, the number of returned messages is chosen by TDLib and can be smaller than the specified limit

filter

Additional filter for messages to search; pass null to search for all messages

message_thread_id

If not 0, only messages in the specified thread will be returned; supergroups only

saved_messages_topic_id

If not 0, only messages in the specified Saved Messages topic will be returned; pass 0 to return all messages, or for chats other than Saved Messages