Как принимать оплату в Telegram-боте и платить партнёрам

Что настроим

Партнёр делится ссылкой на вашего Telegram-бота. Покупатель открывает бота, нажимает кнопку оплаты и платит через ProOnline или PayAnyWay. Бот сам создаёт заказ с кодом партнёра, ждёт оплату и после неё присылает личную ссылку в закрытый канал или группу. Партнёр получает вознаграждение, в том числе за продления, которые покупатель оплачивает позже без его ссылки.

Бот собирается в разделе «Чат-боты», код писать не нужно.

Что нужно заранее

• Тариф «Базовый» или «Оптимальный». На «Базовом» можно подключить 1 бота и вести 100 подписчиков, на «Оптимальном» 3 бота и 1000 подписчиков.

• Доступ владельца магазина. Бота и способ оплаты подключает только владелец.

• Аккаунт в ProOnline (ID школы, API-ключ и секрет подписи вебхука) или подключённый PayAnyWay.

• Закрытый канал или группа в Telegram, куда бот пустит покупателя после оплаты.

Шаг 1. Подключите способ оплаты

Способ оплаты подключается в «Настройки» → «Интеграции». Ниже пример для ProOnline, PayAnyWay подключается там же, в карточке «PayAnyWay».

1. Откройте «Настройки» → «Интеграции» и выберите «ProOnline».

2. Заполните «ID школы», «API-ключ» и «Секрет подписи вебхука».

3. В «Адрес для уведомлений» выберите «Создать новый адрес».

4. Нажмите «Сохранить».

5. Скопируйте «Адрес вебхука для ProOnline» и укажите его в кабинете ProOnline. На этот адрес ProOnline сообщает об оплатах.

Телу уведомления Рефсейлс не доверяет: получив его, он сам запрашивает статус оплаты в ProOnline вашим ключом.

Шаг 2. Подключите бота

1. Откройте @BotFather в Telegram и отправьте команду /newbot.

2. Задайте имя и адрес бота. BotFather пришлёт токен вида 123456789:AA....

3. В Рефсейлс откройте «Настройки» → «Интеграции» и выберите «Telegram-бот для клиентов».

4. Вставьте токен в поле «Токен бота» и нажмите «Подключить».

В списке появится адрес бота с зелёной точкой. Переписка бота с покупателями будет видна в разделе «Чат».

Зелёная точка у адреса бота значит, что бот получает сообщения.

Добавьте бота в закрытый канал

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

1. Откройте закрытый канал или группу в Telegram и добавьте бота в администраторы.

2. Включите ему право «Пригласительные ссылки».

Бот запоминает канал в момент, когда его назначают администратором. Если бот уже был администратором раньше, снимите его с администраторов и назначьте заново, иначе канала не будет в списке на шаге 5.

Шаг 3. Добавьте товар

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

2. Заполните «Название» и «Цена», например «Курс «Основы вязания»» и 4 900 ₽.

3. Сохраните товар.

Бот создаёт заказ по цене из каталога. Поменяете цену у товара, и следующие заказы из бота пойдут по новой.

Шаг 4. Создайте партнёрскую программу

1. Откройте раздел «Программы» и нажмите «Создать». Откроется мастер из пяти шагов.

2. На шаге «Основное» в поле «Ссылка на сайт или Telegram-бота *» укажите адрес бота, например https://t.me/MyBot, и нажмите «Далее».

3. На шаге «Вознаграждение» в «Тип вознаграждения *» выберите «Процент» и заполните «Размер вознаграждения *».

4. Если нужна гарантированная сумма, заполните «Не менее за заказ». Партнёр получит большее из двух значений.

5. В «Повторные заказы клиента» выберите «Все заказы», чтобы партнёр получал вознаграждение за каждое продление. Нажмите «Далее».

6. На шаге «Товары и услуги» в блоке «Товары и услуги программы» отметьте товар из шага 3 и нажмите «Далее».

7. На шаге «Правила» отметьте хотя бы один канал привлечения и нажмите «Далее».

8. На последнем шаге нажмите «Создать программу».

Адрес бота вписывается в поле «Ссылка на сайт или Telegram-бота *».

Ставка 20%, но не меньше 500 ₽. С курса за 4 900 ₽ партнёр получит 980 ₽ с каждой оплаты, включая продления.

Каждый партнёр получит в кабинете, в разделе «Программа», личную ссылку с кодом:

https://t.me/MyBot?start=AB12CD34

Код после start= бот запоминает за покупателем и передаёт в заказ.

Шаг 5. Соберите сценарий

1. Откройте раздел «Чат-боты» и нажмите «Создать сценарий».

2. В окне «Новый сценарий» введите название, например «Оплата клуба», и нажмите «Создать». Если ботов несколько, выберите нужного в поле «Бот».

Откроется холст с двумя блоками: «Точка входа /start» и приветствие. Блоки добавляются из панели «Блоки» слева: перетащите блок на холст или кликните по холсту правой кнопкой. Выход справа у блока соединяется со входом следующего.

1. Кликните «Точка входа /start» и оставьте поле «Метка» пустым. Так блок сработает и на обычный /start, и на ссылки партнёров с кодом.

2. Кликните приветствие и напишите текст, например «Здравствуйте! Это клуб вязания. Уроки выходят в закрытом канале».

3. В «Кнопки» добавьте кнопку «Вступить в клуб».

4. Добавьте на холст блок «Оплата» и соедините с ним выход кнопки «Вступить в клуб».

Готовый сценарий: вход по /start и по слову «продлить», блок «Оплата», личная ссылка в канал и ответы на случай, если оплаты нет или ссылку создать не вышло.

Настройте блок «Оплата»

1. В «Товар» выберите товар из шага 3.

2. В «Способ оплаты» оставьте «Подключённый способ», если подключён один способ. Если подключены и ProOnline, и PayAnyWay, выберите нужный.

3. В «Текст» напишите, за что покупатель платит, например «Доступ к урокам на месяц стоит 4 900 ₽. Нажмите кнопку, чтобы оплатить».

4. В «Кнопка» укажите подпись кнопки, например «Оплатить».

5. В «Ждать оплату, мин» укажите, сколько бот ждёт оплату. Подойдёт от 1 минуты до 7 дней, например 1440 минут, то есть сутки.

Настройки блока «Оплата» открываются справа по клику на блок.

Когда покупатель доходит до этого блока, бот создаёт заказ с кодом партнёра из ссылки и присылает сообщение с кнопкой оплаты. У блока два выхода: «Оплачено» и «Не оплачено». По второму бот идёт, если оплата не пришла за заданное время.

Покупатель может оплатить и позже: после срока ожидания или после того, как снова отправил боту /start. Бот всё равно пойдёт по выходу «Оплачено» и выдаст доступ. Если покупатель опять дойдёт до блока «Оплата» в течение 7 дней, бот пришлёт ссылку на тот же неоплаченный заказ, а не создаст новый.

Чтобы вернуть тех, кто не оплатил сразу, включите напоминание:

1. Включите «Напомнить, если клиент не оплатил».

2. В «Напомнить через, мин» укажите, через сколько напомнить, например 60. Напоминание должно прийти раньше, чем закончится ожидание оплаты.

3. В «Текст напоминания» напишите, например, «Ссылка на оплату ещё действует. Оплатите, когда будет удобно». Под текстом бот пришлёт ту же кнопку оплаты.

Выдайте доступ после оплаты

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

2. В «Группа или канал» выберите канал, куда добавили бота. Если канала нет в списке, обновите страницу.

3. В «Текст» напишите, например, «Оплата получена. Вот ваша личная ссылка, она сработает один раз».

4. В «Кнопка» оставьте «Вступить» или напишите свою подпись.

5. Добавьте «Сообщение» на выход «Ошибка» блока «Доступ в группу». Напишите в нём, что менеджер пришлёт ссылку вручную.

6. Добавьте ещё одно «Сообщение» на выход «Не оплачено» блока «Оплата». Напишите в нём, что оплату пока не получили и новую ссылку бот пришлёт на слово «оплатить».

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

Ссылка от бота пускает в канал одного человека. Если покупатель перешлёт её, второй человек по ней не войдёт. По выходу «Ошибка» бот идёт, если не смог создать ссылку: его убрали из канала или лишили права приглашать.

Включите сценарий

Сценарий сохраняется сам, пока вы его правите. Когда блоки соединены, включите переключатель в верхней панели: подпись сменится на «Включён». Если какой-то блок не настроен, в верхней панели появится текст ошибки.

Шаг 6. Закрывайте заказ после оплаты

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

1. Откройте раздел «Автоматизации» и нажмите «Создать».

2. В окне «Новая автоматизация» выберите триггер «Смена статуса оплаты».

3. В поле «В статус оплаты (необязательно)» выберите оплаченный статус.

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

5. Сохраните автоматизацию и включите её переключателем в списке.

Заказ можно закрыть и в самом сценарии: поставьте на выход «Оплачено» блок «Действия» с действием «Изменить поле», выберите «Статус заказа» и «Выполнен». Это сработает только для оплат, которые прошли через сценарий. Автоматизация закрывает и остальные, поэтому для начислений партнёрам надёжнее она. Как устроен блок «Действия», описано в статье про действия и переменные в чат-боте.

Шаг 7. Добавьте продление

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

1. Добавьте на холст блок «Ключевые слова».

2. Впишите слова, например «продлить» и «оплатить».

3. Соедините его выход с тем же блоком «Оплата».

Продление создаёт новый заказ: прежний уже оплачен. Код партнёра при продлении не нужен: бот привязывает заказы к карточке клиента по Telegram ID, а клиент закреплён за партнёром с первого заказа по его ссылке. При выбранном «Все заказы» в программе продление засчитается этому партнёру.

Как проверить, что работает

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

2. Нажмите «Вступить в клуб». Бот пришлёт сообщение с кнопкой «Оплатить».

3. Откройте раздел «Заказы». Там появится заказ на товар из шага 3, у него указан партнёр.

4. Оплатите заказ. Бот пришлёт кнопку «Вступить» с личной ссылкой в канал. Перейдите по ней и проверьте, что попали в канал.

5. Проверьте заказ: он оплачен и после автоматизации из шага 6 перешёл в «Выполнен». У партнёра появилось начисление.

6. Напишите боту «продлить». Придёт новая ссылка, в «Заказах» появится второй заказ того же клиента с тем же партнёром.

Если оплата прошла, а бот молчит, откройте «Настройки» → «Интеграции» → «ProOnline»: в блоке «Последние уведомления» видно, что прислал ProOnline.

Если не работает

• Бот не отвечает на /start. Сценарий выключен или в нём не выбран бот. Откройте сценарий и проверьте верхнюю панель. Если на странице «Telegram-бот для клиентов» горит «Бот не получает сообщения», проверьте бота в @BotFather и подключите его заново.

• После кнопки бот замолчал, заказа нет. Не удалось создать заказ или ссылку на оплату. Проверьте, что товар в блоке «Оплата» не удалён и у него есть цена, а способ оплаты подключён. Если подключены оба способа, выберите в блоке один из них вместо «Подключённый способ».

• Заказ создан без партнёра. Покупатель открыл бота не по ссылке партнёра, или в коде после start= опечатка. Ещё одна причина: у точки входа /start заполнена «Метка». Такой блок ловит только ссылку со своей меткой, а ссылки партнёров уходят мимо.

• Оплата прошла, а заказ не оплачен. ProOnline не прислал уведомление на адрес из шага 1. Проверьте блок «Последние уведомления» на странице ProOnline и адрес в кабинете ProOnline.

• Заказ оплачен, но партнёру ничего не начислено. Заказ не перешёл в «Выполнен». Проверьте, что автоматизация из шага 6 включена.

• Продление не засчиталось партнёру. В программе в «Повторные заказы клиента» выбрано не «Все заказы».

• Канала нет в списке «Группа или канал». Бот не заметил, что его назначили администратором, или в сценарии выбран другой бот. Снимите бота с администраторов канала, назначьте заново и обновите страницу сценария.

• Канал в списке с пометкой «нет права приглашать». У бота выключено право «Пригласительные ссылки». Включите его в настройках администраторов канала.

• Оплата прошла, а бот пошёл по выходу «Ошибка». Бот не смог создать ссылку: его убрали из канала или лишили права приглашать. Верните права и отправьте покупателю ссылку вручную из раздела «Чат».

• Бот перестал вести покупателя. Менеджер ответил ему в разделе «Чат», и бот встал на паузу. Пока бот на паузе, сообщения покупателя приходят менеджеру. Бот продолжит сам, если покупатель отправит /start, нажмёт «В начало» или кнопку в сообщении бота. Чтобы вернуть покупателя боту из чата, нажмите «Вернуть боту».

• Новые люди не получают ответа бота. Над списком сценариев горит «Лимит подписчиков исчерпан». Сообщения сверх лимита приходят в «Чат». Смените тариф или отвечайте вручную.

Частые вопросы

Нужен ли разработчик?

Нет. Сценарий собирается в разделе «Чат-боты» из блоков. Если бот у вас уже написан, его можно связать с Рефсейлс через API, описание в разделе для разработчиков.

Что будет, если покупатель придёт по ссылке другого партнёра?

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

Что будет, если покупатель оплатит не сразу?

Бот выдаст доступ, даже если оплата пришла после срока ожидания или после повторного /start. Если покупатель снова нажмёт кнопку оплаты в течение 7 дней, он получит ссылку на тот же заказ, дубля не будет.

Можно ли переслать ссылку на канал?

Нет. Ссылка из блока «Доступ в группу» пускает одного человека. Второй по ней не войдёт.

Когда вознаграждение можно выплатить?

После срока из поля «Срок заморозки вознаграждения» в программе. Отсчёт идёт от момента, когда заказ стал выполненным.

Можно ли принимать оплату и через ProOnline, и через PayAnyWay?

Да. Подключите оба способа и в каждом блоке «Оплата» выберите нужный в поле «Способ оплаты».

Видно ли переписку бота с покупателем?

Да, в разделе «Чат». Если менеджер ответит покупателю сам, бот встанет на паузу. Пауза снимается кнопкой «Вернуть боту» в чате или сама, когда покупатель отправит /start, нажмёт «В начало» или кнопку бота.