SetChatTitle
SetChatTitle — изменяет название чата или канала.
📝 Назначение
Используется для установки или изменения отображаемого названия группы, супергруппы или канала. Название видно всем участникам и в списке чатов.
Когда это нужно:
- При создании нового чата — задать название
- Переименовать чат в зависимости от темы или события
- Автоматически устанавливать название при добавлении бота в чат
💡 Совет: Название поддерживает эмодзи и специальные символы. Избегайте слишком длинных названий — они обрезаются в интерфейсе Telegram.
⚙️ Параметры
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
| chat.id | Integer/String | ✅ Да | ID чата/канала или @username |
| title | String | ✅ Да | Новое название чата/канала |
🔐 Требуемые права бота
| Тип чата | Требуемые права |
|---|---|
| Группа/супергруппа | Бот должен быть администратором с правом can_change_info |
| Канал | Бот должен быть администратором канала |
⚠️ Важно: Без права
can_change_infoреакция вызовет ошибку.
📏 Ограничения
| Ограничение | Значение |
|---|---|
| Минимальная длина названия | 1 символ |
| Максимальная длина названия | 128 символов |
| Поддерживаемые символы | Любые (включая эмодзи, пробелы, специальные символы) |
💡 Совет: Слишком длинные названия могут обрезаться в мобильных версиях Telegram. Рекомендуется использовать не более 40-50 символов.
🧪 Примеры использования
Пример 1: Изменение названия текущего чата
Задача: Переименовать группу, откуда пришла команда.
Реакции:
SetChatTitle→chat.id:${chat.id},title:Новое название группы
Пример 2: Установка названия с эмодзи
Задача: Добавить эмодзи в название для наглядности.
Параметры SetChatTitle:
chat.id:${chat.id}title:📢 Новостной канал EnotPro
Пример 3: Изменение названия по команде администратора
Задача: Администратор бота может изменить название чата командой /settitle Новое название.
Обработчик: Регулярное выражение /settitle (.+)
Реакции:
SetChatTitle→
chat.id:${chat.id}title:${update.match.1}
SendMessage→ текст:Название чата изменено на "${update.match.1}"
Пример 4: Автоматическое название при добавлении бота
Задача: При добавлении бота в группу установить стандартное название.
Обработчик: Тип my_chat_member (статус изменился на administrator или member)
Реакции:
TriggerFolderс условием: проверка, что бот только что добавленSetChatTitle→
chat.id:${chat.id}title:Чат под управлением бота
Пример 5: Изменение названия по расписанию
Задача: Каждый понедельник менять название чата на «Новая неделя!».
Реакции (в расписании):
SetChatTitle→chat.id:-100123456789,title:Новая неделя!
🔄 Особенности поведения
| Ситуация | Поведение |
|---|---|
| Название длиннее 128 символов | Telegram вернёт ошибку |
| Название короче 1 символа | Telegram вернёт ошибку |
| Бот не администратор | Реакция вызовет ошибку |
| У бота нет права can_change_info | Реакция вызовет ошибку |
| Слишком частое изменение | Может быть временное ограничение от Telegram |
🔗 Связанные реакции
| Реакция | Назначение |
|---|---|
| SetChatDescription | Изменить описание чата |
| GetChat | Получить текущее название |
| PromoteChatMember | Назначить администратора с правом can_change_info |
🔗 Связанные разделы
| Раздел | Описание |
|---|---|
| Чаты/Каналы в админке | Управление чатами через интерфейс |