report_chat()

async Client.report_chat()

Report a chat (channel, supergroup, group, or user) for rule violations.

Usable by Users Bots
Parameters:

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

  • reason (ReportReason | str, optional) – The reason for reporting. Defaults to SPAM.

  • message (str, optional) – Additional explanatory text or details about the report. Defaults to “” (empty string).

Returns:

bool – True on success.

Example

from pyrogram.enums import ReportReason

# Report a spam group
await app.report_chat(chat_id, ReportReason.SPAM)

# Report a scam/impersonation channel with description
await app.report_chat(chat_id, ReportReason.FAKE, "Impersonating official channel")