Оформление
Bitrix24
В меню: Настройки → Интеграции → Bitrix24.
Bitrix24 — источник лидов, сделок и справочников для целей Sales Ninja. Интеграция читает CRM по входящему webhook; цели после подключения создаются вручную.
Уровни интеграции
| Уровень | Доступно | Где настраивается |
|---|---|---|
| Project | ✅ | Настройки → Интеграции → Bitrix24 |
| JS-действие | — | — |
Зачем подключать
- Передавать в Sales Ninja реальные лиды и сделки из Bitrix24.
- Строить цели по стадиям / воронкам и использовать их в моделируемых конверсиях.
Подготовьте доступ
- В Bitrix24 откройте «Разработчикам → Другое → Входящий вебхук». Если раздел недоступен, попросите администратора создать вебхук.
- В правах вебхука выберите CRM (crm). Сотрудник, создавший вебхук, должен иметь право читать сделки; для целей по лидам — также лиды. Права вебхука не расширяют права сотрудника.
- Скопируйте адрес входящего вебхука целиком: адрес портала, /rest/, номер сотрудника и секрет. Отдельные права «Пользователи» для проверки профиля не нужны.
Данные подключения
Откройте Настройки проекта → Интеграции → Добавить, выберите сервис и задайте понятное название подключения.
| Поле | Что вставить |
|---|---|
| URL входящего webhook | Например: https://ваш-портал.bitrix24.ru/rest/1/секрет/ — без имени метода в конце. |
Нажмите Сохранить. При редактировании оставьте скрытый сохранённый секрет без изменений, если не хотите заменить его.
После сохранения
При сохранении проверяем адрес вебхука и доступ к чтению сделок. Затем в карточке подключения обновите справочники и создайте цель Bitrix24: выберите лиды или сделки и нужные стадии. Для связи с посещениями настройте передачу идентификаторов с сайта в CRM — само подключение их не заполняет.
Если подключение не работает
При отказе доступа проверьте право CRM и права сотрудника на сделки. Если справочники пусты, обновите их после изменения прав. Если сделки есть, а конверсий нет, проверьте выбранные стадии и заполнение полей связи с посещениями.
Инструкции сервиса
Цель Bitrix24
- Откройте Данные → Цели → Создать → Звонки и CRM → Bitrix24 и выберите подключение.
- Выберите сущность: Лид или Сделка. Для сделок доступны воронки; для лидов фильтр воронок не используется.
- Выберите стадии, которые означают ваше бизнес-событие. Несколько равнозначных стадий можно учитывать одной целью. Для разных этапов, например квалификации и оплаты, создайте отдельные цели.
- Настройте выручку: Сумма сделки или Не передавать. Если в CRM есть готовая прибыль, выберите числовое или денежное поле в Прибыль. Выручка и прибыль должны быть в одной валюте; прибыль может содержать убыток.
- Укажите CRM-поля для yclid и Yandex Client ID. Поля лидов и сделок выбираются отдельно для выбранной сущности. Проверьте автоматически предложенные поля: похожее название не доказывает, что сайт их заполняет.
- При необходимости укажите поля UTM Source, Medium, Campaign, Term и Content. UTM помогают сопоставлению, но не заменяют точные идентификаторы во всех случаях.
- Запустите Быструю проверку. Проверьте не только найденные записи, но и заполненность идентификаторов, результат сопоставления и подсказки Готовность настройки.
- Сохраните, дождитесь синхронизации и откройте конверсии цели. Сверьте выбранные стадии и суммы с реальными записями CRM. Только после этого используйте цель в моделируемой конверсии или другом продукте.
Если сайт передаёт поля только в лид, а цель настроена на сделки, проверьте перенос этих значений при преобразовании лида в сделку. Проверка формы не заполняет CRM-поля за вас и не доказывает сопоставление всех будущих записей.
Общие настройки: выручка и прибыль. Общий маршрут: от интеграции к цели.
Ограничения и типичные ошибки
| Симптом | Что проверить |
|---|---|
| Ошибка авторизации | URL webhook, права на чтение CRM |
| Каталог пустой / неполный | «Синхронизировать каталог»; после новых UF-полей — обновить снова |
| Сделки есть, матча нет | Заполненность yclid / Client ID в карточках; маппинг полей в цели |
| «Готовность» на форме красная | Подсказки блока «Готовность настройки» и результат быстрой проверки |