Методы управления

Все запросы используют Bot API:

https://api.kodari.ru/msg/bot.php?method=ИМЯ_МЕТОДА

Авторизация:

Authorization: Bearer bot_ВАШ_ТОКЕН

getForumTopics

Получить все видимые топики группы.

GET /msg/bot.php?method=getForumTopics&chat_id=123

Ответ содержит массив объектов ForumTopic.

getForumTopic

Получить один топик.

GET /msg/bot.php?method=getForumTopic&chat_id=123&message_thread_id=42

Ответ содержит объект ForumTopic.

createForumTopic

Создать топик.

{
  "chat_id": 123,
  "name": "Поддержка",
  "icon_color": "#6C8CFF",
  "icon_emoji": "🛠"
}

Ответ содержит созданный объект ForumTopic.

editForumTopic

Изменить название, цвет или эмодзи.

{
  "chat_id": 123,
  "message_thread_id": 42,
  "name": "Техническая поддержка",
  "icon_color": "#22C55E",
  "icon_emoji": "⚙️"
}

Нужно передать хотя бы одно изменяемое поле. Требуется право manage_topics.

closeForumTopic

Закрыть топик для обычных участников.

{
  "chat_id": 123,
  "message_thread_id": 42
}

Успешный ответ: true.

reopenForumTopic

Повторно открыть топик.

{
  "chat_id": 123,
  "message_thread_id": 42
}

Успешный ответ: true.

deleteForumTopic

Удалить топик. Сообщения удаляемого топика переносятся в общий топик.

{
  "chat_id": 123,
  "message_thread_id": 42
}

Общий топик удалить нельзя. Успешный ответ: true.

События getUpdates

Bot API создаёт события:

• forum_topic_created
• forum_topic_edited
• forum_topic_closed
• forum_topic_reopened
• forum_topic_deleted
• forum_status_changed

Пример:

{
  "update_id": 92,
  "forum_topic_created": {
    "chat": {
      "id": 123,
      "type": "group",
      "is_forum": true
    },
    "from": {
      "id": 15,
      "is_bot": false
    },
    "message_thread_id": 42,
    "topic": {
      "message_thread_id": 42,
      "name": "Поддержка",
      "icon_color": "#6C8CFF",
      "icon_emoji": "🛠",
      "creator_id": 15,
      "is_general": false,
      "is_closed": false
    }
  }
}

При использовании фильтра allowed_updates добавьте нужные имена событий в список.