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

В этой инструкции мы будем передавать данные из сервиса 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} 🐟

Пример отправки сообщения

Соединяем все в блоки в цепочку и можно тестировать.

Last updated