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

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

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

На данный момент сценарий рекуррентных платежей может функционировать только в чате MAX. Настроить рекуррентные платежи для канала не получится.

Перед тем как переходить к настройке сценария, необходимо добавить вашего бота в чат в качестве администратора, иначе бот не сможет функционировать:

Как добавить бота в администраторы чата MAX

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

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

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

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

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

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

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

Например:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

https://platform-api.max.ru/chats/ВАШ ИД ЧАТА/members

Вместо «ВАШ ID ЧАТА» вам нужно указать ID вашего чата, куда бот будет добавлять пользователя после оплаты. Определить его можно по инструкции ниже:

Как узнать ID чата в MAX

1. В поле «Отправить запрос методом», меняем метод запроса на «JSON POST».

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

1. Нажимаем на кнопку «+ДОБАВИТЬ ЗАГОЛОВОК».

1. Вносим данные из таблицы ниже:

Заголовок	Значение
Authorization	{{channel.token}}

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

1. Вносим данные из таблицы ниже:

Параметр	Значение
user_ids.0	{{user_id}}

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

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

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

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

{{return.failed_user_ids.0}}

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

1. В поле «Значение» указываем переменную:

{{user_id}}

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

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

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

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

Например:

Не смог добавить тебя в чат автоматически.

Вступи, пожалуйста, по ссылке ниже 

ВАША ССЫЛКА ДЛЯ ВСТУПЛЕНИЯ В ЧАТ

Вместо «ВАША ССЫЛКА ДЛЯ ВСТУПЛЕНИЯ В ЧАТ» вы указываете ссылку для вступления в ваш чат.

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

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

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

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

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

Например:

Оплата успешно прошла, уже добавил тебя в чат! Проверяй.

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

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

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

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

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

Настраиваем триггер удаления из чата без оплаты

1. Открываем блок «Триггеры» в режиме редактирования и нажимаем на кнопку «+ДОБАВИТЬ ТРИГГЕР».

1. Выбираем из списка триггер «Вступил в сообщество/группу/канал».

1. В поле «В канале(ах)» выбираем ваш подключенный бот в МАХ.

1. В поле «ID каналов/групп» указываем ID вашего чата. Сохраняем блок.

Как узнать ID чата в MAX

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

1. В поле «Параметр» выбираем «Группа».

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

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

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

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

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

https://platform-api.max.ru/chats/ИД ВАШЕГО ЧАТА/members?user_id={{user_id}}

В значении «URL-адресе обработчика» мы сразу же указываем параметр user_id={{user_id}}. Важно указать его именно здесь, иначе МАХ не сможет корректно обработать функцию удаления из чата.

Вместо «ID ВАШЕГО ЧАТА» вам нужно указать ID вашего чата в МАХ, который мы определяли ранее по инструкции ниже.

Как узнать ID чата в MAX

1. В поле «Отправить запрос методом» выбираем метод «DELETE» из выпадающего списка.

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

Заголовок	Значение
Authorization	{{channel.token}}

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

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

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

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

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

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

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

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

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

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

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

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

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

https://platform-api.max.ru/chats/ИД ВАШЕГО ЧАТА/members?user_id={{user_id}}

Вместо «ИД ВАШЕГО ЧАТА» вам нужно указать ID вашего чата в МАХ, который мы определяли ранее.

Как узнать ID чата в MAX

1. В поле «Отправить запрос методом» выбираем из списка метод запроса «DELETE».

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

Заголовок	Значение
Authorization	{{channel.token}}

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

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

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

Например:

Ваша подписка на чат закончилась!

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Отлично! Мы успешно настроили сценарий бота с автоматическими списаниями по подписке в мессенджере МАХ!

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

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

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

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