🌙

pinMessage / unpinMessage

pinMessage / unpinMessage

Требует право pin_messages в группах и каналах. В личных чатах — доступно всем участникам.

pinMessage

POST ?method=pinMessage
{ "chat_id": 123, "message_id": 456 }

Ответ: { "ok": true, "result": true }

unpinMessage

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

POST ?method=unpinMessage
{ "chat_id": 123 }
POST ?method=unpinMessage
{ "chat_id": 123, "message_id": 456 }

Ответ: { "ok": true, "result": true }

getPinnedMessages

Список всех закреплённых, отсортированных от новых к старым.

GET ?method=getPinnedMessages&chat_id=123

Ответ:

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

Ошибки

КодОписание
400chat_id или message_id отсутствует
403Нет права pin_messages
404Сообщение не найдено
14 просмотров