Подключение Bitrix24
1 В Bitrix24: Настройки → Интеграции → REST API → Входящий вебхук
2 Скопируйте URL вебхука
3 В Vakas-tools: Сервисы → Добавить сервис → Bitrix24
Важно: без прав crm, user, task интеграция не будет работать. Если появилась ошибка «Недостаточно прав» — вернитесь в Bitrix24 и добавьте недостающие права.
В базах добавьте сервис к базе с помощью кнопки [+Сервис].
Как работает интеграция — общая схема
Передача данных настраивается через правила. На странице сервиса три вкладки: Регистрации, Отчёты, Заказы.
1 Правило
2 Условия
3 Действия
Значок ⧉ — множественное добавление
Зелёный значок ⧉ означает, что действие можно добавить несколько раз. Действия без значка — только один раз.
Подготовка: создание полей и обновление данных
Перед настройкой триггеров создайте нужные поля в Bitrix24.
Создание полей
Выпадающее меню «Создать поля в Bitrix24»:
- Поля для отчётов — Дата просмотра, Был минут, Город, Клик по кнопке, Клик по баннеру, ID вебинара, Досмотрел до конца.
- Поля для оплат — № заказа, Ссылка на оплату, Название тарифа, Оплачено, Осталось оплатить, Стоимость тарифа, Статус платежа, ID пользователя ГК.
Поля создаются один раз. Повторный запуск дублей не создаст.
Обновление данных
После создания полей нажмите «Обновить поля и воронки», затем обновите страницу.
Общие настройки
Применяются ко всем триггерам данного подключения.
Поиск дублей
- Проверять на дубли (рекомендуется) — поиск по email, телефону или доп. полю.
- Не проверять — всегда создаёт новый контакт и сделку.
Дополнительные настройки:
- Доп. поле контакта для поиска — поиск по указанному полю (например, Telegram ID).
- Доп. поле лида для поиска — то же для лидов.
- Доп. поле сделки для поиска — фильтр по полю сделки. Например, «Номер заказа» =
{#payment_number#}. - Искать только в воронках — CTRL для выбора нескольких.
- Не учитывать сделки со статусом — исключает закрытые/отказные.
Шорткоды указываются с фигурными скобками {} без пробелов. Для копирования шорткода нажмите на него в списке.
Распределение менеджеров
Назначение происходит по очереди (round-robin).
Распределяются только новые сделки. Если сделка уже существует — менеджер не изменится (если не включена опция «Всегда менять ответственного»).
Значения по умолчанию
- Торговый каталог — каталог товаров из Bitrix24 (для добавления товаров к сделке).
- Тип телефона — рабочий, мобильный и др.
- Тип email — рабочий, домашний, для рассылки.
Передача регистраций в Bitrix24
Цель: при регистрации автоматически создавать контакт и сделку.
1 Настройте общие настройки
2 Настройте правила
3 Настройте действия триггера
4 Сохраните настройки
Действие «Сделка»
«Добавить действие» → Сделка (найти или создать):
- Название сделки — например:
Регистрация: {#name#}. - Всегда менять название — обновлять при повторном попадании.
- Сумма — оставьте пустым или
0. - Стадия сделки — воронка и стадия. Например: «Новая заявка».
- Ответственный — «По настройкам распределения» или конкретный менеджер.
- Использовать ответственного из контакта — сделка назначится на текущего ответственного.
UTM-поля
| Поле в Bitrix24 | Значение (шорткод) |
|---|---|
| Рекламная система (utm_source) | {#utm_source#} |
| Тип рекламы (utm_medium) | {#utm_medium#} |
| Обозначение кампании (utm_campaign) | {#utm_campaign#} |
| Содержание кампании (utm_content) | {#utm_content#} |
| Ключевое слово (utm_term) | {#utm_term#} |
.jpg)
Комментарий и задача
Комментарий: «Добавить действие» → Сделка → Комментарий:
Регистрация с вебинара {#webinarId#}
Город: {#city#}
Задача: «Добавить действие» → Задача → Создать:
- Привязать к — «Сделка».
- Ответственный — «По порядку» или конкретный менеджер.
- Название — например:
Перезвонить: {#name#}. - Часов на выполнение — по умолчанию 24.
- Описание —
Телефон: {#phone#}, Email: {#email#}.
Для создания задач в настройках вебхука Bitrix24 должны быть выданы права на задачи (task).
Передача отчётов в Bitrix24
Цель: после вебинара передать данные об активности зрителей в поля сделки.
Предварительно настройте, откуда собирать отчёты в базу Vakas-tools (Bizon365, вебхук и т.д.).
1 Создайте поля для отчётов
2 Настройте правила
3 Настройте действия триггера отчёта
4 Сохраните настройки
Действие «Сделка» для отчётов
Оставьте название как при регистрации, чтобы система нашла существующую сделку.
Если сделка уже создана — система найдёт и обновит её, а не создаст новую.
Поля отчётов
«Добавить действие» → Сделка → Доп. поля → «Добавить поля отчётов»:
| Поле в Bitrix24 | Значение (шорткод) |
|---|---|
| Дата просмотра | {#view_date_data#} |
| Был минут | {#bil_minut#} |
| Город | {#city#} |
| Клик по кнопке | {#clickFile#} |
| Клик по баннеру | {#clickBanner#} |
| ID вебинара | {#webinarId#} |
| Досмотрел до конца | {#finished#} |
Если кнопка не добавляет поля — они ещё не созданы. Вернитесь к шагу 1.
Шорткод нестандартного поля можно взять из раздела «Контакты» — выберите нужное поле из данных, пришедших в Vakas-tools.
Изменение стадии и комментарий
- Новая стадия — например: «Был на вебинаре».
- Не перемещать если на стадиях — исключения (например, «Оплачено»).
Действие «Изменить стадию» имеет приоритет выше, чем стадия в «Сделка». Между воронками сделки не перемещаются.
Комментарий:
Был на вебинаре {#webinarId#}, смотрел {#bil_minut#} мин.
Клик по кнопке: {#clickFile#}
Город: {#city#}
Передача заказов и оплат в Bitrix24
Цель: при заказе/оплате обновить сделку — записать сумму, статус, ссылку на оплату.
1 Создайте поля для оплат
2 Настройте поиск дублей для заказов
{#payment_number#}. Так каждый заказ будет в отдельной сделке.3 Настройте правила
4 Настройте действия триггера оплаты
5 Сохраните настройки
Поиск дублей можно осуществлять по другим полям, например по названию тарифа. Значение может быть статичным — если поле пустое или имеет другое значение, будет создана новая сделка.
Действие «Сделка» для заказов
- Название —
Заказ: {#positions#} — {#name#}. - Сумма —
{#costMoney#}. - Стадия — «Ожидает оплату».
- Ответственный — «По порядку» или конкретный менеджер.
Поля оплат
| Поле в Bitrix24 | Значение (шорткод) |
|---|---|
| № заказа | {#payment_number#} |
| Ссылка на оплату | {#paymentLink#} |
| Название тарифа | {#positions#} |
| Оплачено | {#payedMoney#} |
| Осталось оплатить | {#leftCostMoney#} |
| Стоимость тарифа | {#costMoney#} |
| Статус платежа | {#payment_status#} |
| ID пользователя ГК | {#getcourse_user_id#} |
Товар к сделке
1 Убедитесь что выбран торговый каталог
2 «Добавить действие» → Товар → Добавить к сделке
{#costMoney#}).3 Включите обновление цены
Изменение стадии и комментарий
- Новая стадия — «Оплачено».
- Исключения — «Успешно реализовано» (CTRL для нескольких).
Данные обновятся, но сделка останется на прежней стадии, если она не в списке исключений. Между воронками сделки не перемещаются.
Комментарий:
Оплата: {#costMoney#} руб.
Тариф: {#positions#}
Статус: {#payment_status#}
Ссылка: {#paymentLink#}Шорткоды
Нажмите иконку {--} рядом с полем, чтобы увидеть доступные шорткоды.
| Шорткод | Данные |
|---|---|
{#name#} |
Имя контакта |
{#email#} |
|
{#phone#} |
Телефон |
{#webinarId#} |
ID вебинара |
{#city#} |
Город |
{#bil_minut#} |
Был на вебинаре (минут) |
{#costMoney#} |
Сумма заказа |
{#positions#} |
Название тарифа |
{#paymentLink#} |
Ссылка на оплату |
{#payment_status#} |
Статус платежа |
{#payment_number#} |
Номер заказа |
{#utm_source#} |
UTM source |