Исключение подписчика из группы в Telegram в случае неоплаты подписки в GetCourse

Как автоматически исключать подписчиков из закрытой группы/чата в Telegram, если они не продлили свою подписку через GetCourse

С помощью интеграции и процессов внутри GetCourse есть возможность отправлять информацию о подписчике и его заказе из GetCourse в BotHelp, чтобы взаимодействовать с подписчиком через бота. Одним из примеров использования интеграции может быть автоматическое исключение подписчика из закрытой группы в Telegram в случае неоплаты очередной подписки в GetCourse.

Общее описание сценария

Интеграция GetCourse и BotHelp, настроенная по данному сценарию, позволит автоматически исключить ваших подписчиков из закрытых групп или чатов в Telegram, если они не продлили свою подписку в GetCourse.

Допущения в рамках этого сценария:

  • Подписка оформляется на длительный промежуток времени, поэтому настроенный процесс будет запускать вручную в нужный момент
  • Считаем, что подписчик уже состоит в закрытой группе Telegram и ранее оплачивал подписку
  • В вашем кабинете GetCourse уже было создано предложение для первой подписки. Подписчики для оформления первой подписки оформляли заказ на это предложение

Основные этапы процесса:

  1. Подходит срок оплаты очередной подписки на закрытый чат/группу в Telegram
  2. Подписчик по какой-то причине не продлевает подписку
  3. В GetCourse запускается процесс, который проверяет наличие оплаченной подписки у подписчиков
  4. Для всех подписчиков, которые не продлили подписку, из процесса GetCourse запускается специальный бот в BotHelp
  5. Этот бот исключает подписчиков из закрытого чата/группы в Telegram

Настройка воронки в BotHelp

1. Создание и настройка бота

  • Создайте бота для Telegram канала
  • Добавьте блок "Действие"
  • Выберите тип действия "Исключить из группы/канала"
  • Укажите идентификатор Вашей закрытой группы, из которой необходимо удалить подписчика
    • Более подробную инструкци по работе с группами и каналами в Telegram читайте по ссылке

  • При необходимости можно отправить какое-нибудь сообщение или добавить метку
  • В итоге получается вот такой простой бот:

2. Получение данных для дальнейшей настройки интеграции

Для дальнейшей настройки интеграции нам понадобится:

  • Получить Ref созданного бота:
    • Останьтесь в текущем открытом окне - редакторе бота
    • Нажмите на кнопку настроек "Шестеренка" в верхнем правом углу
    • Нажмите на подпункт "Настройки"
    • В открывшемся окне разверните "Дополнительные настройки"
    • В самом низу открывшегося окна найдите поле с названием "Ref бота" - это идентификатор этого бота
    • Скопируйте/запишите его - он пригодится позже


  • Получить Ref шага
    • Останьтесь в текущем открытом окне - редакторе бота
    • Перейдите в режим редактирования бота, кликнув на кнопку "Редактировать" в верхнем правом углу
    • Откройте панель редактирования первого шага созданного бота
      • В нашем примере это шаг "Действие 1"
    • Ref шага отображается в верхней части панели под названием шага - это идентификатор этого шага
    • Скопируйте/запишите его - он пригодится позже


  • Получить BotHelp SecretKey
    • Перейдите в раздел "Настройки" в панели навигации вашего кабинета
    • Откройте владку "Интеграции"
    • Найдите блок GetCourse и нажмите кнопку "Добавить интеграцию"
    • Скопируйте/запишите полученный BotHelp SecretKey - он пригодится позже


Этапы настройки в GetCourse

1. Создание продукта

  • Перейдите в раздел "Продажи" - "Продукты" и нажмите кнопку "Добавить продукт"
  • Дайте продукту название
  • Задайте стоимость предложения

  • После сохранения продукта перейдите на кладку "Предложения" и откройте созданное предложение (его название совпадает с названием продукта)
  • Убедитесь, что у предложения активен чекбокс "Завершать заказ автоматически при получении оплаты"
    • В таком случаем для этого предложения заказы будут автоматически переходить в статус "Завершен" после получения оплаты

2. Создание процесса

  • Перейдите в раздел "Задачи" - "Процессы" и нажмите на кнопку "Создать процесс"

  • Укажите название процесса
  • Тип объекта выберите "Пользователи"
  • В поле  шаблон ничего указывать не нужно - вариант "без шаблона"
  • Нажмите на кнопку "Создать"

3. Настройка процесса

  • В настройках созданного процесса в разделе "Массовое создание задач" выберите пункт "Единоразово после запуска"

    • В таком случае созданный процесс будет запущен только один раз сразу после запуска

  • В правилах вхождения объекта задайте следующую логику:

    • У пользователя уже есть оплаченная подписка за предыдущий период

    • У пользователя нет оплаченной подписки на текущий период


4. Создание логики процесса

  • В настройках созданного процесса перейдите на вкладку "Процесс" для дальнейшей настройки логики работы самого процесса
  • Добавьте блок "Операция"
    • Укажите имя блока
    • Блок должен работать по Пользователю
    • Выберите тип операции - "Вызвать URL"
  • В настройках блока необходимо выбрать метод "POST"

  • В графе URL необходимо вставить ссылку: 
https://gc.bothelp.io?domain_name={%Ваш домен в Bothelp%}&token={%Ваш SecretKey из кабинета BotHelp%}&email={object.email}&phone={object.phone}&actions[run_bot]={%Ref вашего бота%}&actions[step_ref]={%Ref шага вашего бота%}
  • ВАЖНО!

    • В графе domain_name   вместо текста  {%Ваш домен в Bothelp%} необходимо указать домен вашего кабинета в Bothelp. Фигурные скобки {} и знаки  процента % нужно удалить. Итоговая запись будет в таком формате: domain_name=mybhaccount 
    • В графе   token   вместо текста  {%Ваш SecretKey из кабинета BotHelp%} необходимо указать BotHelp SecretKey из настроек интеграции вашего кабинета (см. первый раздел данной инструкции). Фигурные скобки {} и знаки  процента % нужно удалить. Итоговая запись будет в таком формате:  token=qwerty123456  
    • В графе   actions[run_bot]   вместо текста  {%Ref вашего бота%} необходимо указать Ref бота, в которого нужно добавить подписчика (см. второй пункт данной инструкции). Фигурные скобки {} и знаки процента % нужно удалить. Итоговая запись будет в таком формате:  actions[run_bot]=c123456789 
    • В графе    actions[step_ref]    вместо текста  {%Ref шага вашего бота%} необходимо указать Ref шага бота, на который нужно добавить подписчика (см. второй пункт данной инструкции). Фигурные скобки {} и знаки процента % нужно удалить. Итоговая запись будет в таком формате:  actions[step_ref]=f987654321 
    • Пример готовой ссылки:
https://gc.bothelp.io?domain_name=mybhaccount&token=qwerty123456&email={object.email}&phone={object.phone}&actions[run_bot]=c123456789&actions[step_ref]=f987654321


  • Зачем эта ссылка?

    • С помощью этой ссылки Getcourse отправляет данные о подписчике и типе действия, чтобы BotHelp мог выполнить указанное действие с указанным подписчиком
    • В этой ссылке указываются необходимые данные о подписчике и действии:
      • email - это почта подписчика. По ней Bothelp находит конкретного подписчика в своей базе. Это обязательное поле при идентификации подписчика по email
      • domain_name - название вашего кабинета в Bothelp. По этому полю Bothelp понимает, в каком именно кабинете искать подписчика с такой почтой. Это обязательное поле
      • token - это секретный ключ вашего кабинета BotHelp, который обеспечивает безопасность работы интеграции. Это обязательное поле
      • phone - телефон подписчика. По нему Bothelp также может найти конкретного подписчика в своей базе, если по почте находится несколько подписчиков. Это необязательное поле
      • actions[run_bot] и actions[step_ref] - параметры, которые обозначают команду "Добавить в бота на определенный шаг". В значении параметров указываются идентификаторы бота и его шага, на который нужно добавить подписчика. 
        • actions[run_bot] - обязательное поле
        • actions[step_ref] - необязательное поле. Если этого параметра нет, то бот для подписчика будет запущен с шага Старт
  • Сохраните данный блок
  • Добавьте блок "Завершение процесса" и протяните связи между блоками
  • Итоговый процесс должен выглядеть вот так:

  • Готово! На вкладке "Общее" создаваемого процесса активируйте чекбокс "Одобрено"
  • По готовности нажмите большую зеленую кнопку "Запустить" - процесс запустится и выполнится один раз.

Если вы не нашли ответ на свой вопрос, задайте его нам в чате внутри кабинета либо напишите на hello@bothelp.io 😃

Получите 14 дней полного функционала платформы для создания рассылок, автоворонок и чат-ботов BotHelp:

Получить 14 дней бесплатно

👆 На этом пока всё