К содержимому
5 мин чтения

RetailCRM интеграция с сайтом: что передавать и как настроить

RetailCRM интеграция с сайтом нужна, чтобы заказы, заявки и клиенты попадали в систему сами, без переписывания из почты и мессенджеров. Для интернет-магазина в Узбекистане это обычно заказ из корзины, обратный звонок и обращение из Telegram. Ниже разберём, что именно передавать, как подготовить RetailCRM и по шагам настроить обмен, какие ошибки встречаются чаще всего и из чего складывается стоимость работ.

RetailCRM интеграция: что с чем связывается

Обмен идёт в две стороны. Сайт отправляет в RetailCRM новые заказы и клиентов, а RetailCRM возвращает на сайт статусы заказов, остатки и, при необходимости, данные клиента для личного кабинета. Технически это работа через API RetailCRM по ключу доступа плюс файл выгрузки каталога.

Есть три варианта реализации. Готовый модуль для вашей CMS, если он существует и его возможностей хватает. Собственный обработчик на стороне сайта, который шлёт запросы напрямую. Промежуточный сервис, когда источников несколько: сайт, Telegram-бот, лендинг. Для магазина с одной корзиной хватает первого или второго, для нескольких каналов удобнее третий.

Выбирайте по числу каналов и по тому, как часто меняется логика заказа. Если акции, доставка и оплата у вас меняются каждый месяц, модуль с жёсткими настройками станет помехой.

Какие данные передавать из сайта

Минимум для заказа: номер заказа на сайте, дата, имя, телефон, состав (товар, количество, цена), способ доставки, способ оплаты, адрес и комментарий. Телефон приводите к одному формату, например +998 и девять цифр, иначе один и тот же клиент превратится в несколько карточек.

Дополнительно передавайте источник: UTM-метки, страницу входа, тип обращения. Без них вы не поймёте, какая реклама приносит заказы, а менеджер не увидит, с чего начинать разговор. Для этого в RetailCRM заводятся пользовательские поля заказа.

Из RetailCRM на сайт полезно возвращать статус заказа, номер отправления и остатки по складам. Данные банковских карт передавать не нужно: через Payme или Click проходит только факт оплаты и сумма.

Подготовка и шаги настройки

До написания кода сверьте справочники. В RetailCRM есть типы заказа, способы доставки и оплаты, статусы, магазины (сайты) и склады, и у каждого значения есть символьный код. Сайт должен отправлять именно эти коды, а не собственные названия вроде «Самовывоз из офиса».

Затем создайте ключ API с минимально нужными правами: создание и чтение заказов и клиентов, чтение справочников. Ключ с полным доступом в коде сайта — лишний риск, храните его в переменных окружения, а не в репозитории. Каталог загружается файлом ICML, поэтому заранее решите, что считать идентификатором товара — артикул или внутренний код, и не меняйте его потом.

Порядок такой. Шаг 1: создайте в RetailCRM магазин с кодом сайта и заведите справочники. Шаг 2: выгрузите каталог в ICML и проверьте, что товары загрузились без дублей. Шаг 3: настройте отправку заказа, при оформлении сайт формирует запрос с клиентом, составом и внешним идентификатором заказа. Шаг 4: добавьте проверку дубликатов, сначала ищите клиента по телефону, потом создавайте.

Шаг 5: настройте возврат статусов, RetailCRM сообщает об изменении через триггер, либо сайт периодически запрашивает историю изменений. Шаг 6: создайте для менеджеров автоматические задачи, например перезвонить в заданный срок. Шаг 7: проведите тестовые заказы на отдельном тестовом магазине: с доставкой и без, с оплатой и без, с именем и адресом на русском и на узбекском.

Типичные ошибки и что проверить перед запуском

Первая ошибка — дубли клиентов из-за разных форматов телефона. Вторая — отправка заказа без внешнего идентификатора: при повторной отправке после сбоя получится два заказа. Третья — потеря заказа, когда RetailCRM временно недоступна, а сайт не повторяет запрос.

Четвёртая — кириллица и узбекская латиница с апострофами в названиях и адресах: проверьте кодировку и то, что o‘ и g‘ не превращаются в странные символы. Пятая — статусы: клиент на сайте видит внутренние названия, которые ему непонятны.

Чек-лист перед запуском: заказ создаётся один раз; телефон нормализован; состав и сумма совпадают; статус возвращается на сайт; при недоступности CRM заказ попадает в очередь и уходит позже; ошибки пишутся в журнал, о котором узнаёт ответственный человек.

Сроки и из чего складывается цена

Ориентир по срокам: подключение готового модуля с настройкой справочников занимает несколько дней, собственный обработчик с возвратом статусов и остатков — от двух до четырёх недель вместе с тестами. Сроки растут, если на стороне заказчика не готовы справочники и каталог.

Цена складывается из числа каналов, объёма данных, двусторонности обмена, нестандартной логики доставки и оплаты, тестирования и сопровождения. Ориентир по рынку Узбекистана: простая односторонняя передача заказов — примерно 1 500 000–4 000 000 сум, полноценный двусторонний обмен с остатками и статусами — примерно 5 000 000–15 000 000 сум. Это не оферта, а диапазон для сравнения предложений.

Частые вопросы

Нужен ли программист, если сайт сделан на конструкторе? Часто да: у конструкторов ограничены исходящие запросы, но обычно можно подключить промежуточный сервис, который получает заказы по вебхуку и передаёт их в RetailCRM.

Можно ли передавать обращения из Telegram-бота в ту же RetailCRM? Да. Если бот создаёт заказ или обращение с теми же кодами и тем же форматом телефона, клиент не раздвоится.

Что делать с уже накопленной базой? Сначала очистите её: объедините дубли и приведите телефоны к одному формату, затем загружайте. Загрузка грязной базы переносит проблемы в новую систему.

Хватит ли одного ключа API на все системы? Лучше выдать отдельный ключ каждой системе: сайту, боту, лендингу. Если один ключ утечёт, вы отзовёте только его.

С чего начать

Начните с аудита: выпишите каналы, откуда приходят заказы, справочники и всё, что менеджеры сегодня переписывают вручную. Из этого списка получается техзадание на обмен, и по нему можно сравнивать предложения исполнителей.

Если обращения приходят и с сайта, и из Telegram, 4 Digital делает Telegram-ботов и ИИ-ассистентов, которые передают обращения в вашу CRM в нужном формате, — от 999 000 сум. Итоговая цена зависит от числа сценариев и объёма интеграции.

Нужен сайт или реклама? Обсудим ваш проект.

ИИ чат-бот · от 999000 сум

Ответим за 15 минут в рабочее время. Без спама.