Настройка
Обновлено
Подключение для всей установки
Путь: «Заявки» → «Плагины» → «Заявки в Битрикс24».
| Настройка | Что делает | Значения / по умолчанию |
|---|---|---|
| Адрес вебхука Битрикс24 | Подключает сайт к порталу; общий для всех форм | Полный адрес входящего вебхука; по умолчанию пусто |
Кнопка «Проверить подключение» проверяет адрес из поля, даже если он ещё не сохранён. После проверки сохраните настройки.
Настройки формы: «Передача»
Путь: «Заявки» → «Формы» → настройки нужной формы → «Битрикс24». Вкладка доступна администратору приложения.
| Настройка | Что делает | Значения / по умолчанию |
|---|---|---|
| Передавать заявки этой формы в Битрикс24 | Включает передачу и блок ручной отправки для заявок формы | Выключено |
| Что создавать | Выбирает тип записи в CRM | «Лид» или «Сделку с контактом»; по умолчанию «Лид» |
| Отправлять сразу при поступлении | Запускает отправку при создании заявки | Выключено |
| Передавать товары корзины в комментарии | Добавляет текст корзины от плагина «Заказы из заявок» и дополнительный текст через событие приложения | Включено; без источника дополнительного текста добавлять нечего |
| Создавать контакт для сделки, если на портале его нет | Разрешает создать контакт, если поиск не дал результата | Включено; применяется к сделкам, лид новый контакт не создаёт |
Название варианта «Сделку с контактом» не гарантирует наличие контакта: сделка может создаться без него, если создание выключено, нет имени, телефона и email либо обнаружен конфликт контактов.
«Отправлять при переходе в статус»
| Настройка | Что делает | Значения / по умолчанию |
|---|---|---|
| Переключатель с названием каждого статуса приложения | Отправляет заявку при переходе в этот статус | Все выключены; подписи соответствуют реальным названиям статусов в вашей установке |
Создание заявки сразу в отмеченном статусе тоже запускает отправку. Исключение при создании — заявки с отключёнными уведомлениями (skip_notifications, например при переносе или импорте): автоматически они не отправляются.
Можно одновременно включить отправку при поступлении и по статусам. Успешно отправленная заявка повторно не создаётся. Если автоматические способы выключены, остаётся ручная отправка.
Выключение передачи формы останавливает автоматические срабатывания. Блок заявки с уже зарегистрированной попыткой сохраняется: ошибку такой отправки можно повторить вручную и после выключения передачи формы.
Показаны переключатели передачи и отправки при поступлении и переходе в статус.
Настройки формы: «Куда»
| Настройка | Что делает | Значения / по умолчанию |
|---|---|---|
| Воронка сделки | Выбирает воронку для сделки | Список с портала; по умолчанию «Общая воронка портала» |
| Стадия сделки | Задаёт стадию сделки; список зависит от воронки | Список с портала; по умолчанию «Первая стадия воронки» |
| Статус лида | Задаёт статус создаваемого лида | Список с портала; по умолчанию «Первый статус лида» |
| Источник | Устанавливает источник лида или сделки; также передаётся новому контакту | Список с портала; по умолчанию «Веб-сайт (WEB)» |
| Ответственный | Назначает ответственного за запись; также передаётся новому контакту | Активные сотрудники портала; по умолчанию «Владелец вебхука» |
| Название | Шаблон названия лида или сделки | Пустое поле использует {form_name} №{request_id} |
| Поле с суммой | Берёт сумму из выбранного поля формы | По умолчанию «Не передавать сумму»; HTML, шаги, CAPTCHA и файлы не предлагаются |
| Валюта суммы | Указывает валюту передаваемой суммы | Список с портала; по умолчанию «Основная валюта портала»; нужна при передаче суммы |
Параметры сделки используются только для сделки, статус лида — только для лида. Списки портала загружаются по сохранённому адресу вебхука. Справочники кешируются на 5 минут; список ответственных ограничен первыми 200 активными сотрудниками.
Показаны выбор ответственного, шаблон названия и поле с суммой.
Шаблон названия
Поддерживаются только подстановки:
| Подстановка | Значение |
|---|---|
{form_name} |
Название формы |
{request_id} |
Номер заявки |
{name} |
Имя клиента |
{phone} |
Телефон клиента |
{email} |
Email клиента |
Например, в поле «Название» можно указать:
{form_name} №{request_id} — {name}Это текстовый шаблон, а не Smarty. Итоговое название ограничивается 255 символами.
Сумма и валюта
Значение 12 500,50 ₽ преобразуется в 12500.5. Сумма округляется до двух знаков после запятой. Отрицательное или не распознанное как число значение не передаётся.
Выбор валюты не пересчитывает сумму. Если валюта не выбрана, плагин запрашивает основную валюту портала. Если прочитать её не удалось, валюта не передаётся — значение определяет портал.