MadelineProto/docs/TD_docs/methods/pinChannelMessage.md

80 lines
1.9 KiB
Markdown
Raw Normal View History

---
title: pinChannelMessage
description: Pins a message in a supergroup channel chat. Needs editor privileges in the channel
---
## Method: pinChannelMessage
[Back to methods index](index.md)
2017-06-06 18:39:21 +02:00
YOU CANNOT USE THIS METHOD IN MADELINEPROTO
Pins a message in a supergroup channel chat. Needs editor privileges in the channel
### Params:
| Name | Type | Required | Description |
2017-08-20 11:05:56 +02:00
|----------|---------------|----------|-------------|
|channel\_id|[int](../types/int.md) | Yes|Identifier of the channel|
|message\_id|[long](../types/long.md) | Yes|Identifier of the new pinned message|
|disable\_notification|[Bool](../types/Bool.md) | Yes|True, if there should be no notification about the pinned message|
### Return type: [Ok](../types/Ok.md)
### Example:
```
$MadelineProto = new \danog\MadelineProto\API();
if (isset($token)) { // Login as a bot
2017-06-19 18:56:47 +02:00
$MadelineProto->bot_login($token);
}
if (isset($number)) { // Login as a user
$sentCode = $MadelineProto->phone_login($number);
echo 'Enter the code you received: ';
$code = '';
for ($x = 0; $x < $sentCode['type']['length']; $x++) {
$code .= fgetc(STDIN);
}
$MadelineProto->complete_phone_login($code);
}
$Ok = $MadelineProto->pinChannelMessage(['channel_id' => int, 'message_id' => long, 'disable_notification' => Bool, ]);
```
2017-07-24 01:32:29 +02:00
Or, if you're using the [PWRTelegram HTTP API](https://pwrtelegram.xyz):
2017-07-23 16:11:02 +02:00
### As a bot:
POST/GET to `https://api.pwrtelegram.xyz/botTOKEN/madeline`
Parameters:
* method - pinChannelMessage
2017-07-23 16:40:54 +02:00
* params - `{"channel_id": int, "message_id": long, "disable_notification": Bool, }`
2017-07-23 16:11:02 +02:00
2017-07-23 16:34:36 +02:00
2017-07-23 16:11:02 +02:00
### As a user:
POST/GET to `https://api.pwrtelegram.xyz/userTOKEN/pinChannelMessage`
Parameters:
channel_id - Json encoded int
2017-08-20 19:09:52 +02:00
2017-07-23 16:11:02 +02:00
message_id - Json encoded long
2017-08-20 19:09:52 +02:00
2017-07-23 16:11:02 +02:00
disable_notification - Json encoded Bool
2017-07-23 16:40:54 +02:00
2017-07-23 16:11:02 +02:00
2017-08-20 19:09:52 +02:00
Or, if you're into Lua:
```
Ok = pinChannelMessage({channel_id=int, message_id=long, disable_notification=Bool, })
```