🟣Обработчик событий

Альтернативные варианты запуска видео: 👉 VK-видео 👉 Rutube

Блок "Обработчик событий" в LeadConverter — это мощный инструмент, предназначенный для упрощения, структурирования и оптимизации логики ваших чат-ботов. Он позволяет задавать собственные события и запускать в ответ на них определённые действия — в любом месте сценария и даже в других ботах вашей кампании.

Этот блок особенно полезен, когда:

  • Одни и те же действия нужно повторять в разных местах сценария;

  • На одно событие нужно выполнить несколько задач одновременно (например, интеграции с CRM, уведомления, отправки данных через вебхук и т.д.);

  • Вы хотите централизованно управлять логикой бота;

  • Требуется масштабируемость и удобное сопровождение больших проектов.

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

В этой инструкции вы узнаете, как использовать блок "Обработчик событий", как он устроен, какие настройки доступны и в каких случаях он принесёт максимальную пользу.

Структура блока "Обработчик событий"

Блок "Обработчик событий" содержит несколько настраиваемых элементов, каждый из которых отвечает за определённую часть логики.

  1. Имя события.

Это ключевой элемент блока. Сюда вводится название события, на которое должен среагировать обработчик. Это имя должно в точности совпадать с названием события, которое вы запускаете через блок "Действие" - "Запустить событие".

Имя можно придумать любое: например: Оставлен телефон, Заказ оформлен, тестирование:успешно, и т.п.

Регистр (заглавные или строчные буквы) не имеет значения.

Так же в имени события можно использовать маску события.

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

Для этого используется специальный символ — звёздочка *.

Если указать имя события как:

тестирование:*

то обработчик среагирует на все события, начинающиеся с тестирование: — например:

  • тестирование: начато

  • тестирование: завершено успешно

  • тестирование: неудачно

Маска события позволяет сократить количество обработчиков при одинаковой логике.

  1. Сохранить имя события в переменную.

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

Как работает:

  • Вы задаёте имя переменной, например: статус_теста.

  • При запуске события, в переменную автоматически сохраняется его точное название.

  • Вы можете использовать эту переменную в следующих блоках: для показа оператору, записи в CRM, в условиях сценария и т.д.

Пример:

Если сработало событие тестирование:неудачно, а в переменную записано это название, оператор получит сообщение:

Пользователь завершил тест на стадии: тестирование:неудачно

  1. Следующий шаг. (Выходы событий)

Блок "Обработчик событий" может обрабатывать несколько разных событий одновременно. Для этого в его настройках можно добавить несколько обработчиков событий, каждый со своим собственным выходом на последующие блоки сценария.

Как это работает:

  • В настройках "Обработчик событий" добавляются события: тестирование, передача

  • На визуальной схеме блока появятся отдельные желтые выходы для каждого события.

  • Далее вы соединяете каждый выход с соответствующей логикой сценария.

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

Как использовать "Обработчик событий" в сценарии

  1. Создаем блок "Действия", в том месте сценария, где должно произойти событие.

  1. Открываем блок действия в режиме "Редактирования" и выбираем тип действия "Запустить событие".

  1. Вводим любое понятное имя события.

  1. Сохраняем блок.

  1. В любом месте сценария (даже в другом боте), добавляем блок "Обработчик событий".

  1. Открываем блок "Обработчик событий" в режиме "Редактирования" и в поле "Имя события" указываем точное название события, на которое он должен среагировать. (рекомендуем копировать название из блока "Действия")

  1. Сохраняем имя события в переменную. Далее мы укажем ее в цепочке события, которая будет выполняться.

  1. Сохраняем блок.

  1. Создаем новый блок "Действия" и выбираем тип "Отправить оператору".

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

  1. В поле "Текст сообщения" указываем нужную для нас информацию, а так же переменную из обработчика событий.

  1. Сохраняем блок.

  1. От желтого выхода события, проводим связь на блок "Действия"- "Отправить оператору".

Тестируем работу воронки.

Когда пользователь завершил тест, бот запустил событие "тестирование завершено".

Обработчик событие отреагировал на этот запуск и выдал прописанную цепочку сценария. В данном случае "Отправка уведомления оператору".

Основные особенности блока "Обработчик событий"

Особенность
Что это значит?

Нельзя проводить входящие связи к блоку

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

Он работает пассивно — просто «слушает» события, которые запускаются в других местах сценария.

Можно создавать несколько обработчиков на одно событие

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

Это удобно, если нужно разделить обработку на независимые ветки: например, один блок отправляет вебхук, другой пишет в CRM, третий уведомляет оператора.

Обработчики можно размещать в разных местах одного бота или даже в разных ботах.

Работает между ботами

Обработчик события может находиться в любом другом боте внутри одной кампании — событие «переходит» между ботами.

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

Это особенно полезно для централизованной логики: интеграций, уведомлений, общего учета и т.п.

Не работает в неактивном боте

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

Имеет выход по умолчанию

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

Это "запасной маршрут" — полезно, если вы хотите выполнить действия при любом событии.

Поддерживает маски и переменные

Блок поддерживает:

Маски событий — для групповой обработки похожих событий;

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

Вы можете сократить количество блоков, если события имеют общую структуру (например, покупка:*).

Переменная позволяет понять, какое именно событие сработало, и отреагировать на него.

💟Как задать вопрос в поддержку?

Last updated

Was this helpful?