EnotPRO Logo EnotPRO

SetChatTitle

SetChatTitle — изменяет название чата или канала.

📝 Назначение

Используется для установки или изменения отображаемого названия группы, супергруппы или канала. Название видно всем участникам и в списке чатов.

Когда это нужно:

  • При создании нового чата — задать название
  • Переименовать чат в зависимости от темы или события
  • Автоматически устанавливать название при добавлении бота в чат

💡 Совет: Название поддерживает эмодзи и специальные символы. Избегайте слишком длинных названий — они обрезаются в интерфейсе Telegram.

⚙️ Параметры

Параметр Тип Обязательный Описание
chat.id Integer/String ✅ Да ID чата/канала или @username
title String ✅ Да Новое название чата/канала

🔐 Требуемые права бота

Тип чата Требуемые права
Группа/супергруппа Бот должен быть администратором с правом can_change_info
Канал Бот должен быть администратором канала

⚠️ Важно: Без права can_change_info реакция вызовет ошибку.

📏 Ограничения

Ограничение Значение
Минимальная длина названия 1 символ
Максимальная длина названия 128 символов
Поддерживаемые символы Любые (включая эмодзи, пробелы, специальные символы)

💡 Совет: Слишком длинные названия могут обрезаться в мобильных версиях Telegram. Рекомендуется использовать не более 40-50 символов.

🧪 Примеры использования

Пример 1: Изменение названия текущего чата

Задача: Переименовать группу, откуда пришла команда.

Реакции:

  1. SetChatTitlechat.id: ${chat.id}, title: Новое название группы

Пример 2: Установка названия с эмодзи

Задача: Добавить эмодзи в название для наглядности.

Параметры SetChatTitle:

  • chat.id: ${chat.id}
  • title: 📢 Новостной канал EnotPro

Пример 3: Изменение названия по команде администратора

Задача: Администратор бота может изменить название чата командой /settitle Новое название.

Обработчик: Регулярное выражение /settitle (.+)

Реакции:

  1. SetChatTitle
  • chat.id: ${chat.id}
  • title: ${update.match.1}
  1. SendMessage → текст: Название чата изменено на "${update.match.1}"

Пример 4: Автоматическое название при добавлении бота

Задача: При добавлении бота в группу установить стандартное название.

Обработчик: Тип my_chat_member (статус изменился на administrator или member)

Реакции:

  1. TriggerFolder с условием: проверка, что бот только что добавлен
  2. SetChatTitle
  • chat.id: ${chat.id}
  • title: Чат под управлением бота

Пример 5: Изменение названия по расписанию

Задача: Каждый понедельник менять название чата на «Новая неделя!».

Реакции (в расписании):

  1. SetChatTitlechat.id: -100123456789, title: Новая неделя!

🔄 Особенности поведения

Ситуация Поведение
Название длиннее 128 символов Telegram вернёт ошибку
Название короче 1 символа Telegram вернёт ошибку
Бот не администратор Реакция вызовет ошибку
У бота нет права can_change_info Реакция вызовет ошибку
Слишком частое изменение Может быть временное ограничение от Telegram

🔗 Связанные реакции

Реакция Назначение
SetChatDescription Изменить описание чата
GetChat Получить текущее название
PromoteChatMember Назначить администратора с правом can_change_info

🔗 Связанные разделы

Раздел Описание
Чаты/Каналы в админке Управление чатами через интерфейс

🔗 Ссылка на официальную документацию

setChatTitle — Telegram Bot API

© 2025 EnotPRO. Все права защищены.