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

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

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

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

• Личный чат — любой участник
• Группа / канал — владелец или администратор с правом 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 — открепляет все закреплённые.

Ответ:

{ "ok": true, "pinned_messages": [ ... ] }

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

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

Ответ:

{
  "ok": true,
  "pinned_messages": [
    {
      "id": 456,
      "content": "Важное объявление",
      "media_type": null,
      "media_url": null,
      "user_id": 5,
      "pinned_by": 5,
      "created_at": "2026-05-31 10:00:00",
      "pinned_at": "2026-05-31 10:05:00"
    }
  ]
}

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

Bot API

Через Bot API используйте методы pinMessage, unpinMessage, getPinnedMessages — см. раздел Прямые запросы.