Видео по настройке
Настройка модуля интеграции происходит с участием 3 систем.
1. Настройка на стороне RetailCRM.
2. Настройка группы (сообщества ) на стороне VK.
3. Настройка самого модуля интеграции.
Каждый блок настроек рассмотрен отдельно.
ВНИМАНИЕ ! Блок 2 и блок 3 нужно производить в параллели. В инструкции указаны, где какие данные необходимо использовать.
Настройка на стороне RetailCRM для подключения модуля интеграции VK.
В RetailCRM должен быть созданы:
- Магазин, с которым будет интегрирована группа с VK.
- Сгенерирован и загружен каталог c номенклатурой.
Важно:
- — Фотографии к товарам в каталоге сгенерированном для синхронизации с VK Market должны быть размерами не менее 400 px x 400 px
— Допустимые форматы: JPG, PNG, GIF
— Сумма высоты и ширины не более 14000px
— Файл объемом не более 50 МБ
— Минимальная длина описания 10 символов (Описание берется из файла ICML тег — <description>…</description>
— У товаров должно быть не более 2-х свойств.На скрине приведен пример. В верхней части — как отображается в ВК , в нижней части пример товара со свойствами Размер и Цвет. Сами свойства могут быть разными, но количество этих свойств не более двух.
- Значения количества свойств товара должно быть не более 30 . Т.е. если свойство Размер , то размеров в файле обмена не должно быть более 30
Обратите внимание! Для объединения карточек товаров по свойствам, необходимо чтобы они были заполнены в соответствии с примером выше.
Расположение поля для добавление ссылки на каталог:
- Необходимо создать API — ключ.
— Добавьте новый API — ключ
— Подпишите назначение API -ключа в разделе комментарий.
— Тип доступа. Разрешите доступ к магазину, который будет синхронизирован с VK.
— Разрешенные следующие методы API:
— Сохраните.
Используйте созданный API — ключ только для интеграции с VK .
Настройка группы(сообщества) на стороне VK.
Для работы с модулем необходимо создать приложение, оно позволит Вашей CRM работать с VK.
Для создания приложения авторизуйтесь в социальной сети под тем аккаунтом, к которому будет привязано приложение.
ВНИМАНИЕ: Ваш аккаунт должен иметь права администратора в группе(сообществе) которая будет подключено к модулю.
Зайдите в группу , которую хотите подключить к RetailCRM . Зайдите в Управление — пункт Разделы — включите функционал товаров.
Перейдите в настройки магазина
Настройки :
1. Регионы . Выберите страну (страны) и города в которых работает магазин.
2. Валюта магазина .Выберите соответствующую вашей валюте на сайте валюту, т.к. цены из CRM будут передаваться в валюте CRM, а ВК будет их воспринимать в соответствии с этой настройкой.
3. Контакт для связи — Сообщения сообщества . Тип кнопки — написать продавцу, тогда будет открыто окно для сообщения.
До тех пор, пока товаров в группе нет, блок с товарами не будет виден никому кроме администраторов группы.
Создание приложения VK
Для работы модуля интеграции необходимо создать приложение, для этого переходим по ссылке https://vk.com/editapp?act=create откроется страница:
Необходимо указать :
1. Название вашего приложения ,название произвольное , например Интеграция ВК и RetailCRM .
2. Выбираем платформу Сайт.
3. Адрес сайта : https://vk.imb-service.ru
4. Базовый домен : vk.imb-service.ru
Нажимаем — Подключить сайт.
В разделе Информация обязательно необходимо выбрать группу, к которой подключаете.
Нажимаем 
Переходим в раздел настройки приложения. Open API.
В настройках :
1. Адрес сайта : https://vk.imb-service.ru
2. Базовый домен : vk.imb-service.ru
3. Доверенный redirect URI: https://vk.imb-service.ru/setting/code
Нажимаем
Передача заказов настройка на стороне сообщества и одновременно необходимы будут данные с модуля. Настройку можете проводить в параллели с модулем интеграции (Блок : Настройка модуля интеграции ) . Для удобства последовательности настроек тут описываем именно часть из VK, а блок модуля отдельно, но какие строки берем из модуля ниже будет указано и продемонстрировано на скринах.
Переходите в сообщество. Управление — Настройка — Работа с API — Callback API .
Перед настройкой добавьте новый сервер: нажимаете на поля с названием данного сервера и затем «Добавить сервер»
Вносим настройку : Версия API : 5.124
Внимание ! Перед следующим шагом обязательно должна быть выполнена настройка из модуля интеграции Модуль и Магазин (Блок инструкции 3. Настройка самого модуля интеграции.) 
Далее необходимо настроить Сallback API и получить подтверждение корректности ссылки Сallback .
На скрине продемонстрирована: слева — страница с настройками модуля (данный раздел по настройкам описан ниже) , справа — настройки на стороне VK.
Вносим настройку :
1. Копируем код из VK , переносим во вкладку настроек модуля интеграции — вкладка Настройки callback,
в строку, которую должен вернуть сервер (callback)
Нажимаем 
2. Копируем Адрес callback на стороне настроек модуля и переносим в Адрес на стороне VK
3. Нажимаем 
4. Если синхронизация прошла корректно, то напротив Адреса callback появится подтверждающая галочка 
5. Придет сервисное сообщение от VK что группа подключена. Одобрите запрашиваемое подключение .
Перейдите на стороне сообщества в пункт настроек Работы с API — Типы событий
Дойдите до раздела работы с товарами и поставьте галочки на два пункта Создание Заказа и Редактирование Заказа.
Дойдите до раздела работы с товарами и поставьте галочки на два пункта Создание Заказа и Редактирование Заказа
Настройка модуля интеграции
Для первого входа в настройки модуля перейдите : https://vk.imb-service.ru. Настройте Первый раздел — Модуль (описание подключения ниже) Нажмите Сохранить. После того как будет произведено подключение данное приложение появится на Маркетплейс RetailCRM вашего аккаунта. Продолжайте настройку там.
Администрирование — Интеграции — Маркетплейс — Магазин ВКонтакте — Перейти в личный кабинет.
Данная схема подключения будет актуально до момента модерации и размещения интеграционного модуля сразу на Маркетплейс RetailCRM . После размещения на Маркетплейс RetailCRM подключение будет происходить сразу там.
Hаздел — Модуль
- Ссылка на аккаунт RetailCRM — внесите данные своего аккаунта retailCRM. На примере введен тестовый аккаунт.
- АPI — ключ — вносим API — ключ созданный в п.3 Настройки на стороне retailCRM.
- ID приложения — вносим данные из настроек приложения VK , которое ранее создавали (см. на скрине)
- ID группы — вносим данные из настроек Callback API (см. на скрине). Обращаем внимание что ID группы можно посмотреть и другим способом, согласно документации в https://vk.com/faq18062 . Но для удобства пользователей мы предлагаем посмотреть его уже на вкладке, которая уже используется при подключении. Если Вы настраиваете модуль в другом порядке действий, то используйте наиболее удобное Вам место.
- Защищенный ключ — вносим данные из настроек приложения VK , которое ранее создавали (см. на скрине).
Сохраните изменения .
После сохранения может появится сервисное сообщение:
Если это произошло , зайдите в свой аккаунт RetailCRM .
Путь — Администрирование — Интеграция -Маркетплейс -Настройки интеграции с Магазин ВКонтакте —
Раздел — Магазин
Раздел —Настройки callback
В разделе заказы станет доступна информация по Callback, которую необходимо ввести в настройках на стороне VK .
Синхронизируйте системы :
1. Копируем код из VK , переносим во вкладку настроек модуля интеграции — вкладка Настройки callback,
в строку, которую должен вернуть сервер (callback)
Нажимаем
2. Копируем Адрес callback на стороне настроек модуля и переносим в Адрес на стороне VK
3. Нажимаем
4. Если синхронизация прошла корректно, то напротив Адреса callback появится подтверждающая галочка
5. Придет сервисное сообщение от VK что группа подключена. Одобрите запрашиваемое подключение .
Продолжайте настройки на стороне модуля.
Раздел — Категории.
Для синхронизации каталога товаров из retailCRM с ВК маркет, необходимо сопоставить связи категорий между существующими в retailCRM и созданными в ВК маркет (категории в ВК не создаются, нашим модулем)
Для сопоставления выберите соответствующую категорию в ВК маркете из выпадающего списка , напротив нужно категории retailCRM.
Повторите процесс для остальных категорий.
Раздел — Заказы.
В разделе Заказы сопоставьте статусы заказов в своей группе ВК с статусами заказов в CRM
Для того чтобы выбрать соответствующий статус в CRM нажмите на пустое поле напротив нужного статуса ВК .
После окончания настройки сопоставления, нажмите
Раздел — Товары.
Взаимодействие с данным разделом можно производить только после заполнения вкладки Категории.
Для запуска выгрузки товаров нажмите «Выгрузка товаров в VK»
Для удаление товаров, выгруженных модулем нажимаем «Удаление товаров выгруженных модулем»
Для удаление всех товаров с магазина нажимаем «Удаление Всех товаров Маркета»
Отслеживать работу по выгрузке/удалению товаров можно на вкладке «Логи товаров»
Раздел — Остатки
Передача остатков возможна как единоразово вручную, так и автоматически каждые 30 минут с момента активации функционала.
Остатки можно передавать как общие по всем складам, так и и с отдельного склада — для выбора склада нажмите на с надписью «Передавать общие остатки»
После настройки нажимаем «Сохранить настройки» и только потом «Запустить задачу обновления остатков в VK»
Особенности реализации .
1.В случае, если вы на стороне Retailcrm произвели Очистку каталога , необходимо заново сделать связку категорий товаров в модулей в вкладке Каталог.
2. Если при активации или обновлении модуля интеграции видите ошибку :
Это ошибка означает что не произошла синхронизация между модулем интеграции и VK.
Для устранения перепроверьте :
1. Являетесь ли Вы администратором в сообществе VK, которое подключаете. Или предоставлен и в настоящий момент актуален доступ в приложение VK , которое создал администратор сообщества.
2. Правильно ли указаны данные в созданном приложении. Особенно обратите внимание указана ли верно подключаемая группа и на Доверенный redirect URI: https://vk.imb-service.ru/setting/code.
После устранения ошибок, продолжить настройку можно перейдя в модуль https://vk.imb-service.ru/settings или через Ваш аккаунт RetailCRM.
Путь — Администрирование — Интеграция -Маркетплейс -Настройки интеграции с Магазин ВКонтакте —
О поддержке модуля Вы можете узнать в разделе Поддержка (перейти).
