Pin
В каждом чате можно закрепить одно сообщение — оно показывается в шапке.
Закрепить
POST /pinChatMessage
{
"chat_id": -100123,
"message_id": 42,
"disable_notification": false
}
disable_notification: true — не присылать уведомление участникам о закреплении.
Если уже было закреплено другое — оно открепляется автоматически.
Открепить
POST /unpinChatMessage
{
"chat_id": -100123,
"message_id": 42
}
Без message_id — открепит текущее закреплённое.
Открепить все
POST /unpinAllChatMessages
{ "chat_id": -100123 }
Кто может закреплять
- В DM: оба участника
- В группе: только админы с правом
can_pin_messages - В канале: только админы с правом
can_edit_messages(для каналов это объединено)
События
При закреплении в чате появляется service-message с типом pinned_message. Юзеры получают push-уведомление (если не disable_notification).