MadelineProtoDocs/docs/API_docs/methods/messages.report.md

52 lines
1.8 KiB
Markdown
Raw Normal View History

2024-05-01 14:53:46 +02:00
---
title: "messages.report"
description: "Report a message in a chat for violation of telegram's Terms of Service"
grand_parent: "Telegram RPC API"
parent: "Methods"
image: https://docs.madelineproto.xyz/favicons/android-chrome-256x256.png
redirect_from: /API_docs/methods/messages_report.html
---
# Method: messages.report
[Back to methods index](index.html)
Report a message in a chat for violation of telegram's Terms of Service
### Parameters:
| Name | Type | Description | Required |
|----------|---------------|-------------|----------|
|peer|[Username, chat ID, Update, Message or InputPeer](/API_docs/types/InputPeer.html) | Peer | Optional|
|id|Array of [int](/API_docs/types/int.html) | IDs of messages to report | Yes|
|reason|[ReportReason](/API_docs/types/ReportReason.html) | Why are these messages being reported | Yes|
|message|[string](/API_docs/types/string.html) | Comment for report moderation | Optional|
### Return type: [Bool](/API_docs/types/Bool.html)
### Can bots use this method: **NO**
### MadelineProto Example ([now async for huge speed and parallelism!](https://docs.madelineproto.xyz/docs/ASYNC.html)):
```php
if (!file_exists('madeline.php')) {
copy('https://phar.madelineproto.xyz/madeline.php', 'madeline.php');
}
include 'madeline.php';
$MadelineProto = new \danog\MadelineProto\API('session.madeline');
$MadelineProto->start();
$Bool = $MadelineProto->messages->report(peer: $InputPeer, id: [$int, $int], reason: $ReportReason, message: 'string', );
```
## Return value
If the length of the provided message is bigger than 4096, the message will be split in chunks and the method will be called multiple times, with the same parameters (except for the message), and an array of [Bool](../types/Bool.html) will be returned instead.