LeaveChat
LeaveChat — бот покидает указанный чат или канал.
📝 Назначение
Используется для автоматического выхода бота из чата по определённым условиям.
Когда это нужно:
- Бот больше не нужен в группе
- Автоматический выход при нарушении правил администраторами группы
- Очистка после завершения временной задачи
- Выход из чата, где бот был добавлен без разрешения
🔴 Важно: Операция необратима через бота. Для повторного входа бота в чат его нужно снова добавить через приглашение или настройки группы.
⚙️ Параметры
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
| chat.id | Integer/String | ✅ Да | ID чата/канала, который бот должен покинуть |
🔐 Требуемые права бота
| Тип чата | Требуемые права |
|---|---|
| Группа/супергруппа | Бот должен быть участником чата |
| Канал | Бот должен быть администратором канала |
💡 Совет: Права на выход не требуются — бот может покинуть любой чат, участником которого является.
🧪 Примеры использования
Пример 1: Выход из текущего чата
Задача: Бот покидает группу, откуда пришла команда.
Обработчик: Команда /leave
Реакции:
SendMessage→ текст:До свидания! Бот покидает чат.LeaveChat→chat.id:${chat.id}
Пример 2: Выход из чата при нарушении
Задача: Если администратор удалил права бота — бот выходит.
Обработчик: Тип my_chat_member (изменился статус бота)
Условие: статус изменился с administrator на member
Реакции:
SendMessage→ текст:Права администратора отозваны. Бот покидает чат.LeaveChat→chat.id:${chat.id}
Пример 3: Выход из чата по команде администратора
Задача: Только администратор бота может дать команду на выход.
Обработчик: Команда /leave
Реакции:
TriggerFolderс условием:IsOwner(только владелец бота)
- Внутри:
LeaveChat→chat.id:${chat.id} - Внутри: (опционально) уведомление об успешном выходе
Пример 4: Выход из чата по ID
Задача: Бот покидает конкретный чат по его ID.
Реакции:
LeaveChat→chat.id:-100123456789
🔄 Особенности поведения
| Ситуация | Поведение |
|---|---|
| Бот уже не в чате | Реакция не вызывает ошибку |
| Выход из личного чата | Невозможно — бот не может покинуть диалог с пользователем |
| После выхода | Бот перестаёт получать обновления из этого чата |
| Повторный вход | Только через приглашение или добавление администратором |
⚠️ Важное предупреждение
После выхода бота из чата:
- Бот не будет получать сообщения из этого чата
- Бот не сможет вернуться самостоятельно (нужно приглашение)
- Все данные о чате в кэше бота остаются, но не обновляются
💡 Совет: Перед выходом отправьте прощальное сообщение, чтобы пользователи понимали, что произошло.
🔗 Связанные реакции
| Реакция | Назначение |
|---|---|
| GetChat | Получить информацию о чате |
| LoadChat | Загрузить данные чата из кэша |
🔗 Связанные разделы
| Раздел | Описание |
|---|---|
| Чаты/Каналы в админке | Управление чатами через интерфейс |