Документация по виджетам и интеграциям Ибице, а также видеоматериалы, которые помогут настроить всё самостоятельно.
Начало работы
Введение
Ибице — интегратор amoCRM и Битрикс24. Мы делаем готовые виджеты и индивидуальные интеграции, которые закрывают рутину внутри карточки сделки.
Здесь собраны инструкции по подключению и настройке всех продуктов. Если вы только начинаете, пройдите разделы по порядку: на каждый уходит несколько минут.
Для кого эти материалы
руководители, которые выбирают решение для отдела продаж;
администраторы CRM, которые подключают и настраивают виджеты;
разработчики, которым нужно связать CRM с интернет-магазином или складом.
Видеообзор
Короткий ролик о том, как устроена работа с виджетами. Это демонстрационное видео, позже здесь появится наш собственный обзор.
Установка виджета занимает около двух минут и не требует помощи разработчика.
Перед началом
Вам понадобится доступ администратора в аккаунт amoCRM и активная подписка на нужный виджет. Тестовый период зависит от продукта и всегда указан в его карточке: он может быть от 14 до 30 дней.
Во время теста доступны все функции виджета. Данные сохраняются и после оформления подписки.
Установка
Откройте каталог виджетов amoМАРКЕТ. Найдите виджет по названию. Или установите его одним кликом по кнопке в нашем каталоге.
Нажмите «Установить». Подтвердите доступы, которые запрашивает виджет.
Сохраните настройки. После установки виджета не забудьте нажать на кнопку «Сохранить» в нижней части описания. Виджет сразу появится в карточке сделки, в разделе «Настройки» или «Аналитика» (зависит от продукта, конкретное место встраивания смотрите в описании продукта).
Проверка работы
Откройте любую сделку и убедитесь, что блок виджета отображается в ожидаемом месте встраивания. Если блока нет, обновите страницу, проверьте, что виджет включён в настройках, и ещё раз нажмите кнопку «Сохранить» в нижней части карточки виджета в amoМАРКЕТ, прямо под описанием.
Интеграции
MyInSales (InSales — amoCRM)
Инструкция по установке виджета MyInSales в amoCRM и подключению интернет-магазина на InSales. Описание самого приложения: MyInSales.
Видеотур по функционалу
Видео расскажет, как примерно за 10 минут настроить интеграцию между интернет-магазином на платформе InSales и amoCRM. В нём рассмотрены:
подключение и первичная настройка интеграции;
активация товарного каталога amoCRM и первичная выгрузка товаров из InSales;
настройка синхронизации статусов как из InSales в amoCRM, так и в обратном направлении;
редактирование состава заказа прямо из amoCRM и синхронизация внесённых изменений.
Установка виджета и подключение интеграции к InSales
Установить виджет для amoCRM просто: найдите его в маркетплейсе amoCRM и нажмите кнопку установки.
После установки обязательно нажмите кнопку «Сохранить» в окне виджета в маркетплейсе amoCRM. Без этого виджет будет установлен, но его элементы управления не появятся ни на странице сделки, ни в настройках amoCRM.
Подключение новых магазинов и управление всеми настройками интеграции происходит в настройках amoCRM: нажмите в левом меню значок настроек и выберите в списке «Настройки InSales».
Для добавления нового магазина понадобятся реквизиты доступа к его API: домен интернет-магазина (технический или публичный), логин и ключ доступа к API. Их можно получить в бэк-офисе InSales: нажмите «Приложения» в левом нижнем углу, затем «Разработчикам».
В панели настроек InSales откройте раздел «Магазины», нажмите «Добавить магазин» и заполните форму реквизитами доступа к REST API подключаемого магазина:
Домен магазина
Технический или публичный домен интернет-магазина.
Логин API-доступа
Логин из раздела «Разработчикам» в бэк-офисе InSales.
Пароль API-доступа
Пароль (ключ) доступа к API из того же раздела.
Общие настройки интеграции
На странице «Общие настройки» можно указать, в каком статусе создавать новые заказы в amoCRM, кто будет ответственным за создаваемые сделки и контакты, и определить другие параметры работы интеграции.
Здесь же указывается информация о создаваемой задаче, если вы хотите, чтобы при регистрации нового заказа в InSales вместе со сделкой автоматически создавалась задача на ответственного.
В этом блоке настраивается и приём UTM-меток по новым заказам с передачей их в amoCRM.
Работа с товарами в amoCRM
Работа с товарами реализована двумя дополнительными услугами с разным назначением. Любую из них можно отключить, если эта функциональность не нужна в ваших бизнес-процессах.
Синхронизация товарного каталога
Создаёт карточки товаров в товарном каталоге amoCRM и привязывает их ко всем создаваемым сделкам и запросам обратного звонка.
В этом режиме легко интегрироваться с любым интернет-эквайрингом или виджетом выставления счетов, а также вести статистику продаж по отдельным товарам и группам товаров.
Через стандартные поля карточки товара (наименование, стоимость, артикул и описание) можно передавать и другие значения из карточки товара в InSales.
Данные в карточках товаров обновляются раз в сутки, если они изменились в InSales.
Синхронизация состава заказа
Включает мастер редактирования состава заказа: через JS-виджет можно изменять состав заказа в любой сделке, созданной на основании заказа в InSales. Услуга позволяет добавлять в заказ новые товары, удалять существующие и менять количество.
Если не активна ни одна из услуг, список товаров из заказа передаётся в сделку примечанием и в любой момент доступен через мастер редактирования состава заказа, но без возможности правок. Данные в окне мастера всегда актуальны: они запрашиваются из InSales по API в реальном времени в момент открытия.
Синхронизация статусов
Интеграция поддерживает синхронизацию статусов между заказами в InSales и соответствующими сделками в amoCRM. Дополнительные услуги для этого подключать не нужно: функция входит в базовый пакет.
Сопоставьте статусы. Откройте одноимённый пункт настроек интеграции и установите соответствие между статусами, которые нужно синхронизировать.
Проверьте направление InSales → amoCRM. Оно заработает сразу после настройки соответствия статусов.
Настройте обратное направление amoCRM → InSales. Откройте настройки цифровой воронки amoCRM и добавьте вебхук виджета InSales к тем стадиям, при попадании сделки в которые нужно передавать изменение статуса в InSales. Для этого введите «MyInSales» в поле поиска вверху окна создания нового действия цифровой воронки и выберите наш виджет в результатах.
Установка виджета и подключение интеграции к CS-Cart
Установить виджет для amoCRM просто: найдите его в маркетплейсе amoCRM и нажмите кнопку установки.
После установки обязательно нажмите кнопку «Сохранить» в окне виджета в маркетплейсе amoCRM. Без этого виджет будет установлен, но его элементы управления не появятся ни на странице сделки, ни в настройках amoCRM.
Подключение новых магазинов и управление всеми настройками интеграции происходит в настройках amoCRM: нажмите в левом меню значок настроек и выберите в списке «Настройки CS-Cart».
Для добавления нового магазина понадобятся реквизиты доступа к его API: API URL, e-mail пользователя, от имени которого интеграция будет работать в магазине, и ключ доступа к API. В панели настроек CS-Cart откройте раздел «Магазины», нажмите «Добавить магазин» и заполните форму реквизитами доступа к REST API подключаемого магазина:
API URL
Обычно адрес выглядит так: https://yourdomain.com/api.php?_d=
E-mail пользователя
Адрес электронной почты, который используется как логин пользователя, от имени которого настраивается интеграция.
API-ключ
Ключ генерируется в CS-Cart при редактировании профиля пользователя, от имени которого будет работать интеграция. На вкладке «API-доступ» включите для пользователя доступ по API и сгенерируйте ключ соответствующей кнопкой.
После генерации нового API-ключа обязательно нажмите кнопку сохранения в режиме редактирования профиля пользователя в CS-Cart. Иначе ключ не вступит в силу, и доступ по нему не будет работать.
После успешного подключения система автоматически добавит магазин к интеграции или сообщит об ошибке, если что-то пошло не так.
Модуль для интернет-магазина
Как только магазин добавлен в настройки интеграции, становится доступна генерация модуля для него. Модуль нужен, чтобы интеграция в реальном времени получала информацию о новых заказах, изменении состава и статуса существующих заказов, а также фиксировала запросы обратного звонка. Сгенерировать дистрибутив можно кнопкой «Сгенерировать модуль». Готовый дистрибутив не требует настройки: его достаточно загрузить в CS-Cart встроенным инструментом импорта модулей в административной зоне.
Дистрибутив поставляется в двух вариантах:
Стандартный модуль
Работает во всех интернет-магазинах на платформе CS-Cart без исключения, поскольку не содержит сложного функционала: только отправку webhook-оповещений о регистрации новых заказов в реальном времени (то есть в момент регистрации заказа или оформления заявки на обратный звонок).
Многопоточный модуль
Помогает, если магазин находится в сети с низкой скоростью соединения и (или) большими потерями пакетов. В этой версии модуль отправляет оповещения не сразу, а собирает их в очередь и повторяет попытки, пока интеграция не примет оповещение. Используйте его только при проблемах со своевременной обработкой событий или если оповещения по некоторым событиям не доходят вовсе.
Встроенное окно диагностики внутри модуля для CS-Cart позволяет в любой момент проверить статус работы интеграции и корректность настроек, убедиться, что подписка активна, и узнать срок её действия.
Общие настройки интеграции
На странице «Общие настройки» можно указать, в каком статусе создавать новые заказы в amoCRM, кто будет ответственным за создаваемые сделки и контакты, и определить другие параметры работы интеграции.
Здесь же указывается информация о создаваемой задаче, если вы хотите, чтобы при регистрации нового заказа в CS-Cart вместе со сделкой автоматически создавалась задача на ответственного.
В этом блоке настраивается и приём UTM-меток по новым заказам и запросам обратного звонка с передачей их в amoCRM.
Чтобы UTM-метки фиксировались, магазин должен записывать их в cookies пользователя. Если эта механика у вас не реализована, мы рекомендуем использовать JS-библиотеку SourceBuster: она собирает всю нужную информацию и передаёт её в cookies в едином формате. Для её пользователей есть отдельный пункт настроек «На сайте используется SourceBuster.js (активировать пресет)»: включите его и укажите дополнительные поля сделки, в которые нужно записывать UTM-метки. Иначе рядом со списком полей сделки нужно указать имя cookie, в котором передаётся каждая метка.
Работа с товарами в amoCRM
Работа с товарами реализована двумя дополнительными услугами с разным назначением. Любую из них можно отключить, если эта функциональность не нужна в ваших бизнес-процессах.
Синхронизация товарного каталога
Создаёт карточки товаров в товарном каталоге amoCRM и привязывает их ко всем создаваемым сделкам и запросам обратного звонка.
В этом режиме легко интегрироваться с любым интернет-эквайрингом или виджетом выставления счетов, а также вести статистику продаж по отдельным товарам и группам товаров.
Через стандартные поля карточки товара (наименование, стоимость, артикул и описание) можно передавать и другие значения из карточки товара в CS-Cart.
Данные в карточках товаров обновляются раз в сутки, если они изменились в CS-Cart.
Синхронизация состава заказа
Включает мастер редактирования состава заказа: через JS-виджет можно изменять состав заказа в любой сделке, созданной на основании заказа в CS-Cart. Услуга позволяет добавлять в заказ новые товары, удалять существующие и менять количество.
Если не активна ни одна из услуг, список товаров из заказа передаётся в сделку примечанием и в любой момент доступен через мастер редактирования состава заказа, но без возможности правок. Данные в окне мастера всегда актуальны: они запрашиваются из CS-Cart по API в реальном времени в момент открытия.
Синхронизация статусов
Интеграция поддерживает синхронизацию статусов между заказами в CS-Cart и соответствующими сделками в amoCRM. Дополнительные услуги для этого подключать не нужно: функция входит в базовый пакет.
Сопоставьте статусы. Откройте одноимённый пункт настроек интеграции и установите соответствие между статусами, которые нужно синхронизировать.
Проверьте направление CS-Cart → amoCRM. Оно заработает сразу после настройки соответствия статусов.
Настройте обратное направление amoCRM → CS-Cart. Откройте настройки цифровой воронки amoCRM и добавьте вебхук виджета CS-Cart к тем стадиям, при попадании сделки в которые нужно передавать изменение статуса в CS-Cart. Для этого введите «CS-Cart» в поле поиска вверху окна создания нового действия цифровой воронки и выберите наш виджет в результатах.
Если вы используете редакцию CS-Cart Multivendor, для каждого статуса доступно оповещение клиента, отдела и продавца при смене статуса заказа.
Инструкция по установке и первичной настройке интеграции вашего магазина на базе CMS CS-Cart с системой учёта Битрикс24. Описание самого приложения: «CSCart-Битрикс24».
Благодарим вас за интерес к нашему продукту! Весь процесс установки и интеграции состоит из нескольких шагов, которые описаны ниже по порядку.
Видеоинструкция по установке
1. Установка приложения для Битрикс24
Установка приложения для Битрикс24 полностью автоматизирована. Найдите приложение в маркетплейсе Битрикс24 по названию «CS-Cart» и установите его в свой Битрикс24.
Через пару секунд после установки вы получите уведомление в свой Битрикс24 с кодом интеграции (на иллюстрации он выделен красным фоном). Этот код понадобится дальше, чтобы связать Битрикс24 с интернет-магазином на CS-Cart.
Во время тестирования выяснилось, что не все пользователи коробочной версии Битрикс24 получают уведомления от приложения. В этом случае воспользуйтесь формой восстановления кода интеграции: она запросит название вашего домена Битрикс24 и дату установки приложения.
2. Установка модуля для интернет-магазина на CS-Cart
Чтобы завершить интеграцию, нужно установить и ответный модуль для CS-Cart. Подробно создание модуля, его установка и подключение к приложению для Битрикс24 описаны в инструкции к генератору архива модуля.
Получите архив модуля. Перейдите к генератору архива модуля и укажите свой код интеграции. После отправки формы вы получите готовый архив и краткую инструкцию по установке.
Загрузите модуль в CS-Cart. В административной панели откройте страницу управления модулями, нажмите кнопку добавления нового модуля и выберите только что полученный архив.
Включите модуль. Иначе он не будет получать оповещения о новых заказах и об изменениях в существующих.
Откройте настройки модуля. Для этого нажмите на название модуля в списке установленных. Настройки состоят из двух вкладок: «Настройки локального модуля» и «Настройки интеграции и обмена данными».
Если вы раньше не устанавливали внешние модули, CS-Cart может сообщить об отсутствии прав на загрузку. Это связано с ограничением на запись в некоторые папки. Либо предоставьте CS-Cart права на указанные папки, либо загрузите модуль вручную по FTP: структура папок внутри архива соответствует структуре папок вашей установки CS-Cart.
Первая вкладка, «Настройки локального модуля», содержит только код интеграции, который был записан автоматически при формировании архива. Менять его не нужно. Вторая вкладка, «Настройки интеграции и обмена данными», содержит все настройки интеграции.
Изменения сохраняются по клику на зелёную кнопку, расположенную после блоков настроек по центру экрана, а не на синюю кнопку в правой нижней части рамки окна настроек.
3. Основные настройки и свойства интеграции
Когда приложения установлены, а интеграция подключена, посмотрим, какие параметры в настройках за что отвечают.
Ответственный пользователь
Пользователь вашего Битрикс24, который будет указываться ответственным за создаваемые виджетом сделки, лиды и контакты. На его имя также создаются задачи, если этот параметр включён.
Добавлять задачи по создаваемым сделкам или лидам
Включает создание задачи ответственному пользователю при создании новой сделки или лида на основании заказа в CS-Cart. Если параметр включён, действуют и другие параметры, регулирующие работу с задачами: «Аудитор задач», «Время на выполнение задачи» и «Предельный срок выполнения задачи».
Создавать счета по создаваемым сделкам
При создании новой сделки создаётся счёт со списком товаров, переданных в сделку. Опция недоступна, если отключено создание сделок и вместо них создаются лиды.
Задачи и сделки видны только ответственному и администраторам
Указывает, доступны ли создаваемые сущности всем пользователям Битрикс24 или только назначенному ответственному.
Аудитор задач
Пользователь вашего Битрикс24, который будет указываться контролирующим для задач, создаваемых на имя ответственного.
Начальный статус сделки
Статус, в котором по умолчанию создаётся сделка в Битрикс24. Все новые сделки по заказам из вашего интернет-магазина будут создаваться в этом статусе.
Тип контакта заказчика
Позволяет выбрать, создавать ли контакт под каждого нового заказчика вместе со сделкой или вместо этого создавать лид.
Режим работы
Выбор режима работы с заказами. Традиционным мы считаем создание контакта (или использование уже существующего), создание сделки по факту заказа и счёта к ней. Некоторые пользователи предпочитают режим «Только лид» вместе со значением «Лид» в параметре «Тип контакта заказчика»: тогда создаётся только лид со всеми контактными данными заказчика и данными заказа. В этом режиме не поддерживаются синхронизация статусов, создание счетов покупателю и синхронизация списка товаров: эти услуги разрабатывались для использования вместе со сделками.
Источник по умолчанию
Значение поля «Источник» в Битрикс24 для каждой создаваемой приложением сделки. Полезно, если интернет-магазин на CS-Cart, с которым настраивается интеграция, не единственный источник заказов в вашем Битрикс24.
Тип счёта
Тип счёта, который создаётся вместе с каждой сделкой, если эта функция включена. Не все типы позволяют создать документ в Битрикс24.
Тип передачи товаров
Приложение поддерживает несколько режимов работы с товарами:
«Товары»: список товаров из заказа клиента преобразуется в иллюстрированный и отображается во вкладке «Товары» соответствующей сделки. Иллюстрированный список можно редактировать, добавляя и удаляя товары.
«Комментарий к сделке или лиду»: список товаров из заказа покупателя размещается в виде комментария к сделке с HTML-форматированием.
«Оба варианта»: одновременно используются и товары в Битрикс24, и текстовый комментарий. Полезно, если важно знать состав заказа на момент его оформления: примечание к сделке или лиду не изменяется при обновлении списка товаров.
Время на выполнение задачи
Время в минутах, которое прибавляется ко времени создания сделки, чтобы получить прогнозируемое время исполнения задачи, создаваемой одновременно со сделкой (если функция включена).
Предельный срок выполнения задачи
Предельное время выполнения задачи, установленной приложением на основании созданной сделки или лида, в минутах.
Срок действия счёта
Срок в днях, в течение которого покупатель должен оплатить счёт за заказ. Учитывается, если включено создание счетов приложением.
4. Настройка синхронизации статусов (опционально)
В меню «Автоматическая синхронизация статусов» можно настроить автоматическое изменение статуса заказа в CS-Cart на основании статуса сделки или лида в Битрикс24 и наоборот. Чтобы синхронизация заработала, установите соответствие между статусами в CS-Cart и Битрикс24. Настраивайте только те статусы, которые вам нужны: если движение по воронке продаж для каких-то статусов не требуется, настраивать их не нужно.
Важно. Битрикс24 не поддерживает автоматическую установку вебхука средствами API, поэтому для синхронизации в направлении Битрикс24 → CS-Cart нужно вручную создать новый вебхук.
Откройте вебхуки. В вашем Битрикс24 откройте страницу «Приложения» и перейдите на вкладку «Вебхуки».
Заполните форму. В поле «Адрес обработчика» укажите https://cscart-bx24.widgets.ibice.ru/webhook/bitrix24. «Название» и «Комментарий» на ваше усмотрение. В поле «Тип события» выберите «Обновление сделки (ONCRMDEALUPDATE)», если интеграция настроена на работу со сделками, или «Обновление лида (ONCRMLEADUPDATE)», если на работу с лидами.
Сохраните. Нажмите зелёную кнопку «Сохранить» в самом низу страницы.
5. Работа с call_requests в CS-Cart младше 4.9
В CS-Cart версий младше 4.9 нет хука do_call_request, который наш модуль использует, чтобы определить появление нового запроса на обратный звонок. Чтобы добавить его поддержку:
Откройте файл/app/addons/call_requests/func.php (путь указан относительно корневой папки CS-Cart на вашем веб-сервере) в любом текстовом редакторе. Мы рекомендуем Notepad++ для Windows и gedit для графических окружений Linux.
Найдите функциюfn_do_call_request и в самом её конце, перед return $result;, добавьте код ниже.
Этот код заставит CS-Cart отправлять системное оповещение (хук) о новом запросе на обратный звонок и добавлять в его тело ID созданной сущности (это нужно для защиты от дублирующихся вхождений).
6. Базовые и дополнительные услуги приложения
Все основные функции по передаче заказов, данных покупателя и списка товаров из интернет-магазина на CS-Cart в Битрикс24 доступны сразу после установки и предоставляются без отдельных условий. В базовую комплектацию входит:
Создание контакта в Битрикс24 на имя заказчика из CS-Cart. Если контакт с таким номером телефона или адресом электронной почты уже существует, к сделке прикрепляется он. Если найдено два контакта (один по почте, другой по телефону), прикрепляются оба. Если контакт найден только по телефону или только по почте, недостающий параметр добавляется к контакту автоматически.
Создание сделки или лида в Битрикс24 на основании данных заказа из интернет-магазина. По каждому новому заказу в CS-Cart приложение создаёт новую сделку или лид. В настройках можно указать статус, в котором создаются сделки, ответственного, режим работы с товарами и список дополнительных полей сделки для данных из заказа. В зависимости от режима список товаров передаётся текстом в примечание к сделке или иллюстрированным списком. В базовой комплектации предполагается, что основная работа с заказами идёт в Битрикс24, поэтому изменения в списке товаров в режиме «Товары» не синхронизируются с CS-Cart: эта опция предлагается дополнительно.
Автоматическая синхронизация статусов между CS-Cart и Битрикс24. При перемещении заказа по воронке продаж в Битрикс24 статус заказа в CS-Cart тоже меняется, и наоборот. Это пригодится, если заказчики отслеживают статус заказа через личный кабинет в вашем магазине.
Создание задачи ответственному за сделку или лид при поступлении нового заказа из интернет-магазина.
Создание счёта по факту добавления сделки или лида.
Дополнительные услуги мы исключили из базового пакета, чтобы снизить его стоимость: они нужны не каждому бизнесу. Среди них:
Синхронизация товаров в списке товаров Битрикс24 с заказом в интернет-магазине на CS-Cart. Если включён режим передачи товаров «Товары», они не только создаются в Битрикс24 на основании заказа, но и поддерживаются дальше. Добавление, правка или удаление товаров в заказе в магазине повлекут аналогичные действия с товарами в Битрикс24 и автоматическую корректировку бюджета сделки; изменения в Битрикс24 так же отражаются в заказе со стороны CS-Cart. Например, при звонке с подтверждением заказа покупатель просит добавить ещё одну позицию. Менеджеру достаточно добавить товар карточкой в интерфейсе Битрикс24: бюджет сделки пересчитается автоматически, а заказчик через мгновение увидит новую позицию в заказе в личном кабинете магазина.
7. Подключение и оплата дополнительных услуг
Чтобы подключить или отключить дополнительную услугу, обратитесь в нашу службу поддержки: по электронной почте или по контактному телефону в вашем регионе. Для дополнительных услуг доступна как единоразовая, так и ежемесячная оплата.
Дополнительные услуги подключаются и отключаются со следующего биллингового периода. Например, если виджет оплачен до 31 октября, новая услуга подключится с 1 ноября, а её стоимость добавится к стоимости продления. Если вы отправили запрос на отключение услуги, а сумма в счёте не изменилась, не оплачивайте его: обратитесь в службу поддержки, чтобы счёт перевыставили в соответствии с новым списком услуг.
8. Часто задаваемые вопросы
Для каких версий CS-Cart предназначена интеграция?
Во время разработки мы тестировали весь функционал на CS-Cart 4.7, но это не значит, что младшие версии несовместимы. Если при установке что-то идёт не так или интеграция не работает, сообщите нам, и мы постараемся устранить причины расхождений.
Где хранятся передаваемые данные заказчиков и не нарушаются ли требования 152-ФЗ «О персональных данных»?
Приложение обеспечивает только передачу данных заказчика, а не их хранение и обработку, поэтому персональные данные заказчиков вашего интернет-магазина «Ибице» не сохраняет вообще. На наших серверах хранится лишь информация для авторизации в API сторон обмена, а также сопоставление номеров заказов, счетов и сделок вместе с данными о товарах. Согласно Федеральному закону от 27 июля 2006 г. № 152-ФЗ, эта информация не имеет признаков персональной, поэтому ограничений на место её хранения закон не накладывает.
Насколько безопасна передача данных о заказах через приложение?
Соединение с серверами Корпорации осуществляется по протоколу HTTPS. Мы следим за обновлением настроек веб-серверов и перевыпуском сертификатов шифрования. Качество шифрования можно в любой момент проверить с помощью внешних аудиторов, например Qualys, Inc. Серверы, обслуживающие приложение, совместимы со стандартами PCI DSS, но не проходят сертификацию, поскольку не участвуют в платёжных операциях.
Насколько надёжно приложение?
С 2006 года мы стараемся выпускать только качественное программное обеспечение, но работа приложения зависит и от стабильности API CS-Cart и Битрикс24, поэтому мы не можем гарантировать полноту и своевременность передачи. Тестирование показало, что успешно исполняется около 99,5% запросов.
Не будет ли «тормозить» интерфейс Битрикс24 или CS-Cart после установки?
Приложение не влияет на скорость работы веб-интерфейса Битрикс24, а в CS-Cart представлено всего лишь фреймом со страницей настроек. Задержки при загрузке страницы настроек объясняются большим числом запросов к серверам Битрикс24 и вашего магазина для сбора информации о настройках. Скорость синхронизации товаров зависит от их количества: магазины с несколькими десятками товаров синхронизируют списки почти мгновенно, а гипермаркеты с тысячами товаров могут синхронизироваться до 15 минут.
Мой магазин имеет специфические функции, которых нет в базовом функционале. Как подключить их?
Обратитесь в нашу службу поддержки. У нас много дополнительных услуг и вариантов интеграции, которые мы не публикуем и не включаем в базовую комплектацию. Если бы мы включили в неё все функции, которые считаем нужными, главное окно настроек интеграции загружалось бы от одной до трёх минут.
Как заказать счёт на оплату услуг от юридического лица?
Откройте настройки модуля «Битрикс24» в вашем CS-Cart, найдите во всплывающем окне блок со сроком действия подписки и нажмите «Перейти к оплате». На первой вкладке можно оплатить онлайн, на второй — зарегистрировать запрос на выставление счёта. В рабочее время счёт придёт на указанный адрес электронной почты в течение часа после регистрации запроса. Квитанцию об оплате предоставлять не обязательно: платёж принимается автоматически по факту поступления на наши расчётные счета, а вы получите кассовый чек на указанный адрес электронной почты.
Как получить закрывающие документы после оплаты от юридического лица?
Запросите их в службе поддержки или у менеджера, который выставлял счёт. Закрывающие документы также размещаются в личном кабинете клиента сферы крупного бизнеса и промышленности после истечения срока действия услуги. Если по договору расчётный период — календарный месяц и услуги продлены до 10 июня, скачать документы в личном кабинете можно 11 июня.
Мне нужна нестандартная логика работы интеграции. Как это сделать?
Большинство изменений можно внести с помощью бесплатной квоты дополнительной услуги «Статичные правила обработки заказов». Опишите суть изменений на support@ibice.ru. Если их возможно и технически целесообразно реализовать этой услугой, мы сделаем это. Если сложность запроса выходит за её возможности, оператор подскажет возможные пути решения и предложит дополнительные услуги по доработке виджета или интеграционного приложения.
Как долго подключается интеграция после заявки на бесплатную установку и первичную настройку?
Если заявка подана в рабочее время, срок обработки от одного часа до конца текущего рабочего дня (в зависимости от нагрузки на операторов технической службы). Если в нерабочее время, то в следующий рабочий день: заявка, поданная в 23:00 в субботу, будет обработана в первой половине понедельника.
Работает ли интеграция с разделом «Интернет-магазин» в Битрикс24?
Нет. Приложение для Битрикс24 работает только с CRM и запрашивает при установке права доступа только к CRM, поэтому работать через него с разделом «Интернет-магазин» нельзя ни в базовой комплектации, ни со статичными правилами обработки заказов. Вы можете заказать индивидуальное локальное приложение, которое будет поддерживать нужные разделы.
Можно ли передавать в Битрикс24 информацию о регистрации новых пользователей?
Да. Новый пользователь может регистрироваться как лид или контакт. Чтобы подключить эту возможность, обратитесь в службу поддержки.
Можно ли передавать в Битрикс24 информацию о регистрации новых продавцов в формате «Мультивендор»?
Да. Новый продавец может регистрироваться как лид или контакт. Чтобы подключить эту возможность, обратитесь в службу поддержки.
У нас редакция «Мультивендор». Как будет работать интеграция?
Вариантов много, и какой подойдёт именно вам, зависит от организации работы с заказами. В настройках модуля можно выбрать, заказы и товары каких вендоров передавать в Битрикс24. Мы также можем разделять заказы по вендорам, маркировать их или ставить на каждый товар отметку, по которой можно определить продавца. Чтобы выбрать оптимальный вариант, обратитесь в службу поддержки и расскажите, как вы хотели бы работать с заказами в Битрикс24.
При установке модуля возникает ошибка «Не удалось установить соединение с API CS-Cart»
Ошибка возникает, если в форме установки соединения вы указали данные для подключения к CS-Cart API, по которым системе не удалось связаться с вашим магазином. Чаще всего причины такие:
Указан некорректный URL. Проверьте, открыв его в другой вкладке браузера: если не появилось окно авторизации в CS-Cart API, URL неверный.
Указаны некорректные адрес электронной почты или API-ключ. Почта должна принадлежать тому же пользователю CS-Cart, что и API-ключ.
Вы разрешили пользователю доступ к API в настройках аккаунта CS-Cart и получили API-ключ, но не сохранили изменения. После включения API-доступа форму нужно обязательно сохранить, иначе доступ не активируется: при следующем открытии профиля он снова будет отключён.
Также у нас есть бесплатная услуга по первичной настройке и установке интеграции.
Вебхуки из CS-Cart обрабатываются слишком долго, страница успешной регистрации заказа грузится дольше. Что делать?
Точки входа, которые принимают информацию для дальнейшей обработки, расположены в крупных дата-центрах Европы с быстрым откликом и хорошими маршрутами по Европе и странам СНГ, поэтому норма отклика на запрос передачи данных через вебхук — до одной секунды. Отклонения в большую сторону допустимы, если ваш сервер находится далеко от Европы (Америка, особенно Южная, Азия, Океания, Австралия) или в отдалённых регионах России, например во Владивостоке или Южно-Сахалинске.
Если время ответа принимающих серверов превышает три секунды, сначала проверьте DNS-серверы, которые использует ваш сервер для преобразования доменных имён в IP-адреса. Самое узкое место обмена данными между сервером магазина и нашими узлами — DNS: даже при мгновенном отклике принимающего узла запрос задержится на время разрешения доменного имени. Если ответы DNS-сервера медленные или приходят с разной задержкой (например, первый за 20 мс, второй за 1,3 с), смените DNS-сервер на один из предоставляемых крупными компаниями (Google, Cisco, Comodo, G-Core и т. п.). Оптимальный вариант определите тестированием непосредственно с вашего сервера: лучший по отзывам провайдер может оказаться худшим в вашей сети.
Если проблема не в DNS или сервер находится в отдалённом регионе (например, в Сингапуре) и повлиять на скорость нельзя, перейдите на многопоточную версию модуля для CS-Cart: она выполняет запросы обмена в отдельном потоке и не задерживает обработку заказа ни на долю секунды.
Карточки товаров в Битрикс24 создались корректно, но после ручного удаления больше не появляются. Что делать?
Система защиты от дубликатов карточек устроена так, что ручное удаление карточки товара, созданной интеграцией, со стороны Битрикс24 считается нежеланием использовать этот товар в Битрикс24. После удаления товар не будет создан заново, не будет обновляться при изменениях в CS-Cart и привязываться к новым заказам.
Чтобы заново создать удалённые вручную карточки, обратитесь в службу поддержки с запросом внеочередной полной синхронизации каталога товаров: система очистит стоп-лист и заново создаст карточки по всем удалённым ранее товарам.
Остались вопросы? Напишите в службу поддержки: мы всегда рады помочь.
Начало работы
Частые вопросы
Ответы на вопросы, которые нам задают чаще всего.
Есть ли тестовый период?
Для большинства наших продуктов бесплатный пробный период предоставляется бесплатно в момент установки и может составлять от 10 до 30 дней. Более подробно о сроках бесплатного пробного периода можно узнать на странице соответствующего продукта.
Сколько стоит подписка?
Цена указана в карточке каждого виджета, например «от 750 ₽/мес». Стоимость индивидуальных интеграций зависит от задачи.
