Настройка
Обновлено
Подключение к CRM
Путь: «Заявки» → «Плагины» → «Заявки в RetailCRM». Эти параметры общие для всех форм.
| Настройка | Что делает | Значения / по умолчанию |
|---|---|---|
| Адрес RetailCRM | Задаёт аккаунт, к API которого обращается плагин | HTTPS-адрес без пути, параметров и фрагмента либо имя аккаунта; по умолчанию пусто. Имя аккаунта преобразуется в https://имя.retailcrm.ru |
| Ключ API | Авторизует запросы к CRM | Ключ с правами из инструкции подключения; по умолчанию пусто |
Пробелы по краям адреса и ключа удаляются. Ключ должен состоять из латинских букв, цифр, _ и -. Адрес с путём /orders/, /api/ или параметрами запроса не подходит.
Кнопка «Проверить подключение» проверяет сразу оба поля и показывает адрес CRM, доступные магазины и право создания заказов. После проверки сохраните настройки отдельно.
В общих настройках показаны адрес CRM, скрытый ключ API и успешный результат проверки подключения.
Правила отдельной формы
Путь: «Заявки» → «Формы» → «Настройки» нужной формы → «RetailCRM». Изменения сохраняются кнопкой «Сохранить».
Передача
| Настройка | Что делает | Значения / по умолчанию |
|---|---|---|
| Передавать заявки этой формы в RetailCRM | Включает интеграцию для формы | Выключено |
| Отправлять сразу при поступлении | Запускает отправку при создании заявки | Выключено. При выключении можно отправлять по выбранным статусам или вручную |
| Передавать товары корзины в комментарии | Добавляет строки от других плагинов через событие request_extra_text, в том числе корзину от «Заказы из заявок» |
Включено. Нужны данные корзины у заявки и плагин, который их предоставляет |
Отправлять при переходе в статус
| Настройка | Что делает | Значения / по умолчанию |
|---|---|---|
| Переключатели с названиями статусов приложения «Заявки» | Отправляют заявку при переходе в любой из отмеченных статусов | Все выключены. Названия берутся из ваших статусов заявок |
Здесь выбирают статусы заявки, а в поле «Статус заказа» ниже — статус создаваемого заказа CRM.
Если «Отправлять сразу при поступлении» выключено, но новая заявка уже создана в одном из отмеченных статусов, она тоже отправится. Если включены оба сценария, успешная передача при создании исключит повторное создание заказа при смене статуса.
Куда
| Настройка | Что делает | Значения / по умолчанию |
|---|---|---|
| Магазин | Выбирает магазин RetailCRM для заказа | Активные магазины, доступные ключу. По умолчанию «Первый доступный магазин» |
| Тип заказа | Передаёт тип создаваемого заказа | Активные типы из CRM. По умолчанию «По умолчанию в CRM» — параметр не передаётся |
| Способ оформления | Передаёт способ оформления заказа | Активные способы из CRM. По умолчанию «По умолчанию в CRM» — параметр не передаётся |
| Статус заказа | Задаёт начальный статус заказа в CRM | Активные статусы из CRM. По умолчанию «По умолчанию в CRM» — параметр не передаётся |
| Менеджер | Назначает выбранного менеджера заказу | Активные пользователи CRM. По умолчанию «Не назначать» — плагин не передаёт менеджера |
| Поле с суммой | Создаёт одну позицию заказа с названием формы и количеством 1 | Поля формы, кроме типов html, step, captcha, file. По умолчанию «Не передавать сумму» |
Справочники CRM кешируются на 300 секунд отдельно для адреса и ключа. Если недавно добавленная запись не появилась, подождите пять минут и заново откройте настройки. При ошибке загрузки проверьте подключение и права ключа.
«По умолчанию в CRM» означает отсутствие параметра в запросе: дальнейшее поведение определяет CRM. Вариант «Не назначать» также не исключает назначения менеджера собственными правилами CRM.
В настройках формы видны переключатели передачи заявки, товаров корзины и отправки при смене статуса.
В форме выбраны магазин, тип, способ оформления и статус заказа, раскрыт список менеджеров.
Примеры сценариев
Сразу при поступлении
Включите «Передавать заявки этой формы в RetailCRM» и «Отправлять сразу при поступлении». Выберите направление заказа в группе «Куда».
После обработки менеджером
Включите передачу формы, выключите «Отправлять сразу при поступлении», отметьте нужные статусы в группе «Отправлять при переходе в статус».
Только вручную
Включите передачу формы, выключите «Отправлять сразу при поступлении» и все переключатели статусов. В карточке заявки будет доступна кнопка «Отправить в RetailCRM» при заполненном подключении.
Как передаётся сумма
Например, значение 12 500,50 ₽ превращается в цену 12500.50. Плагин удаляет пробелы и обозначение валюты, заменяет запятую на точку и округляет число до двух знаков. Ноль допустим. Пустое, нечисловое или отрицательное значение не создаёт позицию заказа.
Выбор поля с суммой не превращает товары корзины в позиции заказа: корзина передаётся текстом в комментарии.