Закреплённые сообщения

Закреплённые сообщения

Чат поддерживает несколько закреплённых сообщений одновременно. В интерфейсе отображается панель с навигацией — нажатие переходит к следующему закреплённому.

Кто может закреплять?

• Личный чат — любой участник
• Группа / канал — владелец или администратор с правом pin_messages

REST API (chats.php)

Закрепить сообщение

POST /chats.php
Authorization: Bearer USER_TOKEN
Content-Type: application/json

{ "action": "pin_message", "chat_id": 123, "message_id": 456 }

Ответ:

{
  "ok": true,
  "pinned_messages": [
    { "id": 456, "content": "Новое объявление", "user_id": 5, "pinned_by": 5, "pinned_at": "..." },
    { "id": 300, "content": "Правила чата", "user_id": 5, "pinned_by": 5, "pinned_at": "..." }
  ],
  "system_message_id": 789
}

Открепить сообщение

{ "action": "unpin_message", "chat_id": 123, "message_id": 456 }

Без message_id — открепляет все закреплённые.

Получить список закреплённых

{ "action": "get_pinned", "chat_id": 123 }

Сортировка — от новых к старым (первый элемент = последнее закреплённое).

Bot API

Боту доступны pinMessage и unpinMessage — см. раздел API ботов → Администрирование чата. Отдельного метода списка закреплённых для ботов нет: последнее закреплённое сообщение приходит в поле pinned_message метода getChat.