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

Ссылка на шаблоны ботов: https://lcvr.net/s/1zSVVa В этой инструкции мы подробно разберём, как создать бота с рекуррентными платежами, то есть с автоматическим списанием средств по подписке.

Систему рекуррентных платежей можно реализовать в нескольких мессенджерах, например: MAX, ВКонтакте и Telegram.

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

Если у вас еще не подключен ни один канал связи (мессенджер) где будет функционировать ваш бот, самое время подключить его по инструкции ниже, а после вернуться к этой статье.

MAXВКонтактеTelegram старое

Подключаем рекуррентные списания к платежной системе

Теперь перейдём к платёжным системам.

Чтобы в боте работали автоматические списания, нужно подключить платёжную систему. Ниже вы найдёте список доступных вариантов и инструкции по их настройке:

Платёжные системы

Важно! Не все платёжные системы поддерживают рекуррентные платежи. Например, ЮMoney - это кошелёк, и автоматические списания там не работают.

Имейте в виду: даже в подходящих платёжных системах рекуррентные платежи не всегда включены по умолчанию, поэтому необходимо подключать их к магазину самостоятельно.

Подключение рекуррентных платежей к платежным системам

Настраиваем «Подписку» для автоматических списаний

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

Для этого создадим следующие сценарии:

1. Основной бот.Подписка

2. Меню.Подписка

3. Успешное продление подписки.Подписка

4. Необходимо продлить подписку вручную.Подписка

5. Подписка скоро закончится.Подписка

6. Подписка закончилась.Подписка

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

Настраиваем заготовки сценариев

1. Переходим в раздел «Боты».

1. Нажимаем на кнопку «+» для создания нового сценария.

1. Вводим название для нового сценария и нажимаем на кнопку «Создать бота».

1. Заготовка под сценарий успешно сделана! Аналогичным образом создаем оставшиеся сценарии, их структуру мы будем настраивать немного позже.

1. Не забываем активировать их! Иначе они не смогут запуститься.

1. Открываем «Дополнительные настройки» сценария «Основной бот.Подписка» и добавляем стартовое слово /start. Сохраняем.

То, как добавить стартовое слово в сценарий вашего бота, более подробно описано в инструкции ниже:

Как запустить бота? | LeadConverterdocs.leadconverter.su

Отлично! Теперь мы можем переходить к настройкам самой «Подписки».

Настраиваем «Подписку»

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

1. Нажимаем на кнопку «Создать подписку».

1. В поле «Название товара» вводим наименование подписки, которое будет отображаться в вашей кампании LeadConverter.

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

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

Привет! 
Ты оплачиваешь эту подписку чтобы открыть доступ к закрытому клубу "Любители чат-ботов"

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

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

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

В инструкции мы разбираем стандартную настройку подписки с периодом действия 30 дней, поэтому поля «Задержка первого платежа» и «Периодичность платежей», а также информацию в «Дополнительных настройках» оставляем без изменений.

Разберём, как будет работать подписка в данном случае:

После оплаты подписки пользователю будет открыт доступ в клуб на 30 дней.

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

За 1 день до окончания подписки будет совершена попытка списания. Если включены автоматические платежи и оплата пройдёт успешно - доступ продлится автоматически.

Если оплата не пройдёт, бот запустит сценарий ручного продления. В случае успешной оплаты доступ будет продлён, в случае неоплаты - запустится сценарий «Подписка закончилась».

1. Теперь указываем соответствующие сценарии в полях ниже, которые будут запускаться согласно настройкам подписки.

1. Сохраняем подписку. Настройка завершена!

Настраиваем сценарии ботов

Так как рекуррентные платежи могут работать в разных мессенджерах (ВК, Telegram и MAX), часть сценариев будет одинаковой для всех, а часть - отличаться в зависимости от особенностей каждого мессенджера.

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

Создаем бота «Меню.Подписка»

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

1. Нажимаем на кнопку «Редактировать», чтобы перейти к настройке сценария.

По этому стартовому слову пользователь сможет запускать сценарий «Меню.Подписка» в любой момент прохождения воронки. Если захочет включить/выключить автоматические списания.

1. Создаем блок «Разделитель» и от жёлтого выхода блока «Триггеры» проводим к нему связь.

1. Создаем новый блок «Действие» с информацией о подписке пользователя и в режиме редактирования выбираем «Отправить через вебхук».

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

https://leadconverter.ru/api/v1/**** API TOKEN ****/recurrent.info

Вместо "**** API TOKEN ****", вам необходимо указать ВАШ API токен.

Подготавливаемся к работе с API

Обратите внимание: поле «Секретный ключ» нужно оставить пустым!

В поле «Сохранить результат в» устанавливаем переменную result.

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

Параметр	Значение
subscriber_id	{{id}}
offer_id	ID ВАШЕЙ подписки

Обратите внимание: вместо «ID ВАШЕЙ подписки» вам нужно указать ID вашей подписки. Где его скопировать, подробно описано в инструкции ниже:

Как узнать ID подписки в LeadConverter?

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

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

1. Выбираем пункт «Создать новую переменную» и в появившемся окне вводим название «ДатаПодпискаДо».

1. В «Значение» указываем строку ниже.

 [date_calc]%d.%m.%Y %H:%M||{{result.ends_at}}[/date_calc]

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

1. Создаем новую переменную «ДатаСледующегоСписания».

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

[date_calc]%d.%m.%Y %H:%M||{{result.next_withdraw_attempt_at}}[/date_calc]

1. Соединяем связью созданные блоки действия.

1. Сейчас мы настроим возможность отключения или включения автоматического списания. Создаем блок «Условие» и проводим к нему связь от верхнего выхода блока «Разделитель».

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

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

1. В поле «Установить переменную» выбираем переменную «Рекуррент».

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

1. Переходим к редактированию блока «Условие», нажав по нему левой кнопкой мыши.

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

1. В поле «условие» выбираем значение «Равен».

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

1. Создаем блок «Сообщение» и проводим к нему связь от зеленого выхода блока «Условие».

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

1. Добавляем текст сообщения. Этот блок будет отправляться пользователю, если он отключил автоматические списания. Например, текст может быть таким:

Автоматическая подписка отключена (рекуррентные платежи выключены)

Подписка действует до: {{ДатаПодпискаДо}}
‌
‌Это значит, что у бота сейчас нет возможности списывать стоимость подписки каждый месяц.
‌
‌❗После окончания текущего месяца, у вас не будет доступа к каналу и чату. Для того, чтобы попасть в следующий месяц, включите автоматические платежи или оплатите подписку вручную.

Для управления подпиской отправьте команду "Меню" в диалог с чат-ботом.

1. Нажимаем «+ДОБАВИТЬ КНОПКУ» и переходим к ее редактированию, в поле «Текст кнопки» указываем слово «Включить».

1. Сохраняем блок.

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

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

1. Добавляем текст сообщения. Этот блок будет отправляться пользователю, если он подключил автоматические списания. Например, текст может быть таким:

Автоматическая подписка подключена (Рекурректные платежи включены)

Подписка действует до: {{ДатаПодпискаДо}}
‌
‌Это означает, что по окончанию подписки, стоимость подписки на следующий месяц списывается автоматически. Вы остаетесь в канале и чате, Вам не нужно ничего для этого делать:) 
‌
‌❗ Если Вы хотите отказаться от автоматической подписки, нажмите кнопку "Отключить"

Для управления подпиской отправьте команду "Меню" в диалог с чат-ботом.

1. Добавляем кнопку «Отключить» и сохраняем блок.

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

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

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

https://leadconverter.ru/api/v1/ВАШ ТОКЕН/recurrent.disableAutoWithdraw

Обратите внимание: вместо «ВАШ ТОКЕН» вам нужно указать ваш API-токен. Более подробно о том, где его можно скопировать, описано в инструкции ниже:

Подготавливаемся к работе с API

Обратите внимание: поле «Секретный ключ» нужно оставить пустым!

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

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

1. Заполняем параметры по таблице ниже:

Параметр	Значение
subscriber_id	({id})
offer_id	Айди подписки

Обратите внимание, вместо "Айди подписки" вам нужно указать ID вашей подписки.

Как узнать ID подписки в LeadConverter?

1. Сохраняем заполненный блок.

1. От кнопки «Отключить» в блоке «Шаг 2» проводим связь к блоку «Действие 2».

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

1. Добавляем действие «Установить переменную» и присваиваем переменной «Рекуррент» значение «ВЫКЛ». Сохраняем блок.

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

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

Мы настроили ветку сценария отключения автоматических списаний.

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

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

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

https://leadconverter.ru/api/v1/ВАШ ТОКЕН/recurrent.enableAutoWithdraw

Обратите внимание: вместо «ВАШ ТОКЕН» вам нужно указать ваш API токен.

Подготавливаемся к работе с API

Обратите внимание: поле «Секретный ключ» нужно оставить пустым!

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

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

Параметр	Значение
subscriber_id	({id})
offer_id	Айди подписки

Обратите внимание: вместо «ID подписки» вам нужно указать ID вашей подписки. На скриншоте ниже показано, где можно его скопировать.

1. Сохраняем заполненный блок.

1. Проводим связь от кнопки «Включить» в блоке сообщения «Шаг» к блоку «Действие 4».

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

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

Мы успешно настроили сценарий бота «Меню.Подписка»!

Создаем бота «Подписка скоро закончится. Подписка»

Этот бот будет запущен, когда наступит время «Уведомления об окончании подписки», которое мы указывали в настройках «Подписки».

В нашем случае за 2 дня до окончания подписки.

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

1. Открываем блок «Шаг 1» вы режиме редактирования, нажав по нему левой кнопкой мыши.

1. Добавляем элемент «Сообщение» и указываем в нем текст.

Например:

Ваша подписка на клуб Любителей чат-ботов закончится через 2 дня!

Сохраняем блок.

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

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

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

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

Мы успешно настроили сценарий бота «Подписка скоро закончится. Подписка»!

Создаем бота «Успешное продление подписки. Подписка»

Этот бот будет запущен, если система спишет с карты клиента указанную сумму за подписку.

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

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

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

Например:

Ваша подписка успешно продлена!

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

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

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

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

Мы успешно настроили сценарий бота «Успешное продление подписки. Подписка»!

Создаем бота «Необходимо продлить подписку вручную. Подписка».

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

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

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

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

Например:

Подписка скоро закончится! 
‌
‌Чтобы оплатить доступ в клуб Любителей ботов, нажми на кнопку "оплатить" ниже.

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

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

1. Создаем блок «Условие», с помощью которого мы будем проверять, успел ли пользователь продлить текущую подписку или же был исключен из клуба за неуплату. Устанавливаем параметры: «Группа» — «Установлена» — «Оплатили доступ в клуб».

Сохраняем блок.

1. Проводим связь от блока «Сообщение» к блоку «Условие».

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

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

Например:

Ваша подписка успешно продлена!

1. Проводим связь от блока зеленого выхода блока «Условие» к блоку «Сообщение».

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

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

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

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

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

1. Указываем название события «Оплачено продление в клубе». Сохраняем блок.

С помощью этого блока, используя «Обработчик событий» в сценарии «Основной бот.Подписка», мы запустим цепочку выдачи доступа с шага добавления в группу оплативших и выдачи ссылки для вступления - если пользователь уже был исключён из клуба, но решил продлить доступ из этого сообщения.

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

Мы успешно настроили сценарий бота «Необходимо продлить подписку вручную.Подписка».

Настраиваем сценарии с учетом особенностей мессенджеров

Теперь, когда мы настроили общие для всех мессенджеров сценарии, переходим к основным сценариям рекуррентных платежей, которые будут настраиваться под каждый мессенджер отдельно, учитывая его функциональные особенности.

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

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

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

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