Uspacy CRM для OpenCart — заказы магазина как сделки и лиды

Uspacy CRM для OpenCart 4.x, 3.x и 2.3 передаёт заказы магазина в Uspacy как сделку или лид: покупатель, телефон, e-mail, сумма, воронка, ответственный, источник и состав заказа в комментарии. Менеджер работает с заказом в CRM, а магазин ничего не вводит второй раз.

Что нужно от Uspacy. Портал Uspacy и пользователь с правами на CRM. Модуль входит в Uspacy так же, как входите вы: адрес портала, e-mail и пароль. Пароль хранится в зашифрованном виде и никуда, кроме Uspacy, не передаётся; лучше завести отдельного пользователя, например «Интернет-магазин».

Что видит менеджер в CRM

Заказ появляется в CRM одной записью. Сделка получает название с номером заказа, сумму заказа, воронку и ответственного; лид — имя, фамилию, телефон в формате +380, e-mail, источник и ответственного. Состав заказа ложится комментарием: товары с опциями и артикулом, скидка, доставка, адрес, способ оплаты, сумма и комментарий покупателя. Покупатель в магазине получает заказ в любом случае: если Uspacy не ответил, заказ остаётся в магазине, а передачу можно повторить.

Что получает админ

Расширения → Модули → Uspacy CRM: вкладки «Подключение», «Сделка или лид», «Автоматически», «Этапы» и «Лицензия». Вписываете адрес портала, e-mail и пароль пользователя Uspacy и нажимаете «Подключить»: модуль входит в Uspacy и читает воронки, этапы, источники и пользователей, которые сразу доступны в полях выбора. Если в аккаунте включён двухфакторный вход, вводится код 2FA; код не сохраняется.

На странице заказа в админке появляется блок Uspacy CRM с кнопкой «Передать в Uspacy»: по настройке это сделка (воронка, сумма, ответственный) или лид (имя, фамилия, телефон, e-mail, источник, ответственный). В блоке виден результат: состояние, номер сделки или лида, этап. Если Uspacy отклонил запрос, в блоке и в истории заказа лежит текст ошибки, а кнопки «Попробовать ещё раз» и «Забыть» под рукой. Перед повтором модуль ищет уже созданную запись по названию среди записей с e-mail или телефоном покупателя, поэтому дубль не появляется даже после оборванной связи.

В Pro на вкладке «Автоматически» включаете передачу каждого нового заказа без кнопки: сразу после оформления или на отмеченных статусах. Если Uspacy не ответил, модуль повторяет передачу до восьми раз, с паузами от 90 секунд до 8 часов, а после ответа о превышении лимита не обращается к CRM 65 секунд. Контакт покупателя модуль ищет по e-mail, затем по телефону, или создаёт новый и привязывает к сделке. Строки заказа и доставка идут в список товаров сделки: товар с тем же артикулом в каталоге CRM привязывается к строке, остальное идёт названием с ценой.

Вкладка «Этапы» сопоставляет статусы в обе стороны. Статус магазина переводит сделку или лид на этап: для каждой воронки и для лидов свой этап, закрывающие этапы имеют успешный или проваленный статус. Этап в CRM ставит заказу статус магазина: модуль узнаёт об изменении из вебхука Uspacy, который добавляется кнопкой «Добавить вебхук в Uspacy», а без вебхука раз в 5 минут проверяет записи за последние 30 дней; покупателю можно отправлять письмо о новом статусе. Несколько воронок распределяются по группе покупателей, иначе по магазину, иначе идёт основная.

Журнал передач (Pro) показывает каждый заказ с номером записи в CRM, этапом и состоянием, с фильтрами «Все», «В очереди», «Не передано» и «В CRM». Здесь же повтор всех непереданных и передача более старых заказов с выбранной даты, до 500 за раз. UTM-метки, с которыми пришёл покупатель, попадают в сделку или лид, даже если заказ передаётся более поздним статусом или вручную.

Как это работает, шаг за шагом

1. Устанавливаете архив для своей версии OpenCart и включаете модуль.
2. На вкладке «Подключение» вписываете адрес портала, e-mail и пароль пользователя Uspacy и нажимаете «Подключить».
3. На вкладке «Сделка или лид» выбираете, что создавать, воронку, ответственного и источник.
4. Открываете заказ в админке и нажимаете «Передать в Uspacy»: в CRM появляется сделка или лид с покупателем и составом заказа.
5. В Pro включаете автоматическую передачу и выбираете статусы, на которых заказы уходят в CRM.
6. В Pro сопоставляете этапы в обе стороны и добавляете вебхук: этап в CRM сам меняет статус заказа.

Что под капотом

• Uspacy API: вход по e-mail и паролю пользователя, токены сессии хранятся в зашифрованном виде; в API Uspacy другого способа входа для собственной интеграции нет, кроме приложения Marketplace.
• Для аккаунта с 2FA после завершения сессии нужен новый код, поэтому для магазина удобнее отдельный пользователь без 2FA.
• Скидка не идёт отдельной строкой в список товаров: сумма строк — это товары с доставкой без скидки; скидка есть в комментарии. Сумма сделки равна сумме заказа.
• Если при добавлении товаров произошла ошибка, список не дозаполняется сам: в записи есть примечание «добавлено N из M», остальное добавляют вручную.
• Карта этапов для лидов одна: воронок лидов API не показывает.
• Статусы в обе стороны работают для записей, созданных модулем; статус применяется в магазине через вебхук, адрес задания по расписанию или планировщик OpenCart 4.
• Каталог CRM для связки товаров читается страницами, до 2000 товаров; поиск по артикулу выполняется в кеше на 6 часов.
• Если ответ Uspacy потерялся, повторный поиск записи идёт по названию среди записей с e-mail или телефоном покупателя; без e-mail и телефона дубль возможен.
• Таблицы журнала и настроек в базе, события OpenCart без правок ядра; при обновлении модуля настройки и лицензия сохраняются.
• Интерфейс на украинском, русском и английском.

Как установить

1. Расширения → Установка: загрузите архив для своей версии без переименования файла (OpenCart 4 — cc_uspacy.ocmod.zip, 3.x — cc_uspacy-oc3.ocmod.zip, 2.3 — cc_uspacy-oc23.ocmod.zip).
2. Для 3.x и 2.3: Расширения → Модификаторы → Обновить.
3. Расширения → Модули → Uspacy CRM: установите и откройте.
4. Впишите адрес портала, e-mail и пароль, нажмите «Подключить» и сохраните настройки.
5. Для Pro: вставьте ключ или запустите пробный период на вкладке «Лицензия».