Skip to content

getChatEventLog

Sahri Riza Umami edited this page Jun 24, 2018 · 3 revisions

Returns a list of service actions taken by chat members and administrators in the last 48 hours.
Available only in supergroups and channels.
Requires administrator rights.
Returns results in reverse chronological order (i. e., in order of decreasing event_id).

getChatEventLog(chat_id, query, from_event_id, limit, filters, user_ids, callback, data)
Field Type Description
chat_id int53 Chat identifier.
query string Search query by which to filter events.
from_event_id int64 Identifier of an event from which to return results. Use 0 to get results from the latest events.
limit int32 Maximum number of events to return; up to 100.
filters chatEventLogFilters The types of events to return. By default, all types will be returned.
user_ids vector User identifiers by which to filter events. By default, events relating to all users will be returned.

Filters

Represents a set of filters used to obtain a chat event log.

  • message_edits True, if message edits should be returned.
  • message_deletions True, if message deletions should be returned.
  • message_pins True, if pin/unpin events should be returned.
  • member_joins True, if members joining events should be returned.
  • member_leaves True, if members leaving events should be returned.
  • member_invites True, if invited member events should be returned.
  • member_promotions True, if member promotion/demotion events should be returned.
  • member_restrictions True, if member restricted/unrestricted/banned/unbanned events should be returned.
  • info_changes True, if changes in chat information should be returned.
  • setting_changes True, if changes in chat settings should be returned.

Filters written in the following form:

{message_edits, message_deletions, message_pins, member_joins, member_leaves, member_invites, member_restrictions,info_changes, setting_changes}

Example

  • Get a list of service actions taken by chat 1234567890 members and administrators in the last 48 hours. And filter to only query message containing "Test" string.

    getChatEventLog(1234567890, 'Test')

Frequently Asked Questions
The Functions

Clone this wiki locally