Рекуррентные платежи в Telegram

Ссылка на шаблоны ботов: https://lcvr.net/s/dSUFo

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

Подготовительный этап перед настройкой

Перед настройкой сценария проверьте, выполнены ли все предыдущие этапы настройки. Без них сценарий рекуррентных платежей работать НЕ БУДЕТ!

Создание подписки через бота (рекуррентные платежи)

Обратите внимание! Перед тем как приступать к настройке основного сценария бота с рекуррентными платежами, вам нужно добавить ВАШЕГО бота в канал/чат в качестве администратора, иначе бот не сможет выдать доступ.

Как добавить Telegram-бота на канал?Как добавить Telegram-бота в группу (чат)?

Для того чтобы бот смог принять заявку на вступление в канал/чат, необходимо настроить ссылки для подачи заявки по инструкции ниже:

Как создать ссылку в Telegram с заявкой на вступление

Создаем сценарий бота "Основной бот.Подписка"

Настраиваем сценарий приема оплаты

1. В разделе «Боты» нажимаем на кнопку «Редактировать» у сценария «Основной бот. Подписка».

1. Открываем блок «Шаг 1» в режиме редактирования и добавляем в него элемент «Товар».

1. В поле «Текст сообщения», указываем текст, который будет получать пользователь при запуске бота, перед оплатой.

Например:

Привет! Это чат-бот помощник клуба "Любителей чат-ботов"

Чтобы открыть доступ к нему, нажми на кнопку "Оплатить" 

1. В поле «Товар» выбираем подписку, которую мы создавали ранее из списка.

1. В поле «Текст кнопки» указываем слово «Оплатить» и сохраняем блок.

1. Создаем новый блок «Действие» и открываем его в режиме редактирования.

1. Нажимаем на кнопку «+ДОБАВИТЬ ДЕЙСТВИЕ».

1. Указываем название новой группы, например «Оплатили доступ в клуб».

1. Нажимаем на кнопку «+ДОБАВИТЬ ДЕЙСТВИЕ» и выбираем «Установить переменную».

1. В поле «Установить переменную» выбираем пункт «+СОЗДАТЬ НОВУЮ ПЕРЕМЕННУЮ» и указываем название «Рекуррент».

1. В «Значение» указываем слово «ВКЛ» и сохраняем блок.

1. Проводим связь от блока «Шаг 1» к блоку «Действие».

1. Создаем новый блок «Действие» и открываем его в режиме редактирования.

1. Нажимаем на кнопку «+ДОБАВИТЬ ДЕЙСТВИЕ» и выбираем из списка «Отправить через вебхук».

1. В поле «URL-адрес обработчика» прописываем строку указанную ниже.

https://api.telegram.org/bot({channel.token})/unbanChatMember

1. Нажимаем на кнопку «+ДОБАВИТЬ ПАРАМЕТР» и вносим параметры из таблицы ниже. Сохраняем блок.

chat_id	Айди вашего канала
user_id	{{user_id}}
only_if_banned	(bool)true

Вместо "Айди вашего канала", указываем ID вашего канала, который вы определяли ранее

Как узнать ID Telegram-канала

1. Проводим связь от блока «Действие» к блоку «Действие 2».

Этот блок снимает блокировку с пользователя в вашем канале.

1. Создаем новый блок «Действие» и открываем его в режиме редактирования.

1. Нажимаем на кнопку «+ДОБАВИТЬ ДЕЙСТВИЕ» и выбираем из списка «Отправить через вебхук».

1. В поле «URL-адрес обработчика» прописываем строку указанную ниже.

https://api.telegram.org/bot({channel.token})/unbanChatMember

1. Нажимаем на кнопку «+ДОБАВИТЬ ПАРАМЕТР» и берём параметры из таблицы ниже. Сохраняем блок.

chat_id	Айди вашего чата
user_id	{{user_id}}
only_if_banned	(bool)true

Вместо "Айди вашего чата", указываем ID вашего чата, который вы определяли ранее

Как узнать ID Telegram-группы (чата)

1. Проводим связь от блока «Действие 2» к блоку «Действие 3».

Этот блок снимает блокировку с пользователя в вашем чате.

1. Создаем новый блок «Сообщения» и открываем его в режиме редактирования.

1. Добавляем элемент «Сообщение» в блок и прописываем в нём текст, где будут указаны ссылки для вступления в ваш закрытый клуб. Сохраняем блок.

Например:

Оплата успешно прошла! Чтобы попасть в наш клуб - подай заявку по ссылкам ниже.

Ссылка на канал: ВАША ССЫЛКА 
Ссылка на чат: ВАША ССЫЛКА

Очень рады, что ты с нами!

Вместо «ВАША ССЫЛКА» вы указываете ссылки, которые создали ранее, для подачи заявки в ваш закрытый клуб.

Как создать ссылку в Telegram с заявкой на вступление

1. Проводим связь от блока «Действие 3» к блоку «Шаг 2».

1. Создаем новый блок «Действие» и открываем его в режиме редактирования.

1. Выбираем действие «Запустить бота».

1. Указываем сценарий бота «Меню. Подписка» и сохраняем блок.

1. Проводим связь от блока "Шаг 2" к блоку "Действие 4".

1. Создаем блок "Обработчик событий" и в режиме редактирования нажимаем на кнопку "+ДОБАВИТЬ СОБЫТИЕ".

1. Заполняем данными строку "Имя события". Здесь мы указываем событие, которые устанавливали в сценарии "Необходимо продлить подписку вручную.Подписка". Сохраняем блок.

Оплачено продление в клубе

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

Настраиваем триггеры для принятия заявки

1. Открываем блок "Триггеры" в режиме редактирования.

1. Нажимаем на кнопку "+ДОБАВИТЬ ТРИГГЕР".

1. Из выпадающего списка выбираем триггер "Подал заявку для вступления в канал/группу".

Более подробно про этот триггер, вы можете прочитать в инструкции ниже.

Подал заявку на вступление в канал/группу

1. В поле " В канале(ах)" выбираем вашего бота, который был добавлен в канал/чат в качестве администратора, из выпадающего списка.

1. В поле "ID каналов/группы" укажите ID вашего канала/чата, в который бот должен выдать доступ после оплаты. Сохраняем блок.

Аналогичным образом заполняем второй триггер для подачи заявки в канал/чат.

Как определить ID вашего канала или чата подробно описано в инструкциях ниже. Обратите внимание, корректный ID всегда начинается с -100..

Как узнать ID Telegram-каналаКак узнать ID Telegram-группы (чата)

Мы успешно настроили триггеры для принятия заявки в ваш закрытый клуб.

Настраиваем сценарий приема заявки

1. Создаем новый блок "Условие" и открываем его в режиме редактирования.

1. Нажимаем на кнопку "+ДОБАВИТЬ УСЛОВИЕ".

1. В поле "Параметр" выбираем из выпадающего списка значение "Группа".

1. В поле "условие" указываем пункт "Установлена".

1. В поле "Выбор группы" указываем ранее созданную нами группу "Оплатили доступ в клуб". Сохраняем блок.

1. Проводим связь от первого фиолетового выхода блока "Триггеры" к блоку "Условие". В нашем примере этот триггер отвечает за прием заявки на вступление в канал.

1. Создаем новый блок "Действие" и открываем его в режиме редактирования.

1. Нажимаем на кнопку "+ДОБАВИТЬ ДЕЙСТВИЕ" и выбираем пункт "Отправить через вебхук".

1. В поле "URL-адрес обработчика" прописываем адрес, который указан ниже.

https://api.telegram.org/bot({channel.token})/approveChatJoinRequest

1. В поле "Сохранить результат в" указываем переменную return.

1. Нажимаем на кнопку "+ДОБАВИТЬ ПАРАМЕТР" и заполняем строки данными из таблицы ниже. Сохраняем блок.

Параметр	Значение
chat_id	Айди вашего канала/чата
user_id	{{user_id}}

Вместо значения "Айди вашего канала/чата" укажите ID вашего канала/чата, который вы определяли ранее.

1. Проводим связь от зеленого выхода блока "Условие" к блоку "Действие 5".

Этот блок действие отвечает за принятие пользователя в канал, если он оплатил доступ.

1. Создаем новый блок "Сообщение" и открываем его в режиме редактирования.

1. Добавляем в него элемент "Сообщение" и указываем текст, который получит пользователь, после того как бот примет его в канал. Сохраняем блок.

Например:

Добро пожаловать в закрытый клуб! Уже принял тебя в канал, проверяй!

1. Проводим связь от блока "Действие 5" к блоку "Шаг 3".

1. Создаем новый блок "Действие" и открываем его в режиме редактирования.

1. Добавляем действие "Отправить через вебхук".

1. В поле "URL-адрес обработчика" прописываем адрес, который указан ниже.

https://api.telegram.org/bot({channel.token})/declineChatJoinRequest

1. В поле "Сохранить результат в" указываем переменную return.

1. Нажимаем на кнопку "+ДОБАВИТЬ ПАРАМЕТР" и заполняем строки данными из таблицы ниже. Сохраняем блок.

Параметр	Значение
chat_id	Айди вашего канала/чата
user_id	{{user_id}}

Вместо значения "Айди вашего канала/чата" укажите ID вашего канала/чата, который вы определяли ранее.

1. Проводим связь от красного выхода блока "Условие" к блоку "Действие 6".

Этот блок действие отвечает за отклонение заявки на вступление, если пользователь хочет попасть в клуб, не оплатив доступ. Это исключает вероятность "зайцев", в вашем клубе, которым передали ссылку для вступления знакомые, оплатившие доступ.

1. Проводим связь от блока "Действие 6" к блоку "Шаг 1".

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

1. С зажатой клавишей Shift выделяем цепочку, которую настроили для вступления в канал, и нажимаем комбинацию клавиш ctrl+c.

1. Нажимаем комбинацию клавиш ctrl+v для добавления скопированных блоков в сценарий.

1. В блоках действия, новой цепочки, нам необходимо заменить ID канала, на ID чата. Для этого открываем их в режиме редактирования и указываем нужный ID. Сохраняем блок.

1. После того, как вы заменили в обоих блоках "Действия" ID канала на ID чата, проводим связь от свободного фиолетового выхода блока "Триггеры", к блоку "Условие".

1. От нижнего блока "Действие" проводим связь к блоку "Шаг 1".

1. Создаем блок "Обработчик событий" и в режиме редактирования нажимаем на кнопку "+ДОБАВИТЬ СОБЫТИЕ".

1. Заполняем данными строку "Имя события". Здесь мы указываем событие, которые устанавливали в сценарии "Необходимо продлить подписку вручную.Подписка". Сохраняем блок.

Оплачено продление в клубе

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

Мы успешно настроили сценарий бота "Основной бот.Подписка"!

Создаем сценарий бота "Подписка закончилась.Подписка".

1. Переходим в раздел "Боты" и нажимаем на кнопку "Редактировать" у сценария "Подписка закончилась. Подписка".

1. Создаем новый блок "Действие" и открываем его в режиме редактирования.

1. Добавляем действие "Отправить через вебхук".

1. В поле "URL-адрес обработчика" прописываем адрес, который указан ниже.

https://api.telegram.org/bot({channel.token})/banChatMember

1. В поле "Сохранить результат в" указываем переменную return.

1. Нажимаем на кнопку "+ДОБАВИТЬ ПАРАМЕТР" и заполняем строки данными из таблицы ниже. Сохраняем блок.

Параметр	Значение
chat_id	Айди вашего канала
user_id	{{user_id}}

Вместо значения "Айди вашего канала" укажите ID вашего канала, который вы определяли ранее.

Как узнать ID Telegram-канала

1. Проводим связь от блока "Триггеры" к блоку "Действие".

Этот блок исключает пользователя из канала за неуплату.

1. Создаем новый блок "Действие" и открываем его в режиме редактирования.

1. Добавляем действие "Отправить через вебхук".

1. В поле "URL-адрес обработчика" прописываем адрес, который указан ниже.

https://api.telegram.org/bot({channel.token})/banChatMember

1. В поле "Сохранить результат в" указываем переменную return.

1. Нажимаем на кнопку "+ДОБАВИТЬ ПАРАМЕТР" и заполняем строки данными из таблицы ниже. Сохраняем блок.

Параметр	Значение
chat_id	Айди вашего чата
user_id	{{user_id}}

Вместо значения "Айди вашего чата" укажите ID вашего чата, который вы определяли ранее.

Как узнать ID Telegram-группы (чата)

Этот блок исключает пользователя из чата за неуплату.

1. Проводим связь от блока "Действие" к блоку "Действие 2".

1. Создаем новый блок "Действие" и открываем его в режиме редактирования.

1. Выбираем действие "Удалить из группы".

1. Выбираем группу "Оплатили доступ в клуб" и сохраняем блок.

1. Проводим связь от блока "Действие 2" к блоку "Действие 3".

1. Создаем новый блок "Сообщение" и открываем его в режиме редактирования.

1. Добавляем в блок элемент "Сообщение" и указываем в нем текст, который получит пользователь после исключения из клуба. Сохраняем блок.

Например:

Ваша подписка на закрытый клуб "Любителей чат-ботов" закончилась.

1. Проводим связь от блока "Действие 3" к блоку "Шаг".

1. Создаем новый блок "Действие" и открываем его в режиме редактирования.

1. Добавляем действие "Запустить бота".

1. Выбираем сценарий бота "Основной бот.Подписка" и сохраняем блок.

1. Проводим связь от блока "Шаг" к блоку "Действие 4".

Мы успешно настроили сценарий бота "Подписка закончилась.Подписка"! Теперь можем приступать к тестированию.

Тестируем работу бота

Перед запуском тестирования, проверьте, выполнены ли все предыдущие этапы настройки. Без них сценарий рекуррентных платежей работать НЕ БУДЕТ!

1. Редактируем созданную нами ранее подписку для тестового режима, как показано на скриншоте ниже. После проведения тестирования параметры необходимо вернуть обратно.

Для проведения тестирования, можно установить стоимость подписки 5 рублей (для Prodamus минимальный платеж составляет 50 рублей.)

1. Запускаем сценарий "Основной бот.Подписка" в мессенджере, по прямой ссылке на запуск или по стартовому слову /start.

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

Как запустить бота?

1. Нажимаем на кнопку "Оплатить" проходим процедуру оплаты подписки для активации рекуррентных списаний. Далее проводим тестирования работы вашего бота.

2. Далее ожидаем, когда бот отправит все сообщения в случае активированного рекуррентного списания. После этого - отключаем автоматические платежи.

3. Проверяем, что все сообщения цепочки, которая запускается при отключенных автоматических платежах приходят корректно.

4. После проведения тестирования всех вариаций, возвращаем настройки подписки к изначальным.

Мы успешно настроили работу бота с рекуррентными платежами в Telegram!

Если вы хотите настроить сценарий рекуррентных платежей для мессенджера МАХ или Вконтакте, перейдите к нужной инструкции по ссылкам ниже.

Рекуррентные платежи в MAXРекуррентные платежи во ВКонтакте

Остались вопросы? Задавайте их нам в техническую поддержку, мы будем рады вам помочь!

💟Как задать вопрос в поддержку?