Интеграция RetailCRM
Вкладка «RetailCRM» в настройках AMARIX — URL аккаунта, API-ключ, код сайта, catalogId и интервал опроса
Вкладка RetailCRM в Настройки (/settings?tab=retailcrm) связывает AMARIX с облачной CRM для брендов, где менеджеры ведут сделки, сегменты и историю клиента. Обмен данными идёт по API: заказы и каталог могут синхронизироваться между системами при корректных ключах.
Внимание: API-КЛЮЧ RetailCRM — секретный. Не передавайте его подрядчикам в открытом виде; выдавайте отдельные ключи с минимальными правами в кабинете RetailCRM. При утечке ключ немедленно перевыпустите.
Как открыть
- Откройте Система → Настройки (
/settings). - Перейдите на вкладку RetailCRM.
- Заполните поля подключения.
- Нажмите Сохранить.
- При необходимости используйте Выгрузить каталог (кнопка на вкладке) для отправки текущего каталога в CRM — точное название кнопки зависит от вашего бренда в панели.
Поля формы
| Поле | Пример / описание |
|---|---|
| URL АККАУНТА | Адрес вашего инстанса, например https://your-shop.retailcrm.ru |
| API-КЛЮЧ | Ключ API из RetailCRM (Настройки → Интеграция → Ключи API) |
| КОД САЙТА (SITE) | Код магазина в RetailCRM, например ammo |
| ID КАТАЛОГА (CATALOGID) | Числовой идентификатор каталога в CRM, например 1 |
| Интервал опроса (мин) | Как часто AMARIX опрашивает RetailCRM (в минутах) |
Значения КОД САТА (SITE) и ID КАТАЛОГА (CATALOGID) должны совпадать с созданным магазином и каталогом в RetailCRM — иначе заказы попадут не туда или каталог не сопоставится.
Пошаговое подключение
- В RetailCRM создайте магазин (site) под канал AMARIX и каталог товаров.
- Сгенерируйте API-КЛЮЧ с правами на заказы и каталог.
- Скопируйте URL АККАУНТА без лишнего слэша в конце.
- В AMARIX вставьте ключ в API-КЛЮЧ, укажите КОД САЙТА (SITE) и ID КАТАЛОГА (CATALOGID).
- Задайте Интервал опроса (мин) — 5–15 минут типично для операционки; слишком частый опрос создаёт лишнюю нагрузку.
- Нажмите Сохранить и проверьте тестовый заказ в обеих системах.
Когда RetailCRM нужен
RetailCRM оправдан, если:
- менеджеры обрабатывают сложные сделки вручную;
- уже настроены воронки, сегменты и скрипты в CRM;
- нужна единая история клиента для телефона и мессенджеров.
Если основной поток — self-service через Telegram и сайт, часто достаточно Продажи → Заказы в AMARIX без дублирования статусов.
Связь с заказами AMARIX
Заказы из витрины должны появляться в RetailCRM с тем же составом и суммой. Статусы меняйте по согласованному правилу: либо мастер-система — AMARIX, либо CRM — иначе «доставлен» и «отменён» разъедутся. Уведомления команде можно дублировать через Telegram.
Типичные ошибки
| Проблема | Решение |
|---|---|
| 401 / доступ запрещён | Проверьте API-КЛЮЧ и права ключа |
| Заказы не приходят | КОД САЙТА (SITE) и URL аккаунта |
| Товары не сопоставляются | ID КАТАЛОГА (CATALOGID) и выгрузка каталога |
При смене ключа обновите API-КЛЮЧ в AMARIX в день ротации — старый ключ перестанет работать сразу после отзыва в RetailCRM.