Триггеры

Триггеры — это точки входа в сценарий: они определяют, в какой момент бот начнёт работать. Каждый сценарий начинается с одного или нескольких триггеров.

Старт по команде

Срабатывает по /start или ключевым фразам. Бот запускает сценарий, если входящее сообщение совпадает с одной из команд.

Настройки:

«Команды (через запятую)» — список команд или фраз, например /start, начать. По умолчанию — /start.

Бот срабатывает, если входящее сообщение совпадает с одной из команд.

Старт по кнопке

Срабатывает по нажатию кнопки «Начать» в VK — это первый запуск диалога с сообществом.

Настройки: отдельных настроек нет — просто соедините выход со стартовым сообщением сценария.

Подписка на сообщество

Срабатывает, когда пользователь подписывается на ваше VK-сообщество (вступает в группу).

Настройки: отдельных настроек не требуется — соедините выход блока со следующим шагом.

VK позволяет писать пользователю, только если он разрешил сообщения от сообщества (например, уже писал вам). Новому подписчику приветствие может не доставиться — надёжнее проставить тег или создать лида в CRM. Проверить сценарий можно во вкладке «Тестирование».

Отписка от сообщества

Срабатывает, когда пользователь отписывается от VK-сообщества (выходит из группы).

Настройки: нет.

Удобно для реактивации: проставьте тег «отписался» или уведомите менеджера. Сообщение в личку отписавшемуся VK обычно не доставит.

Любое сообщение (fallback)

Срабатывает на любое входящее сообщение, если другие триггеры (команда, ключевое слово, кнопка) не подошли.

Настройки: нет.

Это запасной триггер — держите его последним, как «ловушку» для сообщений, которые не попали в другие сценарии.

Сообщение по ключевому слову

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

Настройки:

«Ключевые слова или фразы» (обязательное) — список ключей, по одному на строку. Например: «цена», «стоимость», «сколько стоит».

Нажата inline-кнопка

Срабатывает при клике на inline-кнопку с callback-идентификатором (payload).

Настройки:

«Идентификатор кнопки (payload)» — строковый id, например show_menu.

Триггер сработает, когда подписчик нажмёт inline-кнопку с таким же идентификатором — он задаётся в поле «команда» у кнопки в блоке «Отправить сообщение».

Входящий webhook

Запускает сценарий по HTTP-запросу извне — из CRM, с сайта, после оплаты — и кладёт данные запроса в переменные.

Настройки:

Кнопка «Сгенерировать URL вебхука» / «Перевыпустить токен» — создаёт секретный URL вида https://api.botvk.ru/hooks/<token>. Готовый адрес показывается в поле «URL вебхука (секретный)» с кнопкой «Копировать».

Отправьте на этот адрес POST-запрос с JSON, где есть поле vk_user_id — остальные поля запроса станут переменными (например, {order_id}, {sum}).

Не публикуйте URL вебхука — он даёт доступ к запуску вашего бота.

Комментарий под постом

Срабатывает на новый комментарий к посту сообщества. Можно фильтровать по ключевым словам.

Настройки:

«Ключевые слова в комментарии» — по одному слову на строку, например «хочу», «цена», «участвую». Если оставить пустым — триггер сработает на любой комментарий.

Дальше можно ответить в комментариях (блок «Ответить в комментариях») и/или написать автору в личные сообщения — если он разрешил сообщения сообществу.

Запуск по расписанию

Запускает сценарий по времени — ежедневно или по дням недели — для выбранной аудитории.

Настройки:

«Как часто» — «Каждый день» (по умолчанию) или «По дням недели».
«Дни недели» — кнопки Пн…Вс (только в режиме «По дням недели»); если ничего не выбрано, запуск не произойдёт.
«Время запуска» — по умолчанию 10:00.
«Только подписчикам с тегом (необязательно)» — например vip: запуск получат только подписчики с этим тегом.

Время указывается в часовом поясе бота (вкладка «Настройки»). Запуск получат только те подписчики, которым можно писать: разрешившие сообщения сообществу или писавшие боту за последние 24 часа (ограничение VK). Активный диалог подписчика с этим ботом запуск не прерывает.