SetChatDescription

SetChatDescription — изменяет описание чата или канала.

📝 Назначение

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

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

• При создании нового чата — задать описание
• Обновить информацию о чате (правила, тематика)
• Автоматически устанавливать описание при добавлении бота в чат

💡 Совет: Описание поддерживает форматирование ссылками и эмодзи, но не поддерживает Markdown или HTML.

⚙️ Параметры

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

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

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

💡 Совет: Чтобы очистить описание чата, передайте пустую строку ("") в параметр description.

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

Пример 1: Установка описания чата

Задача: Установить описание для группы.

Параметры SetChatDescription:

• chat.id: ${chat.id}
• description: Добро пожаловать в нашу группу! Здесь мы обсуждаем новости и делимся опытом.

Пример 2: Установка описания с ссылкой

Задача: Добавить в описание ссылку на правила.

Параметры SetChatDescription:

• chat.id: ${chat.id}
• description: Правила группы: https://t.me/rules

Пример 3: Очистка описания

Задача: Удалить описание чата.

Параметры SetChatDescription:

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

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

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

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

Реакции:

1. TriggerFolder с условием: проверка, что бот только что добавлен
2. SetChatDescription →

• chat.id: ${chat.id}
• description: Чат управляется ботом. По всем вопросам — @support

Пример 5: Установка описания по команде администратора

Задача: Администратор бота может установить описание командой /setdesc Текст описания.

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

Реакции:

1. SetChatDescription →

• chat.id: ${chat.id}
• description: ${update.match.1}

1. SendMessage → текст: Описание чата обновлено.

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

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

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

🔗 Быстрая навигация

• Вверх
• Параметры
• Требуемые права
• Ограничения
• Примеры
• Особенности

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

setChatDescription — Telegram Bot API