В своей статье Владислав Сереберцев рассказал о том, как настроив интеграцию с API Telegram, можно определять язык пользователя и управлять доступом к боту на основе языковых предпочтений
Шаг 1 — Выпускаем токен для входящих запросов
1. Открываем вкладку "Настройки".
2. Переходим в раздел "Интеграции".
3. Нажимаем кнопку "Сгенерировать API токен".
4. Скопируем появившийся токен в буфер обмена.
Шаг 2 — Создаем интегрированную переменную
Мы создадим переменную, которая будет получать значение языка пользователя в Telegram через API запрос. Разберем настройки:
1. Открываем вкладку "Переменные".
2. Добавляем переменную.
3. Задаём свое название, или пишем {{DATA_LANG_CODE}}.
4. Выбираем тип значения "Интегрированная".
5. Выбираем тип интеграции "HTTP Запрос"
6. В поле ссылка указываем "https://api.puzzlebot.top/?token=(ВАШ_ТОКЕН_ИНТЕГРАЦИИ из прошлого шага)&method=getUserInChatStatus".
7. Выбираем тип запроса "GET".
8. Добавляем параметр user_id: {{USER_ID_TEXT}}.
9. Добавляем параметр chat_id: {{BOT_ID_TEXT}}.
10. Нажимаем кнопку "Проверить запрос", получаем успех результирующего запроса.
11. Выбираем ответ: data.language_code
12. В самом низу нажимаем кнопку "Сохранить переменную". На этом этапе настройка интегрированной переменной считается завершенной.
Шаг 3 — Создаем условие проверки языка
Создадим условие, которое будет проверять язык пользователя в переменной и разрешать доступ, если язык соответствует настройкам. Разберем подробнее:
1. Создаем условие в конструкторе (Подробнее...).
2. Добавляем проверку "Значение переменной".
3. В названии переменой напишем название переменной, например, переменная {{DATA_LANG_CODE}}.
4. Тип условия остается "Полное совпадение", в фразах пишем код языков, которые пропускаем для работы с ботом дальше.
5. Выбираем действие "Отправить команду или условие" в случае, если правило выполняется.
6. Если правило не было выполнено, сработает исключающее правило. В нем настраиваем действие "Заблокировать пользователя", выбираем "Заблокировать навсегда". Заблокированный пользователь не будет учитываться в модерации и считаться нашим подписчиком.
Шаг 4 — Ключевые этапы настройки
1. Генерация API-токена – выполняется для конкретного бота по определенному запросу.
2. Создание интегрированной переменной – позволяет получать данные о языке пользователя через HTTP-запрос.
3. Настройка условия проверки языка – автоматически фильтрует пользователей, разрешая доступ только выбранным языкам, а остальных блокируя.
Эта система не только упрощает модерацию, но и делает бота более удобным для целевой аудитории. Реализовав такой механизм, можно эффективнее управлять аудиторией.
Хотите задать вопрос эксперту? Пишите его в комментарии под последним постом в нашем канале, самые интересные попадут на разбор.
