Триггеры

Триггер - это функция, которая реагирует на различные события и запускает определенные действия. Например, с помощью триггеров можно запустить чат-бота, когда пользователь напишет ключевое слово.

Триггеры настраиваются в одноименном разделе в личном кабинете.

События

Для работы триггеров поддерживаются следующие события.

Сообщения

Новое сообщение

Сообщения могут быть как ВХОДЯЩИМИ так и ИСХОДЯЩИМИ

Триггер на входящее сообщение:

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

Триггер на исходящее сообщение:

Данный триггер сработает в момент, когда администратор сообщества напишет сообщение подписчику от имени сообщества в диалоге с сообществом.

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

В перечисленных выше видах триггеров можно настроить любой из нижеперечисленных вариантов:

• Любое сообщение (не рекомендуется использовать с любым другим триггером данной группы)

• Сообщение равно (полностью соответствует указанному слову или фразе без учета регистра)

• Сообщение не равно (любая фраза, кроме указанной)

• Сообщение содержит (содержит указанную фразу)

• Сообщение не содержит (любая фраза, не содержащая указанную)

• Сообщение соответствует регулярному выражению (можно задать определенное регулярное выражение)

• Сообщение - телефон российского формата с 11 цифрами (можно задать с 8, +7 или 7)

• Сообщение - E-mail (сработает только для сообщения с электронной почтой. Если в сообщении будет дополнительный текст, кроме почты, то триггер не сработает)

• Сообщение - Число (соответствует указанному числу)

• Сообщение меньше числа (любое число, которое меньше указанного)

• Сообщение больше числа (любое число, которое больше указанного)

• Сообщение содержит стикер (сработает на любой стикер)

• Сообщение содержит фотографию (любое сообщение с фотографией)

• Сообщение содержит видеозапись (любое сообщение с видео)

• Сообщение содержит аудиозапись (любое сообщение с аудио)

• Сообщение содержит документ (любое сообщение с документом)

• Сообщение содержит голосовое сообщение (любое сообщение с голосовым сообщением)

• Сообщение содержит товар (любое сообщение с товаром, либо можно выбрать конкретный товар. Если не выбран конкретный товар - триггер сработает в том числе и на услугу)

• Сообщение содержит вложения (любое сообщение с любым вложением или несколькими)

• Сообщение не содержит вложения (любое сообщение без вложения)

• Ссылка на диалог с сообществом содержит параметр ref — срабатывает, если пользователь перешёл в диалог с сообществом по ссылке, в которой указан параметр ref.

  Параметр ref позволяет направить пользователя в нужный сценарий напрямую по ссылке. Такую ссылку можно заранее разместить на внешних площадках, добавить в QR-код или передать через другой канал коммуникации.

  Кроме того, разные значения ref можно использовать для определения источника перехода. Это позволяет разделять аудиторию, запускать разные сценарии для пользователей из разных источников и оценивать эффективность точек входа.

• Ссылка на диалог с сообществом содержит параметр ref_source — срабатывает, если пользователь перешёл в диалог с сообществом по ссылке, в которой указан параметр ref_source.

  Параметр ref_source также можно использовать для определения источника перехода пользователя и запуска разных сценариев в зависимости от указанного значения.

Фотографии

Загрузка фотографии

Данный триггер позволит отправить сообщение в момент, когда пользователь загружает фотографию в открытый альбом сообщества.

Новый комментарий к фотографии

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

Редактирование комментария к фотографии

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

Удаление комментария к фотографии

Данный триггер сработает в момент удаления ранее оставленного комментария к любой или указанной по ссылке фотографии.

Восстановление удалённого комментария к фотографии

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

Для событий создания, редактирования и восстановления комментария можно настроить фильтр текста, если он доступен для выбранного типа комментария. Для события удаления фильтр текста не применяется: триггер проверяет событие удаления и выбранный объект (например, фотографию, видеозапись, запись, обсуждение или товар). Действие выполняется для пользователя, который удалил комментарий.

Для события "Загрузка видеозаписи" можно задать фильтр по описанию: "Описание видео содержит" проверяет наличие указанной фразы, а "Описание видео соответствует регулярному выражению" проверяет описание по регулярному выражению. Например, для условия "содержит 52" подойдут описания "52" и "Видео 52 опубликовано". Если описание пустое или отсутствует, текстовый фильтр не совпадёт. Чтобы запускать триггер для любого описания, выберите вариант без текстового условия.

Записи на стене

Добавление записи

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

Репост записи

Данный триггер сработает в момент репоста любой записи сообщества или указанной по ссылке к себе на стену. Текст записи можно задать любым, содержащим определенную фразу, либо соответствующим регулярному выражению. При этом, есть особенность - профиль должен быть открытым.

Лайк записи

Данный триггер сработает в момент, когда пользователь поставит лайк на запись (пост) на стене сообщества.

Можно настроить срабатывание:

• на лайк любой записи сообщества;
• на лайк конкретной записи, указанной по ссылке (формат: https://vk.com/wall-XXXXX_YYY).

Заказ

Создание заказа

Кроме создания заказа, доступны события "Изменение заказа" и "Просмотр заказа пользователем". Триггер запускает настроенное действие при соответствующем событии. Для работы событий заказов включите расширенный раздел "Товары" в настройках сообщества.

Данный триггер сработает в момент оформления заказа на товар в сообществе. Для работы данного типа события необходимо включить расширенный раздел "Товары" в настройках сообщества.

Пользователи

Вступление в сообщество

Данный триггер сработает в момент вступления пользователя в сообщество.

Выход из сообщества

Данный триггер сработает в момент выхода пользователя из сообщества.

Прочее

Голос в публичном опросе

Данный триггер сработает после голосования в любом или указанном по ссылке опросе (как получить ссылку на опрос?).

Заявка с лендинга

Данный триггер сработает в момент отправки заявки с лендинга. Помимо настройки самого триггера в лендинге необходимо добавить в любом из блоков кнопку типа Заявка с номером телефона.

В настройках триггера выберите один или несколько лендингов, для заявок с которых нужно запускать действие. В редакторе лендинга откройте настройки блока с кнопкой заявки и включите «Отправлять событие в триггер». Если нужно сохранять телефон, включите в триггере опцию сохранения номера в пользовательскую переменную. Без отправки события из блока заявка не запустит этот триггер. Сообщение-уведомление в диалоге VK после заявки — отдельное событие и не заменяет landing_lead.

VK Donut

Пользователь оформил подписку

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

Пользователь отменил подписку

Данный триггер сработает для пользователя, решившего перестать поддерживать автора сообщества.

Действия

На каждое событие можно добавить одно или несколько следующих действий:

• Добавить в группу подписчиков
• Исключить из группы подписчиков
• Добавить в чат-бота

Можно добавить подписчика как в начало чат-бота, так и на определенный его шаг.

• Исключить из чат-бота

Пример

Для примера разберем добавление в группу подписчиков по ключевому слову "подарок".

Для этого необходимо создать триггер с такими настройками:

1. Тип события - Новое сообщение
2. Проверка сообщения - Сообщение равно (для точного совпадения)
3. Значение - подарок (регистр букв не учитывается)
4. Добавить в группу подписчиков - Выбрать целевую группу

Ошибки

Дублирующие сообщения

Если в триггере настроено добавление в бота и группу подписчиков, и одновременно в группе подписчиков тоже выбрано добавление в этого же бота, то бот будет запускаться дважды. Это значит, что первое сообщение в боте будет отправляться повторно.

В этом случае нужно в триггере убрать добавление в бота, и пользователь будет добавляться только после добавление в группу.

Одинаковые группы подписчктиков/чат-боты указаны и в добавлении, и в исключении

Если одна и та же группа указана и в добавлении, и в исключении, сначала выполняется добавление, затем исключение; в итоге подписчик не состоит в этой группе. Если один и тот же чат-бот указан и для добавления, и для исключения, сначала выполняется добавление, затем исключение из бота. Настраивайте каждое действие отдельно, если нужен другой итог.

Настройка

Callback API позволяет получать уведомления о событиях в сообществе: разрешение сообщений, входящие сообщения и другие (документация ВКонтакте).

На основе Callback API работают триггеры и кнопки в ботах. Если при их работе возникают неполадки, то необходимо выполнить автоматическую настройку в раздел Настройки - Подключение.

Возможные ошибки при автоматической настройке:

Сервер вернул неправильный ответ

Если у вас возникает такая ошибка, значит вы пытаетесь вручную подтвердить сервер. Это не нужно делать. Чтобы ошибка исправилась, необходимо выполнить автоматическую настройку, как описано выше.

Полезные материалы