Интеграция Sugst с Автопилотом

Сегодня будет проведена интеграция с приложением Sugst. Sugst позволяет публиковать посты по шаблонам и экономить ваше время. Переходим в сообщество https://vk.com/sugst и жмем на кнопку «Установить себе»

Далее все по стандарту — выбираем нужное сообщество и нажимаем кнопку «Добавить». После этих нехитрых манипуляций вы получите сообщение, что приложение установлено.

Важно! В Базовом тарифе ежедневно Вам даётся 10 бесплатных действий модерации для одобрения\планирования\отклонения постов из приложения (количество восполняется в полночь по МСК); В Премиум тарифе все лимиты на количество действий модерации сняты; О тарифах вы можете прочесть, открыв приложение на вкладке «Тарифы». Интеграция будет работать только на премиум — тарифе.

На данный момент тарифы следующие (актуальные тарифы можете узнавать в поддержке Sugst):

• 249р - 1 месяц
• 597р - 3 месяца (скидка 20%)
• 1548р - 1 год (скидка 50%)

• При подключении более 1 сообщества за раз - скидки до 90%

Кликаем на шестеренку и видим поле URL. Именно туда мы вставим вебхук Автопилота из события «Упомянут в GET/POST запросе».

Важно! Обязательно выберите тип виджета и после установки проверьте видимость виджета всем пользователям.

Команда «Интеграция с SUGST»

Допустим, нам нужно начислять 1 балл за предложенный пост.

События:

1) В списке событий выбираем «Упомянут в Get-Post запросе» копируем ссылочку нажав на «скопировать» и вставляем в настройки приложения SUGST.

2) Добавляем условие: числ. переменная %vk_author_id% больше 0

3) Опционально (для реакции только на предложку): Добавляем условие: переменная %event%содержит post_suggested

Важно! На видеоинструкции будет показан метод работы через блок действия «Создать Переменную, зависящую от условий» и в зависимости от хештегов и типа события %event% назначать пользователю разное количество баллов, поэтому условие проверки %event% я не ставил.

4) В блоке «Добавить секцию»добавляем событие «Добавлен в список игроков» для добавления игроков в этот список и начисления им баллов (для примера номер списка будет 498107).

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

Действия:

1) «Меняем исполнителя» с ID %vk_author_id%

2) Далее действия могут быть любыми. Например, «отправить сообщение» в ответ с благодарностью пользователю за предоставленный пост. Текст может быть примерно таким:

{gender}Дорогой,|Дорогая{/gender} %first_name%, спасибо за интересную новость. В благодарность за то, что вы помогли нам с новостями, вы получаете 1 балл.

Ваш рейтинг можно посмотреть тут:

ссылочка на рейтинг - (можно кликнуть на откр в событии 4 и скопировать из адресной строки)

3) «Добавлен в список игроков» 498107 и уровень увеличен на 1 балл.

Запуская событие, Sugst передает несколько полезных переменных. Оставлю их отдельным текстом (в виде уведомления для админа).

%vk_group_id% — ID сообщества к которому подключено приложение.

%vk_author_id% — VK ID автора пользователя предложившего новость.

%sugst_post_id% - уникальный внутренний идентификатор поста внутри приложения Sugst.

%sugst_post_status% - Текущий статус поста:

1 — новый пост, 2 — одобрен-опубликован, 3 — одобрен-отложен, 5 — отклонён;

%event% принимает значение:

post_suggested — для предложенного поста

post_moderated — для одобренного поста

Именно с помощью обработки гет — параметра event вы можете реагировать отдельно на предложенный пост и отдельно на одобренный.

Вы также получаете все данные в массиве block и можете распарсить его с помощью JSON и получить все необходимые данные.

Важно! В Sugst можно создать форму предложенного поста, которая будет состоять не из одного текстового поля - а из любого количества в разных форматах. Например можно добавить в форму поле «Категория» и сделать её выпадающим списком с предустановленным списком категорий.

И тогда на на стороне Автопилота можно не только отлавливать разные события с предложенными, но и точечно реагировать на содержание, делая проверку на условие, например, {get_var}blocks.category.value{/get_var} содержит Заявка на конкурс

(где category - это идентификатор конкретного поля из формы). Форму предложенного поста можно сделать любой - с селектами, галочками, выпадающими списками, масками телефонов, емейлов, ссылок и т.д

Пример кастомной формы предложения поста на скриншоте ниже. Создать свои поля можно через режим редактирования - переключатель «Просмотр - Редактирование» в верхней части раздела «Добавить пост». Идентификатор поля можно посмотреть в режиме редактирования если нажать «Больше настроек поля (1)» и ниже будет ID дополнительного поля.

На скрине ID дополнительного поля = blk59739929530675, значит для проверки на соответствие в данном примере используется{get_var}blocks.blk59739929530675.value{/get_var}

4) ОПЦИОНАЛЬНО: «Отправить сообщение» сотрудникам о новом предложенном посте. Примерный текст:

#предложенный_пост

Кто: %vk_link%

Дата: {date} %F %X{/date}

Собственно все! Включаем команду и идем тестировать.

Как мы видим все работает на ура. Первое сообщение прилетело мне, как пользователю предложившему пост, а второе — как админу, чтобы я не забыл его проверить. На этом все! Творческих взлётов.

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