К содержимому
Начало работы

Установка и первые шаги

Обновлено

Установите плагин

Убедитесь, что сервер и приложение соответствуют требованиям. Установите «Заявки в RetailCRM» из маркета Webasyst в вашу установку через «Инсталлер».

Подключение и справочники плагина доступны администратору приложения «Заявки». Он же видит вкладку «RetailCRM» в настройках формы.

Подготовьте ключ API

В RetailCRM откройте «Настройки» → «Интеграция» → «Ключи доступа к API». Создайте ключ с правами:

Право Для чего нужно плагину
order_read Найти заказ предыдущей попытки и прочитать клиента созданного заказа
order_write Создать заказ
customer_read Найти клиента и проверить сохранённую связь
reference_read Загрузить магазины, типы, способы оформления и статусы заказов
user_read Загрузить активных менеджеров

Предоставьте ключу доступ к магазинам, в которые должны поступать заявки.

Подключите аккаунт

  1. В приложении «Заявки» откройте «Плагины» → «Заявки в RetailCRM».
  2. Заполните «Адрес RetailCRM»: HTTPS-адрес аккаунта без дополнительных путей или только имя аккаунта.
  3. Введите «Ключ API».
  4. Нажмите «Проверить подключение».
  5. Проверьте сообщение «RetailCRM отвечает», список «Доступные магазины» и строку «Создание заказов».
  6. Сохраните настройки плагина.

Проверка использует введённые значения, в том числе ещё не сохранённые. Она не сохраняет подключение и не создаёт заказ. Сообщение «RetailCRM отвечает» само по себе не означает наличия права создания: в строке «Создание заказов» должно быть «разрешено».

Включите передачу для формы

  1. Откройте «Заявки» → «Формы», у нужной формы — «Настройки», затем вкладку «RetailCRM».
  2. Включите «Передавать заявки этой формы в RetailCRM».
  3. Для первой проверки оставьте «Отправлять сразу при поступлении» выключенным и не выбирайте статусы автоматической отправки.
  4. В группе «Куда» выберите нужный «Магазин». Остальные параметры задайте по задаче или оставьте стандартными.
  5. Нажмите «Сохранить».

После сохранения подключения списки на вкладке формы загружаются из CRM. Все параметры описаны в статье о настройке.

Проверьте первый заказ

Отправьте тестовую заявку через форму сайта. Откройте её карточку в «Заявках» и в блоке «RetailCRM» нажмите «Отправить в RetailCRM». Эта проверка создаёт настоящий заказ в выбранном магазине CRM.

При успехе появятся «Заказ №… создан», время «Отправлено» и ссылка «Открыть в RetailCRM». Номер в сообщении соответствует ID заказа RetailCRM. Если известен клиент заказа, блок также покажет «Клиент в CRM».

Откройте заказ и проверьте магазин, контактные данные и комментарий с полями заявки. Если настроены сумма, тип, способ оформления, статус или менеджер, проверьте их тоже.

При ошибке карточка покажет «Не отправлено: …» и кнопку «Повторить». Устраните указанную причину и повторите отправку.

После успешной проверки включите нужный автоматический сценарий. Уже переданная заявка повторно не выгружается при последующих переключениях статуса.