Интеграция открывает клиентскую базу и заказы интернет-магазина мессенджерам. Клиент спрашивает в чате «где мой заказ?», AI-ассистент находит заказ в RetailCRM по телефону и отвечает статусом. Оператор создаёт заказ из диалога, не переключаясь в CRM.
Подключение по API-ключу RetailCRM с нужными правами, через REST API v5.
#Что синхронизируется
| Данные RetailCRM | Чтение | Запись |
|---|---|---|
| Клиенты | Список с пагинацией, поиск по имени, телефону и email | Создание: фамилия, имя, отчество, email, телефон, внешний ID, теги |
| Заказы | Список с фильтрами, статус заказа | Создание: клиент, товары, доставка, адрес, комментарий |
| Статусы заказов | Справочник reference/statuses | Нет |
| Типы доставки | Справочник reference/delivery-types | Нет |
| Сайты (магазины) | Справочник reference/sites | Заказ привязывается к магазину из поля «Код сайта» |
#Что нужно на стороне RetailCRM
- Адрес вашего инстанса, например
https://myshop.retailcrm.ru. - API-ключ с правами: клиенты (чтение и запись), заказы (чтение и запись), справочники (чтение).
- Код сайта, если в RetailCRM несколько магазинов и заказы должны попадать в конкретный.
#Как подключить
API URL вашей CRM.
API Key.
Код сайта, если магазинов несколько.
Кнопка подключения.
Откройте RetailCRM → «Настройки» → «Интеграция» → «API-ключи» и нажмите «Добавить».
Задайте имя ключа, например «tuk-tuk.online», отметьте права на клиентов, заказы и справочники, сохраните и скопируйте ключ.
Откройте раздел Интеграции, выберите RetailCRM и нажмите «Подключить»: появится форма с тремя полями.
Заполните «API URL» (адрес инстанса без завершающего слэша), «API Key» и при необходимости «Код сайта (опционально)», например
main.Нажмите «Подключить»: платформа вызовет
GET /api/v5/credentialsи при успехе отметит карточку «Интеграция подключена». При неверном ключе форма покажет «Неверный API ключ RetailCRM».
#Проверить, что работает
- Нажмите «Управлять» и откройте страницу RetailCRM в кабинете: во вкладке клиентов загрузится список из CRM, работает «Поиск по имени».
- Создайте тестового клиента в форме: он появится в RetailCRM с указанными тегами.
- Создайте тестовый заказ (имя, фамилия, телефон, email, товар, адрес доставки, комментарий): заказ появится в RetailCRM в магазине из поля «Код сайта».
#Что происходит после подключения
| Действие | Вызов RetailCRM |
|---|---|
| Список и поиск клиентов | GET /api/v5/customers?apiKey=... |
| Список заказов и статус заказа | GET /api/v5/orders?apiKey=... |
| Справочники | GET /api/v5/reference/statuses, reference/delivery-types, reference/sites |
| Создание клиента | POST /api/v5/customers/create |
| Создание заказа | POST /api/v5/orders/create (поле site берётся из «Код сайта») |
GET-запросы передают apiKey в query-параметре, POST-запросы отправляют данные формой (application/x-www-form-urlencoded).
#Ограничения
- Используется REST API v5 RetailCRM.
- Права ключа определяют доступ: без права на запись заказов заказ не создастся.
- Одна интеграция = один инстанс RetailCRM; для второго магазина в том же инстансе используйте «Код сайта».
- Двусторонней переписки внутри RetailCRM нет: сообщения остаются в tuk-tuk.online, в CRM уходят клиенты и заказы.
#Частые проблемы
| Проблема | Что делать |
|---|---|
| Клиенты не загружаются | Проверьте, что у ключа есть право на чтение клиентов |
| Заказ не создаётся | Заполните обязательные поля: клиент (телефон или email) и хотя бы один товар |
| Ошибка 403 | У ключа нет нужных прав: создайте новый ключ с правами на клиентов, заказы и справочники |
| «Не удалось подключиться» | Сверьте «API URL»: адрес инстанса без пути и без завершающего слэша, например https://myshop.retailcrm.ru |
| Заказ попал не в тот магазин | Укажите код нужного магазина в поле «Код сайта» (справочник reference/sites) |