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).