SetChatAdminTitle

SetChatAdminTitle — устанавливает пользовательский титул для администратора чата.

📝 Назначение

Используется для назначения специального отображаемого имени администратора (например, «Главный модератор», «Старший администратор»). Титул виден всем участникам чата рядом с именем администратора.

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

Обозначить роль администратора (модератор, главный администратор и т.д.)
Персонализировать отображение администраторов
Создать иерархию среди администраторов

💡 Совет: Титул отображается в списке участников и в сообщениях администратора. Это хороший способ визуально выделить разных администраторов.

⚙️ Параметры

Параметр	Тип	Обязательный	Описание
chat.id	Integer/String	✅ Да	ID чата или @username группы
user.id	Integer	✅ Да	ID пользователя-администратора
custom_title	String	✅ Да	Присваиваемый титул (максимум 16 символов)

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

Право	Описание
Бот — администратор чата	Обязательное условие
can_promote_members	Право назначать администраторов (для установки титула)

💡 Совет: Бот не может установить титул для администратора, если сам не имеет права can_promote_members.

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

Ограничение	Значение
Максимальная длина титула	16 символов
Допустимые символы	Любые (включая эмодзи)
Сброс титула	Передайте пустую строку (`""`)

⚠️ Важно: Если передать пустую строку, титул будет удалён (администратор перестанет иметь пользовательский титул).

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

Пример 1: Установка титула администратору

Задача: Назначить пользователю титул «Модератор».

Параметры SetChatAdminTitle:

chat.id: ${chat.id}
user.id: ${user.id}
custom_title: Модератор

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

Задача: Назначить титул с эмодзи для наглядности.

Параметры SetChatAdminTitle:

chat.id: ${chat.id}
user.id: ${user.id}
custom_title: ⭐ Главный модератор

Пример 3: Удаление титула

Задача: Убрать пользовательский титул у администратора.

Параметры SetChatAdminTitle:

chat.id: ${chat.id}
user.id: ${user.id}
custom_title: `` (пустая строка)

Пример 4: Установка титула другому администратору

Задача: Администратор бота назначает титул другому администратору по команде.

Обработчик: Команда /settitle @username Суперадмин

Реакции:

TakeUser → получить ID пользователя по username
SetChatAdminTitle →

chat.id: ${chat.id}
user.id: ${target.from.id}
custom_title: Суперадмин

SendMessage → текст: Администратору назначен титул "Суперадмин"

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

Ситуация	Поведение
Титул длиннее 16 символов	Telegram вернёт ошибку
Пользователь не администратор	Реакция не сработает (ошибка)
Пустая строка как титул	Титул удаляется
Смена титула	Старый титул заменяется новым
Кириллица и эмодзи	Поддерживаются (но учитываются в лимите 16 символов)

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

Реакция	Назначение
PromoteChatMember	Назначить администратора
GetChatMember	Получить информацию об участнике
GetChatAdministrators	Получить список администраторов

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

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

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

setChatAdministratorCustomTitle — Telegram Bot API