Автопилот (через вебхуки)
Last updated
Last updated
В этой инструкции мы будем передавать данные из сервиса Multy.AI в сервис «Автопилот». Для чего:
Например, вы хотите передавать накопленные баллы в рейтинг Автопилота
У вас есть рабочая схема воронки в Автопилоте и вам нужно передавать накопленные баллы в Multy.AI
Для примера: у вас есть геймификация с начислением игровой валюты и вам нужно передать накопленные средства в Автопилот. Мы рассмотрим пример на примере рейтинга
Для начала давайте проверим, что у вас:
Важно! В примере мы будем рассматривать передачу данных на примере баллов (игровой валюты). Сейчас не рассматривается принцип работы с сервисом «Автопилот». Предполагается, что вы уже работали с ним. Если нет, то необходимо изучить соответствующие инструкции.
Пока отложим команды в Автопилоте и сделаем вебхук для передачи данных из Автопилота в Multy.AI.
Важно! Необходимо заменить ссылку в примере и в командах на ваш вебхук. Ниже будут описаны только те параметры, ккоторые необходимы.
Тип контакта - Здесь указываете по какому параметру будет произведен поиск пользователя. Указываете: ID профиля ВКонтакте.
В «Источник данных» указываем:
GET-параметры ссылки - параметры ссылки переданы в виде GET-параметров, они указаны после ?. Например, для запроса будем отправлять параметры так https://cb.multy.ai/api/v1/hook/app/b45b49c1f41afe71bcd9ce5ffd97f762?vk_user_id=ID пользователя в Вконтакте
Путь к значению контакта - нужно указать, где будет искать путь для пользователя. Например, для примера выше может быть найден по такому пути: vk_user_id
Задать интеграцию - В данном списке вы можете выбрать интеграцию для которой будет срабатывать вебхук. Например вы можете выбрать бота и все сообщения будут отправляться от его имени. В примере указано сообщество «Test Multy»
После настройки не забудьте нажать «Сохранить» и скопировать вебхук в блокнот.
Чтобы пример из схемы работал корректно, необходимо создать игровую валюту «Рыбки» с именем: 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.
1) Для того, чтобы реагировать на передачу данных из Автопилота создаем событие «Входящий вебхук» с условием «Вебхук-инициатор события» и выбираем нужный вебхук:
2) Чтобы начислить валюту добавляем контейнер с действиями:
2.1) Для сохранения количества валюты добавляем действие «Задать значение числовой переменной» назывываем его fish и задаем значение равным {var:request.query.fish}
2.2) Для начисления валюты добавляем действие «Изменить баланс валюты» выбираем свой список валюты, ставим переключатель «Задать значение» на {var:fish}
3) Опционально для отправки сообщения создаем действие «Отправить сообщение» с текстом: {var:users.user.first_name} {var:users.user.last_name} у тебя {var:fish} 🐟
Соединяем все в блоки в цепочку и можно тестировать.
Скачать готовую схему можно тут: 💾 🔧
Итак, в сервисе «Автопилот» в нужном сообществе в разделе создаете список игроков с названием «Баллы». В примере номер 1710197
Для этого согласно этой создаем вебхук с названием «Автопилот» и прописываем корректные данные.
Если Вы не знаете как создать валюту, то посмотрите в этой
