Событие «Оплатил на Яндекс.Деньги» и установка Приложения сообщества

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

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

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

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

Для этого:

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

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

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

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

Приложение сообщества

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

• Баннер — в это поле вставьте прямую ссылку на картинку. Взять ее можно как из ВК, нажав в загруженной фотографии кнопку «Открыть оригинал». Так и например в Senler, таком же поле в настройках приложения.
• Заголовок формы пожертвования — Большой текст сразу под картинкой. Это очень важный параметр. Просто запомните это. Именно по заголовку сервис определяет из какой страницы была произведена оплата.
• Описание формы пожертвования — Текст обычным шрифтом под заголовком. Похоже как описание в Senler, только с поддержкой Markdown. Переменные тут также доступны.
• Сумма пожертвования по умолчанию (руб) — Сумма, которая, будет прописана в поле ввода суммы перевода (на главной странице приложения).
• Надпись на кнопке — Надпись на желтой кнопке Яндекс Денег.
• Инструкции для ручного перевода — Отдельный блок такого же стиля как и блоки платежных систем, только с возможностью прописать произвольный текст. Поддерживаются Markdown и Переменные.
• Ссылка «Вернуться на сайт» — Куда будет вести одноименная кнопка Яндекс Денег после успешного перевода.

В конце вкладки есть кнопки для удобства (с понятными из названий назначениями):

• Установить в сообщество.
• Открыть приложение. Откроет главную страницу приложения.
• Открыть настройки в ВК. Откроет путь: Управление → Приложения → Приложение Автопилот.

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

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

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

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

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

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

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

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

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

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