Инструкция для администраторов платформы геткурс по работе со скриптом для контроля телеграм чатов/каналов

Как выдавать и аннулировать доступ ученикам

🟢Чтобы выдать доступ пользователю к каналу нужно:
1. Сначала отправить пользователя привязать себе телеграм на странице /tlgrm
2. Затем запустить по нему процесс "Выдать доступ к телеграм"

Если всё ок, то через 1-2 минуты после запуска процесса пользователю в телеграм придёт сообщение от чат-бота со ссылкой на второго бота. Второй бот выдаёт доступ и скидывает пользователю ссылку на канал.

🟠 Чтобы аннулировать доступ пользователя к каналу нужно:
Запустить по пользователю процесс "Аннулировать доступ к телеграм".

После запуска процесса пользователь будет удалён из канала и чата через 1 минуту.

ℹ️ Процессы по выдаче и аннулировании доступа можно использовать в качестве подпроцессов в тех процессах, которые у вас уже есть. В том числе в процессах по покупкам и заказам.

⚠️ При удалении из канала и чата пользователь будет забанен на 5 минут, затем сможет вступить заново, если приобрёл доступ.

⚠️ Все задержки в процессе важны! Убирать их не стоит!

⚠️ Если у пользователя кончился доступ и он был исключён из канала, а потом решил вернуться и опять оплатил доступ, то для того, чтобы вернуть ему доступ нужно запустить процесс для выдачи доступа снова. Чтобы это автоматизиовать запускайте процессы по выдаче и аннулированию доступа в качестве подпроцесса из ваших процессов с периодической проверкой по покупкам или заказам.

Схема пути пользователя

Работа с доп полями пользователя

В доп полях пользователя добавлены новые поля

Описание полей:

UserID_Telegram — ID пользователя в телеграме. Это поле должно заполняться обязательно. Оно автоматически заполняется в тот момент, когда пользователь переходит по специальной ссылке на второго бота и нажимает в нём кнопку "СТАРТ". Этот момент отмечен на картинке на картинке:

Base64_email — зашифрованный эмейл пользователя (техническое поле). Это поле должно заполняться обязательно. Заполняется процессом.

У канала и чата есть по 2 доп поля пользователя:

Status_TG-1001234567890 — статус пользователя в ТГ канале/чате.

Status_date_TG-1001234567890 — дата изменения статуса пользователя в ТГ канале/чате.

Возможные значения статуса:

Вступил — пользователь подписался на канал.

Забанен — пользователь забанен ботом или админом (при удалении пользователя админом, тоже считается, что он забанен).

Покинул — обычно, когда пользователь сам отписался от канала.

Ограничен — у пользователя изменили права, например право писать (в каналах этот статус не встречается).

Значения этих доп полей можно использовать для выборки пользователей. Например, чтобы отправлять напоминалки тем, кто не дошёл до канала или чата.

Тексты сообщений

Сообщение № 1 — обычное приветственное сообщение геткурсовского чат бота, которое можно отредактировать на этой странице:
https://ВАШ_ДОМЕН/pl/notifications/settings/telegram-settings

Сообщение № 2 — можно отредактировать в процессе «Выдать доступ к телеграм-каналу». Если у вас вдруг возникнет желание переделать этот процесс на отправку сообщения через рассылки — не нужно этого делать, это вызовет проблемы.

Сообщение № 3 — прописано в коде скрипта.
По умолчанию текст этого сообщения такой:

Отлично, почти все готово. Чтобы вступить в наш канал, осталось всего 2 шага:

1. Перейдите по этой ссылке, чтобы подать заявку на вступление в канал:
{CHANNEL_LINK}

2. И буквально через минуту перейдите по той же ссылке, чтобы попасть в сам канал:
{CHANNEL_LINK}

Если требуется заменить тексты сообщении, пришлите мне итоговые варианты, я их заменю.

Решение проблем

- Ученику не пришла ссылка на канал/чат.

Причина 1. Завис процесс на этапе проверки доп поля Base64_email. Если вы видите, что после запуска процесса по выдаче доступа в доп поля Base64_email у ученика пусто, в таком случае вы можете отменить текущую задачу по процессу (или отменить зависшую проверку условия "Base64_email задано") и вручную запустить выдачу доступа ещё раз. Обычно это помогает.

Причина 2. Если ученику пришло сообщение с кнопкой-ссылкой на бота, который выдаёт доступ, но бот не отвечает. Возможно это проблема с хостингом. Проверьте, чтобы он был оплачен.

- У ученика есть ссылка на канал/чта, но его заявка на вступление не принимается.

Причина 1. Ученику не выдали доступ. Обратите внимание, что после того, как у ученика был аннуллирован доступ к каналу, для выдачи доступа нужно снова запустить процесс выдачи доступа по этому ученику.

Причина 2. Возможно это проблема с хостингом. Проверьте, чтобы он был оплачен.

- Ученика не удалило из канала/чата, когда у него кончилась подписка в геткурсе.

Причина 1. У ученика не аннулирован доступ. После того, как подписка на доступ к каналу истечёт в геткурсе, нужно запустить по ученику процесс аннулирования доступа, чтобы его выкинуло из канала.