Links
Comment on page

Автопилот (через вебхуки)

В этой инструкции мы будем передавать данные из сервиса Multy.AI в сервис «Автопилот». Для чего:
  • Например, вы хотите передавать накопленные баллы в рейтинг Автопилота
  • У вас есть рабочая схема воронки в Автопилоте и вам нужно передавать накопленные баллы в Multy.AI
Для примера: у вас есть геймификация с начислением игровой валюты и вам нужно передать накопленные средства в Автопилот. Мы рассмотрим пример на примере рейтинга
Пример рейтинга
Пример схемы
Для начала давайте проверим, что у вас:

Настройка команд в сервисе «Автопилот»

Важно! В примере мы будем рассматривать передачу данных на примере баллов (игровой валюты). Сейчас не рассматривается принцип работы с сервисом «Автопилот». Предполагается, что вы уже работали с ним. Если нет, то необходимо изучить соответствующие инструкции.
Итак, в сервисе «Автопилот» в нужном сообществе в разделе «Список игроков для VK» создаете список игроков с названием «Баллы». В примере номер 1710197
Пример списка в Автопилоте
Пока отложим команды в Автопилоте и сделаем вебхук для передачи данных из Автопилота в Multy.AI.
Для этого согласно этой инструкции создаем вебхук с названием «Автопилот» и прописываем корректные данные.
Важно! Необходимо заменить ссылку в примере и в командах на ваш вебхук. Ниже будут описаны только те параметры, ккоторые необходимы.
Тип контакта - Здесь указываете по какому параметру будет произведен поиск пользователя. Указываете: ID профиля ВКонтакте.
В «Источник данных» указываем:
  • GET-параметры ссылки - параметры ссылки переданы в виде GET-параметров, они указаны после ?. Например, для запроса будем отправлять параметры так https://cb.multy.ai/api/v1/hook/app/b45b49c1f41afe71bcd9ce5ffd97f762?vk_user_id=ID пользователя в Вконтакте
  • Путь к значению контакта - нужно указать, где будет искать путь для пользователя. Например, для примера выше может быть найден по такому пути: vk_user_id
  • Задать интеграцию - В данном списке вы можете выбрать интеграцию для которой будет срабатывать вебхук. Например вы можете выбрать бота и все сообщения будут отправляться от его имени. В примере указано сообщество «Test Multy»
Пример настроек вебхука
После настройки не забудьте нажать «Сохранить» и скопировать вебхук в блокнот.

Создание списка с валютой в Multy.AI

Чтобы пример из схемы работал корректно, необходимо создать игровую валюту «Рыбки» с именем: andreygorgamer_fish_rating
Если Вы не знаете как создать валюту, то посмотрите в этой инструкции
Пример валюты

Схема для передачи игровой валюты в Автопилот

В примере настроено так:
  • В сообществе подключенном к Multy.AI пользователь пишет комментарий и получает рыбку и мы передаем количество рыб в Автопилот, например, на страницу рейтинга (в другом сообщество).
1) Для того, чтобы реагировать на комментарий под любым постом с ключевиком «балл» необходимо добавить событие «Комментарий создан» и добавить условие «Текст сообщения» равен балл
Пример события
2) Чтобы начислить валюту добавляем контейнер с действиями:
Контейнер с начисление валюты
2.1) Для начисления валюты добавляем действие «Изменить баланс валюты» выбираем свой список валюты, ставим переключатель «Увеличить» на 1
Начисляем пользователю рыбу
2.2) Для сохранения количества валюты добавляем действие «Задать значение числовой переменной» называем его fish и задаем значение равным {field:andreygorgamer_fish_rating
3) Для добавления комментария создаем действие «Написать комментарий» с текстом:
{var:platform.user.first_name} {var:platform.user.last_name} у тебя {var:fish} 🐟
и в опциях ставим галочку «Ответить на комментарий»
Отправка комментария
4) Для отправки данных в Автопилот достаточно добавить действие «Отправить запрос на внешний сайт» на адрес (вставить ссылку из Автопилота) и выбрать метод отправки: FORM POST формат JSON
Отправляем запрос
Например, вебхук в автопилоте имеет вид:
https://skyauto.me/cllbck/183635420/1710159/TTI1VzhuWTNDZkFaMFhFd096OUZaUT0?avtp=1&api=1&sid=408053834
Копируем ссылку в действие и вместо ID вставляем переменную:{var:platform.user.id}
В итоге ссылка будет примерно такой:
https://skyauto.me/cllbck/183635420/1710159/TTI1VzhuWTNDZkFaMFhFd096OUZaUT0?avtp=1&api=1&sid={var:platform.user.id}
Важно! Помните, что из-за ограничений ВКонтакте количество одновременных запросов на вебхук Автопилота (15-20 запросов в секунду на один ключ). Можете добавить больше ключей в настройки сообщества Автопилот. Если вы хотите передать несколько параметров в Автопилот, то просто укажите их после параметра sid разделяя амперсандом. Например: &sid={var:platform.user.id}&fish={var:fish} В примере параметр fish может быть любыми данными, которые необходимо передать в Автопилот.

Схема для передачи игровой валюты из Автопилота в Multy.AI

В примере настроено так:
  • В сообществе подключенном к Автопилоту пользователь пишет сообщение и мы передаем количество рыб в Multy.AI.
1) Для того, чтобы реагировать на передачу данных из Автопилота создаем событие «Входящий вебхук» с условием «Вебхук-инициатор события» и выбираем нужный вебхук:
Пример вебхука
2) Чтобы начислить валюту добавляем контейнер с действиями:
Пример контейнера
2.1) Для сохранения количества валюты добавляем действие «Задать значение числовой переменной» назывываем его fish и задаем значение равным {var:request.query.fish}
Получаем GET-параметр fish из Автопилота
2.2) Для начисления валюты добавляем действие «Изменить баланс валюты» выбираем свой список валюты, ставим переключатель «Задать значение» на {var:fish}
Записываем количество рыбок в список
3) Опционально для отправки сообщения создаем действие «Отправить сообщение» с текстом: ​{var:users.user.first_name} {var:users.user.last_name} у тебя {var:fish} 🐟
Пример отправки сообщения
Соединяем все в блоки в цепочку и можно тестировать.