Интеграция с Пьедестал

«Пьедестал» — это объединённый в одном приложении набор инструментов, который позволит поднять активность в сообществе и выведет взаимодействие с подписчиками на новый уровень. И да он интегрируется с Автопилотом. Интересно? Тогда читаем дальше.

Установка приложения

Переходим в сообщество приложения: vk.com/pedestal и в описании или снизу виджета находим ссылку → vk.com/app7147757, переходим по ней и жмем кнопку «Подключить к сообществу».

Специально для наших любимых подписчиков дополнительно промокод: autopilot

Важно! Бонус по промокоду: Бонус для приглашенного: +7 дней лицензии после первой оплаты. Промокод действует 30 дней с момента регистрации в приложении

Устанавливаем себе приложение в нужное сообщество, нажимаем «Подключить сообщество», разрешаем ему нам писать, устанавливаем в сообщество и жмем кнопку «Добавить»

В установленном приложении открываем пункт «Настройки», Раздел «Администратору» проматываем страницу ниже и нажимаем «Создать ключ с полными правами»

Записываем ключ API, например, 706eed7c69d14e5297c665876eeaa16d4c26e120f2e365bac4bc36602a15f6235f6a743d

Кликаем на пункт «Подробнее про API»

Важно! Ограничение: 10 запросов в секунду с ip-адреса. Для популярных сервисов, где от многих пользователей запросы идут с 1 ip-адреса, лимит значительно увеличен.

Также в документации написано разграничение по правам:

Только чтение — ключу будут доступны только методы получения данных. Использовать метод изменения данных, например, изменение баланса пользователя, не получится. Создайте такой ключ, если знаете, что в сервисе, в котором будете его использовать, не понадобятся права на изменение данных.

Чтение и изменение — доступны все методы

Именно поэтому ранее и был выпущен ключ с полными правами.

Собственно, устанавливаем виджет и идем в Автопилот. Давайте настроим синхронизацию виджета со списками Автопилота.

Команда «Синхронизация с комментариями»

События:

1) Событие: «Написал комментарий» с любым текстом и под любым постом (для реакции на любой пост удалите -1 и оставьте поле пустым).

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

2) Нажимаем кнопку : «Добавить секцию» и добавляем событие : «Добавлен в список игроков» — список для учета активностей. Если таковой список есть в другой команде этот шаг можно пропустить. В примере список 541148.

Действия:

1) Действие: «Отправлен GET/POST запрос» на адрес https://pedestal.aiva-studio.ru/apiv1/ratingUserGet.php c параметрами:

• access_token — ключ доступа приложения
• user_ids — массив id пользователей ВКонтакте, по которым надо получить кол-во баллов из рейтинга (максимум 2000). Мы будем указывать текущего пользователя, поэтому значение параметра будет %vk_id%;
• details — если равен 1, то в ответе будет информация о количестве учтённых лайков, комментариев, голосований и постов (по умолчанию 0). Учтёнными активностями считаются те активности, за которые начислены баллы. Если комментарий не прошёл по кол-ву символов, то это неучтённый комментарий;

2) Временная переменная %ball%= %response.response.0.rating%

Количество заработанных баллов Пьедестал вернет ответе сервера %response%в виде JSON объекта с полем rating, которая будет сохранена во временную переменную%ball%

Важно! По заявлению техподдержки «Пьедестал» если пытаетесь запросить пользователя которого нет в рейтинге, то %response% вернет пустой запрос

3) Действие : «Добавлен в список игроков» в список 541148 и уровень установлен равным%ball%

4) ОПЦИОНАЛЬНО: Отправляем сообщение в ответ с текстом:

%first_name%, спасибо за активность. У вас до обновления рейтинга было {level}541148{/level} {case} {level}541148{/level}|балл|балла|баллов{/case}.

Ваш рейтинг можете посмотреть в виджете, либо здесь (важно: рейтинг обновляется через 10 минут после последней активности):

Кликаем в действии 541148 на откр и копируем ссылочку на рейтинг из адресной строки браузера. 

Важно! Рейтинг обновляется не мгновенно (от 5 минут после последней активности), поэтому предыдущее действие показано лишь в качестве демонстрации, иначе Вы удивите новых пользователей сообщением: «У вас 0 баллов».

Все. Включаем команду, открываем рейтинг.

Напишем комментарий и проверим.

А как же лайки, предложенные посты? Очень просто: делаете отдельные секции с событиями: «Поставил лайк» или «Создал пост», а действия оставляете теми же. Для реакции на удаления комментария есть событие: «Удалил комментарий». Все получится, Вы справитесь.

Статью подготовил Андрей Горячих.

Задать вопрос, оставить замечание или пожелание (или просто лайкнуть инструкцию) можно в этом посте.