Настройки чата

Настройки чата

Все методы этой страницы требуют право change_info и возвращают { "ok": true, "result": true }.

setChatTitle

POST ?method=setChatTitle
{ "chat_id": 123, "title": "Новое название" }

Пустой title вернёт 400. Действие пишется в журнал как title_changed со старым и новым значением.

setChatDescription

POST ?method=setChatDescription
{ "chat_id": 123, "description": "Описание группы" }

Пустая строка стирает описание. Журнал: description_changed.

setChatPhoto

Файл передаётся через multipart/form-data в поле media:

curl -X POST "https://api.kodari.ru/msg/bot.php?method=setChatPhoto" \
  -H "Authorization: Bearer bot_ВАШ_ТОКЕН" \
  -F "chat_id=123" \
  -F "media=@avatar.jpg"

Альтернатива — уже загруженный файл:

{ "chat_id": 123, "photo_url": "https://api.kodari.ru/msg/media.php?key=..." }

photo_url обязан начинаться с https://api.kodari.ru/msg/. Журнал: photo_changed.

Ошибки: 400 — нет ни файла, ни photo_url; 422 — недопустимый формат.

deleteChatPhoto

POST ?method=deleteChatPhoto
{ "chat_id": 123 }

setChatPermissions

Права участников группы по умолчанию.

{
  "chat_id": 123,
  "permissions": {
    "send_messages": true,
    "send_media": true,
    "embed_links": false,
    "invite_users": false,
    "pin_messages": false,
    "change_info": false,
    "who_can_send": "all"
  }
}

Не переданные ключи сбрасываются в значения по умолчанию из таблицы, поэтому отправляйте набор целиком. Журнал: permissions_changed.

setChatSlowMode

POST ?method=setChatSlowMode
{ "chat_id": 123, "seconds": 60 }

Допустимые значения seconds: 0, 10, 30, 60, 300, 900, 3600. Любое другое — 400 Invalid seconds value. 0 выключает медленный режим. На администраторов режим не действует; обычный участник при превышении получает 429 Slow mode: wait Ns.

pykodaribot

from pykodaribot import ChatPermissions

await bot.set_chat_title(chat_id, "Новое название")
await bot.set_chat_description(chat_id, "Рабочий чат команды")
await bot.set_chat_photo(chat_id, "avatar.jpg")
await bot.delete_chat_photo(chat_id)

await bot.set_chat_permissions(chat_id, ChatPermissions(
    send_messages=True,
    send_media=True,
    embed_links=False,
))

await bot.set_chat_slow_mode(chat_id, 60)