# Создание бота с рекуррентными платежами (автоматическими списаниями)
Ссылка на шаблоны ботов: [https://lcvr.net/s/1zSVVa ](https://lcvr.net/s/1zSVVal)\
В этой инструкции мы подробно разберём, как создать бота с **рекуррентными платежами** - то есть с **автоматическим списанием средств по подписке**. \
\
Систему рекуррентных платежей можно реализовать в нескольких мессенджерах, например: **MAX, ВКонтакте и Telegram.**
Мы пошагово рассмотрим, как настроить логику подписок, подключить платёжные системы и сделать так, чтобы списания происходили автоматически и без ошибок. Поехали!
{% hint style="info" %}
Если у вас еще **не подключен** ни один канал связи (мессенджер) где будет функционировать ваш бот, самое время подключить его по инструкции **ниже**, а после вернуться к этой статье.
{% endhint %}
{% content-ref url="../../podklyuchenie-messendzherov/max" %}
[max](https://docs.leadconverter.su/podklyuchenie-messendzherov/max)
{% endcontent-ref %}
{% content-ref url="../../podklyuchenie-messendzherov/vkontakte" %}
[vkontakte](https://docs.leadconverter.su/podklyuchenie-messendzherov/vkontakte)
{% endcontent-ref %}
{% content-ref url="../../podklyuchenie-messendzherov/telegram" %}
[telegram](https://docs.leadconverter.su/podklyuchenie-messendzherov/telegram)
{% endcontent-ref %}
## Подключаем рекуррентные списания к платежной системе
Теперь перейдём к **платёжным системам**.
Чтобы в боте работали автоматические списания, нужно подключить **платёжную систему.** \
Ниже вы найдёте список доступных вариантов и инструкции по их настройке.
{% content-ref url="../../priyom-platezhei" %}
[priyom-platezhei](https://docs.leadconverter.su/priyom-platezhei)
{% endcontent-ref %}
{% hint style="warning" %}
**Важно**! Не все платёжные системы поддерживают рекуррентные платежи. Например, **ЮMoney** - это кошелёк, и автоматические списания там **не работают.**
{% endhint %}
Также имейте в виду, что даже в подходящих платёжных системах рекуррентные платежи **не всегда включены по умолчанию**, поэтому необходимо подключать их к магазину **самостоятельно.**
Ниже мы отдельно разобрали, как настроить рекуррентные платежи для разных платёжных систем, в которых они не подключены сразу:
{% content-ref url="../../priyom-platezhei/yukassa-yandeks.kassa/podklyuchenie-rekurrentnykh-platezhei-v-yukasse-yukassa" %}
[podklyuchenie-rekurrentnykh-platezhei-v-yukasse-yukassa](https://docs.leadconverter.su/priyom-platezhei/yukassa-yandeks.kassa/podklyuchenie-rekurrentnykh-platezhei-v-yukasse-yukassa)
{% endcontent-ref %}
{% content-ref url="../../priyom-platezhei/prodamus-prodamus/podklyuchenie-rekurrentnykh-platezhei-v-prodamus-prodamus" %}
[podklyuchenie-rekurrentnykh-platezhei-v-prodamus-prodamus](https://docs.leadconverter.su/priyom-platezhei/prodamus-prodamus/podklyuchenie-rekurrentnykh-platezhei-v-prodamus-prodamus)
{% endcontent-ref %}
{% content-ref url="../../priyom-platezhei/robokassa-robokassa/podklyuchenie-rekurrentnykh-platezhei-v-robokasse-robokassa" %}
[podklyuchenie-rekurrentnykh-platezhei-v-robokasse-robokassa](https://docs.leadconverter.su/priyom-platezhei/robokassa-robokassa/podklyuchenie-rekurrentnykh-platezhei-v-robokasse-robokassa)
{% endcontent-ref %}
{% content-ref url="../../priyom-platezhei/tinkoff-tinkoff/podklyuchenie-rekurrentnykh-platezhei-v-tinkoff-tinkoff" %}
[podklyuchenie-rekurrentnykh-platezhei-v-tinkoff-tinkoff](https://docs.leadconverter.su/priyom-platezhei/tinkoff-tinkoff/podklyuchenie-rekurrentnykh-platezhei-v-tinkoff-tinkoff)
{% endcontent-ref %}
{% content-ref url="../../priyom-platezhei/sloudpayments/podklyuchenie-rekurrentnykh-platezhei-v-sloudpayments" %}
[podklyuchenie-rekurrentnykh-platezhei-v-sloudpayments](https://docs.leadconverter.su/priyom-platezhei/sloudpayments/podklyuchenie-rekurrentnykh-platezhei-v-sloudpayments)
{% endcontent-ref %}
## Настраиваем "Подписку" для автоматических списаний
Перед настройкой подписки сначала **создадим нужные сценария для бота с автоматическими списаниями**, их будет несколько. Они понадобятся, чтобы рекуррентные платежи работали корректно и пользователь получал нужные уведомления.
Для этого создадим следующие сценарии:
1. Основной бот.Подписка
2. Меню.Подписка
3. Успешное продление подписки.Подписка
4. Необходимо продлить подписку вручную.Подписка
5. Подписка закончилась.Подписка
Эти сценарии будут отвечать за **управление** подпиской, **уведомления** пользователя и **обработку** разных ситуаций, связанных с оплатой.
### Настраиваем заготовки сценариев
1. Переходим в раздел "**Боты**".
2. Нажимаем на кнопку "**+**", для создания нового сценария.
3. Вводим название для нового сценария и нажимаем на кнопку "**Создать бота**".
4. Заготовка под сценарий **успешно** сделана! Аналогичным образом создаем оставшиеся сценарии, их структуру мы будем настраивать немного позже.
5. Не забываем **активировать** их! Иначе они **не смогут** запуститься.
6. Открываем "**Дополнительные настройки**" сценария "**Основной бот.Подписка**" и добавляем стартовое слово **/start**. **Сохраняем**.
{% hint style="info" %}
Более подробно о том, **как добавить стартовое слово** в сценарий вашего бота, описано в инструкции **ниже**
{% endhint %}
{% embed url="" %}
Отлично! Теперь мы можем переходить к настройкам самой "**Подписки**".
### Настраиваем "Подписку"
1. Переходим в раздел "**Товары**" и выбираем пункт "**Подписки**".
2. Нажимаем на кнопку "**Создать подписку**".
3. В поле "**Название товара**" вводим наименование подписки, которое будет отображаться в вашей кампании **LeadConverter**.
4. В поле "**Заголовок**" указываем название подписки, которое будет видеть пользователь при оплате.
5. В поле "**Текст сообщения**" вы можете добавить описание вашей подписки, например:
```
Привет!
Ты оплачиваешь эту подписку чтобы открыть доступ к закрытому клубу "Любители чат-ботов"
```
6. В поле "**Цена**" вам нужно указать стоимость **первой оплаты** вашей подписки, именно эту сумму пользователь будет оплачивать в первый раз для получения доступа в клуб.
7. В поле "**Платежная система**" выбираем платежную систему из списка, которую вы подключали в начале инструкции.
8. Устанавливаем **сумму рекуррентного платежа**. Именно ее пользователь будет оплачивать автоматически, при включенных рекуррентных списаниях.
{% hint style="info" %}
В инструкции мы разбираем **стандартную настройку подписки**, периодом действия **30 дней**, поэтому поля **"Задержка первого платежа"** и "**Периодичность платежей**", а так же информацию в "**Дополнительных настройках**" оставляем **без изменений.**
{% endhint %}
{% hint style="info" %}
Разберем, как будет работать подписка в данном случае: \
\
После оплаты подписки, пользователю будет открыт доступ в клуб на **30 дней**. \
\
**За 2 дня** до окончания подписки, бот уведомит пользователя о том, что скоро подписка закончится.\
\
**За 1 день** до окончания подписки - будет совершена попытка списания ( если включены \
автоматические платежи, и оплата пройдет успешно - доступ продлится автоматически).\
\
Если оплата не пройдет - бот запустит сценарий ручного продления. В случае оплаты - продлит доступ, в случае неоплаты - удалит пользователя из клуба на 30 день.
{% endhint %}
9. Теперь указываем соответствующие сценарии в полях ниже, которые будут запускаться согласно настройкам подписки.
10. Сохраняем подписку. Настройка **завершена**!
## Настраиваем сценарии ботов
Так как рекуррентные платежи могут работать в разных мессенджерах (**ВК, Telegram и Max**), часть сценариев будет **одинаковой** для всех, а часть - **отличаться** в зависимости от особенностей каждого мессенджера.
Сначала мы разберём **сценарии с одинаковой структурой,** которые подходят для всех мессенджеров. Затем отдельно рассмотрим, как адаптировать остальные сценарии под каждый мессенджер отдельно.
### Создаем бота "Меню.Подписка"
1. Переходим в раздел "**Боты**". У сценария "**Меню.Подписка**", разворачиваем "**Дополнительные настройки**" и добавляем стартовое слово "**Меню**". Сохраняем стартовые слова.
2. Нажимаем на кнопку "**Редактировать**" чтобы перейти к настройке сценария.
{% hint style="info" %}
По этому стартовому слову пользователь сможет запускать сценарий "**Меню.Подписка**" в любой момент прохождения воронки. Если захочет включить/выключить автоматические списания.
{% endhint %}
3. Создаем блок "**Разделитель**" и от желтого выхода блока "**Триггеры**" проводим к нему связь.
4. Создаем новый блок "**Действие**" и в режиме редактирования выбираем "**Отправить через вебхук**".
4. В поле "**URL-адрес обработчика**" указываем строку ниже.
```
https://leadconverter.ru/api/v1/**** API TOKEN ****/recurrent.info
```
{% hint style="info" %}
Вместо "**\*\*\*\* API TOKEN \*\*\*\***", вам необходимо указать **ВАШ API токен**, который можно скопировать в разделе "**Настройки**" - "**API**", в вашей кампании **LeadConverter**.
{% endhint %}
{% hint style="warning" %}
**Обратите внимание**, поле "**Секретный ключ**" нужно оставить **пустым!**
{% endhint %}
5. В поле "**Сохранить результат в**" выбираем переменную **result.**
{% hint style="info" %}
Если она еще не создана в вашей кампании, необходимо выбирать пункт "**Создать новую переменную**" и добавить ее.
{% endhint %}
6. Нажимаем на кнопку "**+ДОБАВИТЬ ПАРАМЕТР**" и заполняем параметры данными по таблице ниже. Сохраняем блок.
| Параметр | Значение |
| -------------- | ----------------- |
| subscriber\_id | {{id}} |
| offer\_id | ID ВАШЕЙ подписки |
{% hint style="warning" %}
**Обратите внимание**, вместо "**ID ВАШЕЙ подписки"** вам нужно указать **ID вашей подписки**, на скриншоте ниже, показали, где можно его скопировать.
{% endhint %}
7. Проводим связь от нижнего выхода блока "**Разделитель**" к блоку "**Действие**".
8. Создаем новый блок "**Действие**" и в режиме редактирования выбираем пункт "**Установить переменную**".
9. Выбираем пункт "**Создать новую переменную**" и в появившемся окне вводим название "**ДатаПодпискаДо**".
10. В "**Значение**" указываем строку ниже.
```
[date_calc]%d.%m.%Y %H:%M||{{result.ends_at}}[/date_calc]
```
11. В этом же блоке устанавливаем еще одну переменную, нажав на кнопку "**+ДОБАВИТЬ ДЕЙСТВИЕ**" и выбрав пункт "**Установить переменную**".
12. Создаем новую переменную "**ДатаСледующегоСписания**".
13. В поле "**Значение**" указываем строку ниже. Сохраняем блок.
```
[date_calc]%d.%m.%Y %H:%M||{{result.next_withdraw_attempt_at}}[/date_calc]
```
14. Соединяем связью созданные блоки действия.
15. Создаем блок "**Условие**" и проводим к нему связь от верхнего выхода блока "**Разделитель**".
16. Создаем блок "**Действие**" и открываем его в режиме **редактирования**, щелкнув по нему левой кнопкой мыши.
17. Нажимаем на кнопку "**+ДОБАВИТЬ ДЕЙСТВИЕ**" и выбираем пункт "**Установить переменную**".
18. В поле "**Установить переменную**" выбираем переменную "**Рекуррент**".
19. В значении указываем "**ВКЛ**" и **сохраняем** блок.
20. Переходим к редактированию блока "**Условие**", нажав по нему левой кнопкой мыши.
21. Нажимаем на кнопку "**+ДОБАВИТЬ УСЛОВИЕ**" и выбираем в качестве параметра переменную "**Рекуррент**" из списка.
22. В поле "**условие**" выбираем значение "**Равен**".
23. В значении указываем "**ВЫКЛ**". **Сохраняем** блок.
24. Создаем блок "**Сообщение**" и проводим к нему связь от **зеленого выхода** блока "**Условие**".
25. Открываем блок "**Сообщение**" в режиме редактирования, нажав на него левой кнопкой мыши и выбираем элемент "**Сообщение**".
26. Добавляем текст сообщения. Этот блок будет отправляться пользователю, если он **отключил** автоматические списания.\
\
Например, текст может быть таким:
```
Автоматическая подписка отключена ( рекуррентные платежи выключены)
Подписка действует до: {{ДатаПодпискаДо}}
Это значит, что у бота сейчас нет возможности списывать стоимость подписки каждый месяц
❗После окончания текущего месяца, у вас не будет доступа к каналу и чату. Для того, чтобы попасть в следующий месяц, включите автоматические платежи или оплатите подписку в ручную
Для управления подпиской отправьте команду "Меню" в диалог с чат-ботом.
```
27. Нажимаем "**+ДОБАВИТЬ КНОПКУ**" и переходим к ее редактированию, в поле "Т**екст кнопки**" указываем слово "**Включить**".
28. Сохраняем блок.
29. Созданием новые блок "**Сообщение**" и проводим к нему связь от **красного выхода** блока "**Условие**".
30. Открываем блок "**Сообщение**" в режиме редактирования, нажав на него левой кнопкой мыши и выбираем элемент "**Сообщение**".
31. Добавляем текст сообщения. Этот блок будет отправляться пользователю, если он **подключил** автоматические списания.\
\
Например, текст может быть таким:
```
Автоматическая подписка подключена (Рекурректные платежи включены)
Подписка действует до: {{ДатаПодпискаДо}}
Это означает, что по окончанию подписки, стоимость подписки на следующий месяц списывается автоматически. Вы остаетесь в канале и чате, Вам не нужно ничего для этого делать:)
❗ Если Вы хотите отказаться от автоматической подписки, нажмите кнопку "Отключить"
Для управления подпиской отправьте команду "Меню" в диалог с чат-ботом.
```
32. Добавляем кнопку "**Отключить**" и сохраняем блок.
33. Создаем новый блок "**Действие**" и открываем его в режиме редактирования.
34. Нажимаем на кнопку "**+ДОБАВИТЬ ДЕЙСТВИЕ**" и выбираем пункт "**Отправить через вебхук**".
35. В поле "**URL-адрес обработчика**" указываем:
```
https://leadconverter.ru/api/v1/ВАШ ТОКЕН/recurrent.disableAutoWithdraw
```
{% hint style="warning" %}
**Обратите внимание**, вместо "**ВАШ ТОКЕН**" вам нужно указать **ваш АПИ токен**, который можно скопировать в разделе "**Настройки**" - "**АPI**". На скриншоте ниже показали, где его можно скопировать.
{% endhint %}
{% hint style="warning" %}
**Обратите внимание**, поле "**Секретный ключ**" нужно оставить **пустым!**
{% endhint %}
36. В поле "**Сохранить результат в**" выбираем переменную **return**.
37. Нажимаем на кнопку "**+ДОБАВИТЬ ПАРАМЕТР**".
38. Заполняем параметры по таблице **ниже**.
Параметр
Значение
subscriber_id
({id})
offer_id
Айди подписки
{% hint style="warning" %}
**Обратите внимание**, вместо "**Айди подписки"** вам нужно указать **ID вашей подписки**, на скриншоте ниже, показали, где можно его скопировать.
{% endhint %}
39. **Сохраняем** заполненный блок.
40. От кнопки "**Отключить**" в блоке "**Шаг 2**" проводим связь к блоку "**Действие 2**".
41. Создаем новый блок "**Действие**" и открываем его в режиме редактирования.
42. Добавляем действие "**Установить переменную**" и присваиваем переменной "**Рекуррент**" значение "**ВЫКЛ**". Сохраняем блок.
43. Проводим связь от блока "**Действие 2**" к блоку "**Действие 3**".
44. Проводим связь от блока "**Действие 3**" к блоку "**Условие**".
Мы настроили ветку сценария **отключения** автоматических списаний.
45. Создаем новый блок "**Действие**" и открываем его в режиме редактирования.
46. Нажимаем на кнопку "**+ДОБАВИТЬ ДЕЙСТВИЕ**" и выбираем пункт "**Отправить через вебхук**".
47. В поле "**URL-адрес обработчика**" указываем:
```
https://leadconverter.ru/api/v1/ВАШ ТОКЕН/recurrent.enableAutoWithdraw
```
{% hint style="warning" %}
**Обратите внимание**, вместо "**ВАШ ТОКЕН**" вам нужно указать **ваш АПИ токен**, который можно скопировать в разделе "**Настройки**" - "**АPI**". На скриншоте ниже показали, где его можно скопировать.
{% endhint %}
{% hint style="warning" %}
**Обратите внимание**, поле "**Секретный ключ**" нужно оставить **пустым**!
{% endhint %}
48. В поле "**Сохранить результат в**" выбираем переменную **return**.
49. Нажимаем на кнопку "**+ДОБАВИТЬ ПАРАМЕТР**" и заполняем параметры по таблице **ниже**.
Параметр
Значение
subscriber_id
({id})
offer_id
Айди подписки
{% hint style="warning" %}
**Обратите внимание**, вместо "**Айди подписки**" вам нужно указать **ID вашей подписки**, на скриншоте ниже, показали, где можно его скопировать.
{% endhint %}
50. Сохраняем заполненный блок.
51. Проводим связь от кнопки "**Включить**" в блоке сообщения "**Шаг**" к блоку "**Действие 4**".
52. От блока "**Действие 4**" проводим связь к блоку "**Действие**", который мы создавали в самом начале.
53. От блока "**Действие**" проводим связь к блоку "**Условие**".
Мы успешно настроили сценарий бота "**Меню.Подписка**"!
### Создаем бота "Подписка скоро закончится.Подписка"
Этот бот будет запущен, когда наступит время "**Уведомления об окончании подписки**", которое мы указывали в настройках "**Подписки**".
В нашем случае **за 2 дня** до окончания подписки.
1. Переходим в раздел "**Боты**" и нажимаем на кнопку "**Редактировать**" у сценария "**Подписка скоро закончится.Подписка.**"
2. Открываем блок "**Шаг 1**" вы режиме редактирования, нажав по нему левой кнопкой мыши.
3. Добавляем элемент "**Сообщение**" и указываем в нем текст.
Например:
```
Ваша подписка на клуб Любителей чат-ботов закончится через 2 дня!
```
Сохраняем блок.
4. Создаем новый блок "**Действие**" и переходим к его редактированию.
5. Нажимаем на кнопку "**+ДОБАВИТЬ ДЕЙСТВИЕ**" и выбираем пункт "**Запустить бота**".
6. Выбираем бота "**Меню.Подписка**" и сохраняем блок.
7. От блока "**Шаг 1**" проводим связь к блоку "**Действие**".
Мы успешно настроили сценарий бота **"Подписка скоро закончится. Подписка"**!
### Создаем бота "Успешное продление подписки.Подписка"
Этот бот будет запущен, если система спишет с карты клиента указанную сумму за подписку.
1. Переходим в раздел "**Боты**" и нажимаем на кнопку "**Редактировать**" у сценария "**Успешное продление подписки.Подписка**".
2. Открываем блок "**Сообщение**" в режиме редактирования и добавляем в нем элемент "**Сообщение**".
3. Указываем в нем текст, который получит пользователь после того, как средства за подписку будут **успешно списаны** с его карты. Сохраняем блок.
Например:
```
Ваша подписка успешно продлена!
```
4. Создаем новый блок "**Действие**" и переходим к его редактированию.
5. Нажимаем на кнопку "**+ДОБАВИТЬ ДЕЙСТВИЕ**" и выбираем пункт "**Запустить бота**".
6. Выбираем бота "**Меню.Подписка**" и сохраняем блок.
7. От блока "**Шаг 1**" проводим связь к блоку "**Действие**".
Мы успешно настроили сценарий бота **"Успешное продление подписки.Подписка"!**
### Создаем бота "Необходимо продлить подписку вручную.Подписка".
Этот бот будет запущен, если у системы не выйдет автоматически списать средства.
1. Переходим в раздел "**Боты**" и нажимаем на кнопку "**Редактировать**" у сценария "**Необходимо продлить подписку вручную. Подписка**".
2. Открываем блок "**Сообщение**" в режиме редактирование и добавляем в нем элемент "**Товар**".
3. В поле "**Текст сообщения**", указываем текст, который получит пользователь если боту **не удастся списать средства** с карты автоматически.
Например:
```
Подписка скоро закончится!
Чтобы оплатить доступ в клуб Любителей ботов, нажми на кнопку "оплатить" ниже
```
4. В поле "**Товар**" выбираем из списка созданную подписку.
5. В поле "**Текст кнопки**" указываем название кнопки "**Оплатить**". Сохраняем блок.
6. Создаем новый блок "**Сообщение**", открываем его в режиме редактирования. Далее выбираем в нем элемент "**Сообщение**".
7. Указываем в нем текст, который получит пользователь после того, как средства за подписку **будут успешно списаны** с его карты. Сохраняем блок.
Например:
```
Ваша подписка успешно продлена!
```
8. Проводим связь от блока "**Шаг 1**" к блоку "**Шаг 2**".
9. Создаем новый блок "**Действие**" и переходим к его редактированию.
10. Нажимаем на кнопку "**+ДОБАВИТЬ ДЕЙСТВИЕ**" и выбираем пункт "**Запустить бота**".
11. Выбираем бота "**Меню.Подписка**" и сохраняем блок.
12. Проводим связь от блока "**Шаг 2**" к блоку "**Действие**".
Мы успешно настроили сценарий бота **"Необходимо продлить подписку вручную.Подписка"**!
## Настраиваем сценарии с учетом особенностей мессенджеров
Теперь, когда мы настроили общие для всех мессенджеров сценарии переходим к **основным сценариям рекуррентных платежей**, которые будут настраиваться **под каждый мессенджер отдельно**, учитывая его функциональные особенности.
Для дальнейшей настройки сценария **выберите нужный для вас мессенджер**, где вы хотите реализовать работу рекуррентных платежей.
{% content-ref url="sozdanie-bota-s-rekurrentnymi-platezhami-avtomaticheskimi-spisaniyami/rekurrentnye-platezhi-v-max" %}
[rekurrentnye-platezhi-v-max](https://docs.leadconverter.su/new_page/materialy/sozdanie-bota-s-rekurrentnymi-platezhami-avtomaticheskimi-spisaniyami/rekurrentnye-platezhi-v-max)
{% endcontent-ref %}
{% content-ref url="sozdanie-bota-s-rekurrentnymi-platezhami-avtomaticheskimi-spisaniyami/rekurrentnye-platezhi-vo-vkontakte" %}
[rekurrentnye-platezhi-vo-vkontakte](https://docs.leadconverter.su/new_page/materialy/sozdanie-bota-s-rekurrentnymi-platezhami-avtomaticheskimi-spisaniyami/rekurrentnye-platezhi-vo-vkontakte)
{% endcontent-ref %}
{% content-ref url="sozdanie-bota-s-rekurrentnymi-platezhami-avtomaticheskimi-spisaniyami/rekurrentnye-platezhi-v-telegram" %}
[rekurrentnye-platezhi-v-telegram](https://docs.leadconverter.su/new_page/materialy/sozdanie-bota-s-rekurrentnymi-platezhami-avtomaticheskimi-spisaniyami/rekurrentnye-platezhi-v-telegram)
{% endcontent-ref %}
{% hint style="success" %}
Остались вопросы? \
\
Обязательно задавайте их нам, в техническую поддержку. Будем рады вам помочь!
{% endhint %}
{% content-ref url="../../kak-zadat-vopros-v-podderzhku" %}
[kak-zadat-vopros-v-podderzhku](https://docs.leadconverter.su/kak-zadat-vopros-v-podderzhku)
{% endcontent-ref %}
