Интеграция с Yoomoney

Интеграция, приложение и событие позволяют:

• Реагировать на оплату любыми действиями, например отправкой ссылки на скачивание, закрытое сообщество тренинга или сайт.
• Подписывать после оплаты на скрытые группы подписчиков Senler. Например, на группу «Клиенты».
• Частично это позволяет организовать платные подписки (авто-отписка через определенный период времени будет возможна после внедрения функционала Задержек).
• Автоматически благодарить человека за пожертвования.
• В пару кликов создавать ссылку на оплату (не покидая самого приложения) для последующей отправки внутри ВК в: сообщения, комментарии, рассылки и т. д.
• Автоматически формировать ссылку на оплату после заказа товара в ВК. И за счет всего вышеупомянутого полностью автоматизировать продажи через раздел Товары в ВК. Без сторонних сервисов.
• И много чего еще (зависит от вашей фантазии). 🙃

Настройка интеграции

Важно! Если у вас несколько сообществ, то достаточно прописать в настройках сообществ номер кошелька, секретный ключ, а в ЮMoney вебхук от одного сообщества, а АП далее сам разрулит

Чтобы событие заработало нужно подключить Автопилот к вашему ЮMoney. Чтобы последний отправлял уведомления о поступлениях.

Для этого:

• В настройках Автопилота скопируйте Адрес для HTTP-уведомлений;
• Откройте настройки YooMoney (есть прямая ссылка там же), войдите по коду из SMS и вставьте этот адрес в соответствующее поле.
• Скопируйте секретный ключ и вставьте его в Автопилот (п.2).
• Скопируйте номер кошелька и вставьте его в Автопилот (п.1).
• Можете нажать кнопочку «Протестировать». Вам от вашего сообщества должно прийти сообщение о том что все хорошо.
• Обязательно поставьте галочку «Отправлять уведомления» и нажмите на кнопку «Сохранить»!

Параметры события

Параметры достаточно простые, похожие на параметры события
«Перешел по ссылке»

• Выбор сообщества (к которому привязан кошелек — ссылка с настроек именно этого сообщества должна быть в кошельке).
• Тип ключевого слова: содержащим / равным /регул. выраж.
  Если нужно реагировать на любую оплату, ставьте «содержащим»!
• Название продукта / страницы оплаты.
  Если нужно реагировать на любую оплату, оставляйте пустым (и + см. предыдущий пункт).
• Тип сравнения суммы: равно / больше / меньше.
• Сумма в рублях. Берется со страницы оплаты. После вычета комиссий реальное количество поступивших денег может отличаться. Больше 0 — то же самое что любая сумма.
• Тип платежной системы. Из выпадающего списка выбирается нужная платежная система, если указан тип любаято реакция произойдет при оплате в любой платежной системе.

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

Формирование ссылки на оплату

Если вы принимаете заказы через раздел Товары, то в действиях команды заказа вы можете использовать переменную %payment_link%. Она автоматически сформирует ссылку со всеми нужными параметрами. Эту итоговую ссылку вы можете копировать и использовать в любом другом месте.

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

После того как название и сумма будут прописаны, прокрутите в конец и в блоке «Уголок админа» скопируйте готовую ссылку. Скопированную ссылку можно использовать в сообщениях, рассылке или любом другом месте в ВК.

Естественно, «Уголок админа» показывается только администраторам или редакторам сообщества!

Данные платежа

Полезные данные по платежу (для использования в действиях) вы можете получить из следующих переменных:

• %content% — название страницы оплаты;
• %id_1% — сумма в рублях, указанная на странице оплаты;
• %yandex_amount% — сколько получено денег (вычтены комиссии);
• %yandex_sender% — номер кошелька отправителя, если платил со своего кошелька в YooMoney, а не через карту;
• %yandex_notification_type% — метод оплаты. В зависимости от метода будет подставлено одно из значений: Банковская карта или ЮMoney.

Параметры приложения

При необходимости вы можете самостоятельно сформировать ссылку на страницу в приложении. Для этого используйте параметры приложения. Выглядят они как обычные GET-параметры (тут можно почитать что это с примерами), только начинаются с #, а не с ?.

Название параметров Автопилота состоят обычно из одной или нескольких букв, например: t, s, i, exp. Но для удобства я напишу их сразу с разделителем (&) и символом равно (=).

• t= — название страницы (перед первым параметром разделитель не нужен).
• &s= — сумма перевода (в рублях) для форм оплаты. Натуральное число.
• &i= — ссылка на изображение баннера. При заказе автоматически подставляется фотография товара.
• &r= — адрес для перенаправления. То есть это возможность использовать приложение как страницу редиректа, со всеми вытекающими. В этом случае баннер блокируется и не показывается (чтобы редирект был максимально быстрым).
• &exp= — дата истечения срока действия страницы. Метка времени в секундах (Unix timestamp) после которой, страница вместо формы оплаты и блока «ручные методы оплаты» будет показывать то, что прописано в параметре Текст страницы «Время вышло» в настройках сообщества. Также не произойдет редирект, если указан параметр r.
• &exps= — цена после истечения срока действия заказа. Если указан этот параметр, то вместо текста «Время вышло» будет показана полноценная форма, но с ценой взятой из этого параметра. Сработает только с параметром &exp= или внутри динамической переменной {payment_link}.

• &e= — часть параметров (например t, s, i) могут быть зашифрованы в параметр e (во время копирования адреса страницы в приложении), чтобы подписчик не смог вручную их подредактировать. То есть их можно не прописывать вручную. Если прописать дополнительно какой-то из параметров в ссылку, то он перезапишет зашифрованный.
• &n= — назначение платежа. Если не задано, будет ссылка на пользователя и номер страницы оплаты (внутренний системный). Вы можете сменить это на что угодно, заполнив этот параметр. Будьте осторожны! Кириллические заголовки могут ломать страницу оплаты. Обязательно во время тестов оплатите сами с карты!
• &d= — выключить описание страницы. Может принимать значения:
  0 — выключить описание для текущей страницы. 1 — будет показано описание, которое написано в настройках сервиса.
• &l=000 — показать рейтинг списка с номером 000. По сути этого достаточно, но если добавить t=, то можно поменять название страницы рейтинга (по умолчанию берется название списка). Также если добавить &d=1, то описание будет не стандартное (%first_name%, ваша позиция в рейтинге: № %rating_position%), а взятое из настроек приложения (это в «Настройках» сообщества на сайте Автопилота).
• &custom= — вы можете сами придумывать названия параметров и передавать их приложению. Например чтобы использовать в описании как переменную (например, %custom%). Название может быть практически любым (в рамках синтаксиса): parameter, tag, bobr, pig и т.д. Подробнее о формировании собственных переменных.

Пример готовой ссылки:
https://vk.com/app6177183_-41103148#t=Autopilot&s=1500&i=http://skyjoom.com/images/headers/raindrops.jpg&exp=1603107847&custom=text.

Эти же параметры можно дописывать к переменным. Например, так можно сделать чтобы человек по полученной ссылке мог платить только 3 дня:

%payment_link%&exp={date}%s|-3 day{/date}

Хотя для конкретно этой задачи есть вариант получше.

Для тех, кому не хватило «четкости»

Или подробнее о GET-параметрах в Автопилоте

• Список GET-параметров для приложений Автопилота или Senler начинается с # (в отличии от сайтов, где используется ?).
• ? не используйте, он ломает ссылку и приводит к ошибке 404.
• Параметры передаются обязательно с их значениями! Между параметром и значением должен стоять знак равно =.
• Первый параметр X и его значение пишем после знака # так:
  #X=XValue.
• Второй и последующие параметры Y, Z... и их значения пишем после знака & так (другими словами — это разделитель параметров):
  &Y=YValue&Z=ZValue.
• Таким образом (#X=XValue&Y=YValue&Z=ZValue) мы передаём параметры: Х,Y,Z и их значения: XValue,YValue,ZValue соотвественно.
• Если надо передать пробел, можете написать %20 (Однако я не рекомендую использовать пробелы в принципе). Лучше — .

Теперь можете еще раз пересмотреть пример готовой ссылки:
https://vk.com/app6177183_-41103148#t=Autopilot&s=1500&i=http://skyjoom.com/images/headers/raindrops.jpg&exp=1603107847&custom=text.

А ещё вам может помочь, если вы попытаетесь прочитать список параметров на английском языке :)

Что делать если все равно не работает

1. Самая частая ошибка - невнимательность во время настройки. В итоге получается один из вариантов:
   - не тот адрес сервера в YooMoney (от левого сервиса, а не Автопилота)!
   - не стоит галочка «Отправлять уведомления»!
   Помогает обычный тест (кнопка «Тестировать» в YooMoney) должно прийти сообщение вам от вашего сообществе, что все ОК.
   P. S. Оно не придет, если вы не разрешали вашему сообществу вам писать.
2. Проверьте, работают ли другие команды. Проблема может быть совсем не в интеграции с YooMoney:-)
3. Какая-то фигня в ключе. Обычно это + или /. Зачастую даже тест при этом проходит. Также иногда ключ может быть просто странным (для программы). В обоих случаях помогает пересоздание ключа (можно несколько раз).
4. Неправильный тест (или его отсутствие). Попробуйте для начала создать команду которая будет реагировать простым сообщением на любую оплату. Для этого в событии поставьте параметры: страница с названием «содержащим» пустую строку (никаких слов не пишите) и с ценой «больше» 0; И переведите себе в своем сообществе 2 руб. Если все получится, продолжайте настройку.