Общее руководство по настройке интеграций: что такое правила, условия и действия, как работают шорткоды. Это руководство объясняет принципы, общие для всех сервисов. Детали по конкретному сервису — в его отдельной инструкции.
Общая схема работы
- Источник отправляет данные в Vakas-tools (регистрация, отчёт вебинара, оплата).
- Отличаться можетVakas-tools проверяет данные по правилам, подходит ли лид под условия. только перечень доступных действий — он зависит от возможностей конкретного сервиса и описан в отдельной инструкции к нему.
- Если условия выполнены — выполняются действия: создание сделки, отправка сообщения, обновление полей и т.д.
- Данные передаются в сервис-получатель.
Три типа событий
Данные в Vakas-tools приходят в виде событий трёх типов. В интерфейсе они представлены как вкладки на странице сервиса:
| Вкладка | Когда срабатывает | Какие данные приходят |
|---|---|---|
| Регистрации | Человек зарегистрировался — на вебинар, курс, через форму | Имя, email, телефон, UTM-метки, дата вебинара, доп. поля |
| Отчеты | После вебинара: данные о поведении зрителей Был | Был минут, кликал по кнопке, город, досмотрел до конца и др. |
| Заказы | Создан заказ или поступила оплата | Сумма, тариф, статус платежа, ссылка на оплату и др. |
Правила
Правило — это основная единица настройки. Оно определяет: для каких данных и что именно сделать в сервисе-получателе.
Каждое правило состоит из условий. Условия (необязательно) — фильтр: какие данные обработать, а какие пропустить.
Создание правила
- Перейдите на нужную вкладку (Регистрации, Отчёты или Заказы).
- Нажмите «Добавить правило».
- В открывшемся окне заполните:
- Правило активно — поставьте галочку, чтобы правило работало. галочка, чтобы правило работало. Если снять — правило будет сохранено, но не будет выполняться.
- Название — задайте понятное имя (например, «Все лиды», «Кликнул по кнопке», «Был больше 60 мин»).
- Порядок — число, определяющее очерёдность выполнения правил (1, 2, 3...). Правила проверяются от меньшего к большему.
- После выполнения не выполнять другие правила — если включить, следующие правила для этого лида проверяться не будут.
Правило без условий
Если у правила нет условий — оно сработает для всех данных на этой вкладке.
Рекомендация: первое правило (с порядком 1) оставляйте без условий. Это гарантирует, что все данные будут обработаны. Если все правила будут с условиями — данные, не подходящие ни под одно из них, просто пропадут.
Условия
Условия — это фильтры внутри правила. Они определяют, какие именно данные попадут под обработку.
Как добавить условие
- В окне редактирования правила нажмите "Добавить условие".
- Заполните три поля:
| Поле | Что указать | Примеры |
|---|---|---|
| Поле | Какой параметр проверять | «был минут», «кликал ли по кнопке», «utm_source», «email» |
| Условие | Оператор сравнения | =, ≠, >, <, ≥, ≤, содержит, не содержит |
| Значение | С чем сравнивать | 60, 1, yandex, VIP |
Примеры условий
| Поле | Условие | Значение | Что означает |
|---|---|---|---|
| был минут | > | 60 | Был на вебинаре больше часа |
| кликал ли по кнопке | = | 1 | Нажал кнопку на вебинаре |
| utm_source | = | yandex | Пришёл из Яндекса |
| был минут | < | 15 | Был на вебинаре меньше 15 минут |
| payment_status | содержит | Оплачен | Заказ оплачен |
| positions | содержит | VIP | Тариф содержит слово «VIP» |
Несколько условий
Можно добавить несколько условий в одно правило. Все условия объединяются через И — то есть все они должны выполниться одновременно.
Пример: был минут > 60 И кликал ли по кнопке = 1 — сработает только для тех, кто был больше часа и кликнул по кнопке.
Порядок выполнения правил
Правила проверяются по порядку (по числу в поле «Порядок»). Для каждого лида система проходит правила одно за другим:
- Проверяет условия правила.
- Если условия выполнены — выполняет действия этого правила.
- Если включена галочка «После выполнения не выполнять другие правила» — остальные правила пропускаются.
- Если галочка не включена — система переходит к следующему правилу.
Если лид подходит под несколько правил — действия каждого из них будут выполнены. Если в нескольких правилах обновляется одно и то же поле — значение из последнего выполненного правила перезапишет предыдущие.
Действия
Действия — это то, что произойдёт в сервисе-получателе, когда правило сработало. Набор доступных действий зависит от сервиса.
Как настроить действия
- В таблице правил нажмите кнопку "Действия" напротив нужного правила.
- Откроется конструктор действий.
- Нажмите "Добавить действие" и выберите тип из списка.
- Заполните поля действия.
Типичные действия (зависят от сервиса)
| Сервис | Типичные действия |
|---|---|
| amoCRM | Контакт, Сделка, Доп. поля сделки, Изменить этап, Примечание, Доп. поля контакта, Теги, Задача |
| Bitrix24 | Контакт, Лид, Сделка, Доп. поля, Изменить стадию, Товар, Задача, Комментарий |
| GetCourse | Пользователь, Группы пользователя, Поля контакта, Заказ, Заказ (множественный), Поля заказа |
| SaleBot | Запустить воронку, Переменные, Сообщение |
Полный список действий для конкретного сервиса — в его отдельной инструкции.
Шорткоды
Шорткоды — это подстановки данных. Вместо того чтобы вписывать значения вручную, вы указываете шорткод, и система подставит реальные данные из входящего события.
Формат
Шорткод выглядит так: {#имя_поля#}. Например:
- {#name#} → подставится имя контакта (например, «Иван Петров»)
- {#email#} → подставится email (например, «ivan@mail.ru»)
- {#costMoney#} → подставится сумма (например, «5000»)
Где использовать
Шорткоды работают во всех текстовых полях конструктора действий:
- Название сделки: Регистрация: {#name#}
- Текст примечания: Был на вебинаре {#bil_minut#} минут
- Текст задачи: Перезвонить: {#name#}, {#phone#}
- Теги: {#webinarId#}, регистрация
- И так далее.
Как найти нужный шорткод
Нажмите иконку {--} рядом с любым текстовым полем — откроется список всех доступных шорткодов для текущего типа события. Кликните на шорткод, чтобы скопировать его.