Внешний триггер — это запуск многошагового бота по событию, которое произошло за пределами диалога. Бот стартует сразу, без ключевого слова и без клика подписчика.

Внешний триггер работает только в ботах на каналах Telegram, ВКонтакте и MAX.

Что это и для чего нужно

Внешний триггер добавляет ещё один способ запуска: бот стартует по событию, которое зафиксировала внешняя система или сама платформа BotHelp — например, интеграция GetCourse сообщила о смене статуса заказа.

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

В шаге «Старт» можно настроить сразу несколько источников внешнего триггера — до 15 на один бот. Доступны такие источники:

  • подписка на группу/канал Telegram;
  • посещение вебинара на платформе Bizon365;
  • статус заказа в GetCourse;
  • действия с меткой — метка добавлена или метка удалена;
  • действия с полем — имя, e-mail, телефон, UTM-параметры.

Как добавить источник триггера

  1. Откройте нужного бота и перейдите к шагу «Старт».
  2. Нажмите «Добавить триггер».
  3. Выберите тип источника из списка.
  4. Заполните обязательные поля источника — они зависят от типа (см. раздел ниже).
  5. Сохраните источник.

При сохранении система проверяет ограничение на — не занят ли этот же источник (то же значение) в шаге «Старт» другого бота на этом канале.

Источники триггера запуска

Подписка на группу/канал Telegram

Источник срабатывает, когда подписчик подписывается на конкретную группу или канал Telegram. Работает только для Telegram — независимо от того, в каком канале запускается сам бот (то есть подписка на Telegram-канал может запускать в том числе многоканального бота).

Обязательное поле: «@groupname или ID» — имя открытой группы/канала в формате @groupname либо ID закрытой группы/канала.

Обязательное условие: бот должен быть добавлен администратором в указанную группу или канал — иначе Telegram не присылает событие о подписке. В интерфейсе при настройке источника показывается алерт с напоминанием об этом и ссылкой на инструкцию по работе с группами и каналами Telegram.

Пример настройки: вы ведёте закрытый Telegram-канал с платным контентом и хотите, чтобы каждому новому подписчику канала бот сразу присылал приветственную цепочку с навигацией по каналу. Добавьте источник «Подписка на группу/канал Telegram», укажите ID канала — и бот будет стартовать в диалоге с подписчиком сразу после того, как он подпишется.

Особенности срабатывания:

  • если подписчик отписался от канала и через время подписался заново — триггер сработает повторно, на каждое новое событие подписки, а не только на самое первое;
  • если подписчик подписался на другой Telegram-канал вашего кабинета, не тот, что указан в источнике, — триггер не сработает.

При срабатывании в диалоге подписчика появляется системное сообщение: «Сработал триггер запуска «Подписался на группу/канал: {@groupname или ID}»».

Посещение вебинара Bizon365

Источник срабатывает, когда подписчик фактически посетил трансляцию вебинара на платформе Bizon365 (не просто зарегистрировался на него).

Обязательное поле: «ID комнаты» — идентификатор комнаты вебинара в Bizon365

Необязательный параметр: чекбокс «Учитывать проведённое время». Если включить его, появляется дополнительное обязательное поле «Время (мин.)» — минимальное время, которое подписчик должен провести на трансляции, чтобы событие считалось посещением.

Для работы источника нужно предварительно настроить интеграцию с Bizon365 и процесс передачи событий по инструкции интеграции — в интерфейсе при настройке источника показывается алерт с напоминанием об этом.

Пример настройки: вы проводите вебинар и хотите, чтобы после трансляции бот запускался только у тех, кто провёл на эфире не менее 20 минут, и присылал им запись и специальное предложение. Добавьте источник «Посещение вебинара Bizon365», укажите ID комнаты, включите «Учитывать проведённое время» и укажите 20 минут.

Особенности срабатывания: если подписчик зарегистрировался на вебинар, но не зашёл на трансляцию, триггер не срабатывает — учитывается только факт посещения.

Статус заказа в GetCourse

Источник срабатывает, когда заказ в GetCourse переходит в определённый статус.

Обязательное поле: «Статус заказа» — выбирается из списка: новый, завершён, отменён, ложный, в работе, ожидает оплаты, частично оплачен, ожидаем возврата, не подтверждён, отложен.

Дополнительно обязательно заполнить одно из двух:

  • «ID предложения» — число (можно передать через макрос типа «Число»);
  • «Тег» — один или несколько тегов, выбираются из списка тегов предложений GetCourse.

Пример настройки: вы хотите, чтобы после оплаты курса бот сразу присылал ученику доступ к материалам. Добавьте источник «Статус заказа в GetCourse», выберите статус «Оплачен» (или «Завершён» — в зависимости от того, какой статус фиксирует оплату в вашей воронке GetCourse) и укажите ID предложения или тег продукта.

Особенности срабатывания:

  • проверяется именно новое значение статуса на момент изменения, а не факт, что заказ когда-либо был в нужном статусе. Например, если триггер настроен на статус «Оплачен» и заказ прошёл путь «Новый» → «Оплачен» → «Возврат», повторного срабатывания на «Оплачен» при переходе в «Возврат» не будет;
  • если GetCourse присылает статус заказа сразу, минуя промежуточные значения, — триггер всё равно сработает, если итоговый статус соответствует условию.

Действия с меткой

Источник срабатывает на сам факт действия с меткой у подписчика — простановку или снятие, а не на текущее наличие метки. Это два независимых варианта источника:

  • метка добавлена — реагирует на событие простановки метки;
  • метка удалена — реагирует на событие её снятия.

Обязательное поле: «Метка» — выбирается из списка меток кабинета. Дополнительных параметров нет.

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

Особенности срабатывания:

  • если у подписчика метку сняли и сразу поставили обратно — триггер «метка добавлена» сработает повторно, на каждое новое событие простановки, а не только при первом появлении метки;
  • если метку, которую подписчику никогда не ставили, пытаются снять — событие снятия не создаётся, и триггер «метка удалена» не срабатывает.

При срабатывании в диалоге подписчика появляется системное сообщение: «Сработал триггер запуска «Действия с меткой: {имя метки}»».

Действия с полем

Источник срабатывает при изменении значения одного из существующих полей подписчика: имя, e-mail, телефон, а также отдельных UTM-полей.

Настройка использует тот же конфигуратор, что и в шаге «Условие» — поле + оператор + значение.

Набор доступных операторов зависит от типа поля:

Тип поля Операторы Значение
Текст (имя, e-mail, телефон, UTM) соответствует / не соответствует / содержит / не содержит / неизвестно (не заполнено) / имеет какое-то значение (заполнено) константа, другое поле или переменная кабинета
Число равно / не равно / больше / меньше / больше либо равно / меньше либо равно константа-число, числовое поле или переменная
Дата равно / больше либо равно / меньше либо равно константа из календаря, текущая дата, поле или переменная типа «Дата»
Дата и время равно / больше либо равно / меньше либо равно константа из календаря с временем (ЧЧ:ММ), текущая дата и время, поле или переменная типа «Дата и время»

Триггер срабатывает, если значение поля изменилось (было X, стало Y) и новое значение Y проходит по заданному оператору. Проверяется только новое значение на момент изменения — не важно, соответствовало ли условию старое значение. Первое заполнение пустого поля не считается изменением и не запускает триггер, даже если введённое значение уже подходит по условию.

Примеры для оператора и поля «Телефон»/«Имя»/«Email»:

  • оператор «содержит», значение «137»: было 89261234567, стало 89261371234 — сработает; стало 89261239999 — не сработает;
  • оператор «не содержит», значение «@test.ru» (поле «Email»): было login@test.ru, стало login@mail.ru — сработает; стало login2@test.ru — не сработает;
  • оператор «соответствует», значение «Иван» (поле «Имя»): было «Ваня», стало «Иван» — сработает; стало «Иван Петров» — не сработает;
  • оператор «не соответствует», значение «Иван» (поле «Имя»): было «Иван», стало «Пётр» — сработает; стало «Иван» — не сработает;
  • оператор «неизвестно» (не заполнено): было 89261371234, поле очистили — сработает;
  • оператор «имеет какое-то значение» (заполнено): было 89261234567, стало 89261239999 — сработает; но первое заполнение пустого поля этим же оператором не считается изменением и не сработает.

Пример настройки: вы хотите запускать отдельную цепочку для подписчиков, которые пришли с определённой рекламной кампании. Добавьте источник «Действия с полем», выберите поле utm_campaign, оператор «соответствует», значение — код нужной кампании.

При срабатывании в диалоге подписчика появляется системное сообщение: «Сработал триггер запуска «Действия с полем: {имя поля}»».

Ограничения и защита от конфликтов

Лимит источников на бота

На один бот можно настроить не более 15 источников триггера — независимо от их типа. Это отдельный лимит, не связанный с лимитом в 15 условий внутри шага «Условие». Лимиты не суммируются и не влияют друг на друга.

Защита от дублирования триггера в разных ботах

Один и тот же источник с одним и тем же значением (например, «метка добавлена = Прогрет») нельзя настроить в шаге «Старт» сразу в двух ботах внутри одного канала. При попытке сохранить такой источник появится предупреждение, и сохранение будет заблокировано — прямо в момент настройки, до того как источник начнёт работать.

Защита от зацикливания между ботами

Если триггер в одном боте может сработать от действия внутри другого бота, система проверяет, не образуется ли цикл запусков.

Пример: бот A на одном из шагов ставит подписчику метку «Прогрет». В боте B настроен источник «метка добавлена = Прогрет» — бот B запускается после бота A. Если затем в боте A попытаться настроить источник на метку, которую ставит бот B, получится цикл: A запускает B, а B — снова A. Такое подключение источника запрещено, при попытке сохранения система покажет предупреждение.

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

Дополнительно:

  • если бот остановлен (деактивирован), его источники триггера не срабатывают — событие просто не приводит к запуску;
  • настройки шага «Старт», включая источники триггера, не копируются при копировании бота — после копирования их нужно настроить заново.

Ветка «Вернуть на прерванный шаг»

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

На канвасе бота эта ветка отображается финальным узлом — карточкой без исходящих переходов. Устанавливать переход в неё можно не только с первого сообщения, а с любого шага бота, а также с любой кнопки, поддерживающей переход в другой бот (inline-кнопка, URL-кнопка, кнопка меню Telegram, клавиатура ВКонтакте и аналогичные элементы в других каналах).

Если для подписчика зафиксирован прерванный шаг, во время срабатывания внешнего триггера, переход «Вернуть на прерванный шаг» отправляет его именно туда, и бот продолжает работу дальше по обычным связям цепочки.

Например, если внешний триггер запускает бота B, пока подписчик уже находится в другом боте A — бот A останавливается. Два многошаговых бота не выполняются параллельно для одного подписчика. Шаг, на котором подписчик находился в боте A в момент остановки, фиксируется как его «прерванный шаг» в боте A — на него можно будет вернуть подписчика веткой «Вернуть на прерванный шаг», если она настроена в боте A и позже сработает её собственный триггер запуска.

Если прерванного шага нет — например, это первый заход подписчика через данный триггер, либо шаг был удалён из бота при пересборке — переход не выполняет никакого действия. Бот для этого подписчика завершается на этом узле, как на обычном финальном узле без исходящих переходов, без дополнительных уведомлений.

Одновременное срабатывание нескольких триггеров

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

Если вы не нашли ответ на свой вопрос, задайте его нам в чате внутри кабинета либо напишите на hello@bothelp.io

Получите 14 дней полного функционала платформы для создания рассылок, автоворонок и чат-ботов BotHelp.

Получить 14 дней бесплатно

Зарегистрируйтесь в BotHelp

14 дней полного доступа бесплатно. Хватит, чтобы собрать первого бота и проверить его на реальных подписчиках.

Создать аккаунт

Была ли статья полезна?

Наши каналыTelegramMAX
Спасибо за обратную связь!