ApproveChatJoinRequest
ApproveChatJoinRequest — одобряет заявку пользователя на вступление в чат/канал.
📝 Назначение
Используется для автоматической модерации входящих заявок в чатах с включённым режимом одобрения. После вызова реакции пользователь становится участником чата.
⚠️ Важно: Реакция работает только для чатов, где включён режим «Одобрение заявок» (Join by Request).
⚙️ Параметры
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
| chat.id | Integer/String | ✅ Да | ID чата или @username канала |
| user.id | Integer | ✅ Да | ID пользователя, чью заявку нужно одобрить |
📥 Получение данных из update
При получении заявки бот получает update типа chat_join_request. Необходимые данные доступны по путям:
| Данные | Путь в переменной | Пример |
|---|---|---|
| ID чата | ${update.chat_join_request.chat.id} |
-100123456789 |
| ID пользователя | ${update.chat_join_request.from.id} |
987654321 |
| Имя пользователя | ${update.chat_join_request.from.first_name} |
Иван |
| Username | ${update.chat_join_request.from.username} |
@ivan |
🧪 Пример использования
Пример: Автоматическое одобрение всех заявок
Задача: Все пользователи, подавшие заявку, автоматически принимаются в чат.
Обработчик: Тип chat_join_request
Реакции:
ApproveChatJoinRequest→
chat.id:${update.chat_join_request.chat.id}user.id:${update.chat_join_request.from.id}
SendMessage→
chat_id:${update.chat_join_request.from.id}- Текст:
Добро пожаловать в наш чат!
Пример: Выборочное одобрение
Задача: Принимать только пользователей, указавших в запросе ключевое слово.
Обработчик: Тип chat_join_request
Реакции:
TriggerFolderс условием:String→${update.chat_join_request.bio}содержит"хочу вступить"
- Внутри:
ApproveChatJoinRequest(одобрить) - Внутри:
SendMessage→Добро пожаловать!
TriggerFolderс условием:NOT+ условие выше
- Внутри:
DeclineChatJoinRequest(отклонить) - Внутри:
SendMessage→Извините, ваша заявка отклонена
🔐 Требуемые права бота
| Право | Описание |
|---|---|
| Администратор чата | Бот должен быть администратором чата |
| can_invite_users | Право приглашать пользователей (обязательно) |
💡 Совет: Проверить права бота можно через реакцию
GetChatMemberдля самого бота или в разделе/adm→ Чаты/Каналы.
🔗 Связанные реакции
| Реакция | Назначение |
|---|---|
| DeclineChatJoinRequest | Отклонить заявку |
| BanChatMember | Заблокировать пользователя после вступления |
| GetChatMember | Получить информацию об участнике |
🔗 Связанные разделы
| Раздел | Описание |
|---|---|
| Обработчики «Вход/выход» | Обработка событий входа/выхода |
| Условия | Для проверки данных заявки |