Оглавление 1. Организация работы модуля, основные требования к системе ..................................................... 2 2. Битрикс 24 ............................................................................................................................................ 2 3. Яндекс.Маркет ..................................................................................................................................... 2 4. Настройка Работы модуля .................................................................................................................. 3 4.1. Установка модуля ............................................................................................................................ 3 4.2. Настройка модуля “ПервыйБит: Отзывы Яндекс Маркет” .......................................................... 3 4.2.1. Настройки синхронизации с Битрикс24................................................................................. 3 Шаг 1. Указываем основные настройки доступа к облаку:.............................................................. 3 Шаг 2. Указываем «Код приложения» ............................................................................................... 4 Шаг 3. Получение AccessToken ........................................................................................................... 4 4.2.2. Настройка доступа к сервису Яндекс.Маркет ....................................................................... 5 4.2.3. Настройки импорта данных в систему .................................................................................. 5 4.2.4. Настройки экпорта данных в Битрикс24................................................................................ 6 4.2.5. Служебные скрипты (агенты) ................................................................................................. 8 1 1. Организация работы модуля, основные требования к системе Bitrix24 Предустановленный модуль для использования RestApi API Yandex.Market Модуль Для организации работы модуля потребуется сервисы: Битрикс24, Яндекс.Маркет а так же платформа на базе 1С-Битрикс Это может быть как проект на базе 1С-Битрикс: Управление сайтом или же Корпоративный портал. Основным требованием является наличие включенного модуля «Информационные блоки» Помимо основных требований для корректной работы продукта 1C-Битрикс обязательно наличие включенной библиотеки libcurl на сервере для синхронизации с сервисом Яндекс.Отзывы. http://php.net/manual/ru/book.curl.php 2. Битрикс 24 Для обеспечения работоспособности модуля на облачном сервисе Битрикс24 необходимо установить приложение «YA.Market отзывы» Приложение использует только API, и никак не интегрируются в интерфейс Битрикс24. Внешние приложения служат для получения данных, которые будут использоваться (добавление Лидов и Задач) через RestApi. 3. Яндекс.Маркет Модуль взаимодействует с API Яндекс.Маркет. для организации работы приложения необходимо: 1. Интернет магазин должен быть зарегистрирован на Яндекс.Маркет (потребуется идентификатор магазина) 2 2. API Яндекс.Маркета доступно только авторизованным пользователям. Идентификация происходит с помощью авторизационных ключей, выдаваемых системой Яндекс.Маркета. Необходимо обратиться к администратору сервиса. https://tech.yandex.ru/market/content/doc/dg/concepts/authorization-docpage/ 4. Настройка Работы модуля 4.1. Установка модуля После покупки приложения будет доступен купон. Подробнее об активации купона https://dev.1cbitrix.ru/learning/course/index.php?COURSE_ID=35&LESSON_ID=2696&sphrase_id=4685251 После активации купона необходимый модуль появиться в подразделе «Установленные решения» После установки, настройки модуля будут доступны в админ. панели в разделе “Настройки” > “Настройки продукта” > “Настройки модулей” > “ПервыйБит: Отзывы Яндекс Маркет” 4.2. Настройка модуля “ПервыйБит: Отзывы Яндекс Маркет” 4.2.1. Настройки синхронизации с Битрикс24 Шаг 1. Указываем основные настройки доступа к облаку: - Имя портала Сохраняем данные. 3 Шаг 2. Указываем «Код приложения» Для получения кода первичной авторизации после сохранения шага 1 будет доступна ссылка для получения кода первичной авторизации Перейдя по которой откроется страница на портале с указанием кода приложения Сохраняем полученные настройки Шаг 3. Получение AccessToken Для получение ключей доступа к облаку Битрикс24 после сохранения шага 2 будет доступна ссылка «Получить ключ доступа». При клике на которую произойдет перезагрузка страницы и система сгенерирует ключи. Дальнейшее обновление ключей будет производиться в автоматическом режиме раз в час. Если необходимо обновить ключи в ручном режиме достаточно перейти по ссылке «Обновить ключ доступа» При сбое необходимо повторить настройки по шагу 2 и 3. 4 4.2.2. Настройка доступа к сервису Яндекс.Маркет Для подключению к сервису Яндекс.Маркет необходимо указать - Идентификатор магазина - Ключ доступа После указания всех необходимых данных система в автоматическом режиме произведет загрузку всех уже имеющихся данных на Яндекс.Маркете. При установки модуль будет находиться в режиме «первоначальной загрузки данных» После загрузки все отзывов будет включен режим «дозагруки», т.е. будут догружаться последние отзывы. 4.2.3. Настройки импорта данных в систему Данные полученные от системы «Яндекс.Маркета» сохраняются в инфоблоки. При установке модуля инфоблок с необходимыми свойствами создаться в автоматическом режиме. Если по какой-то причине необходимо использовать свой инфоблок. Для этого предусмотрена гибкая настройка. В этом случае основные поля отзыва сохраняются в свойства инфоблока. 5 4.2.4. Настройки экпорта данных в Битрикс24 Системой предусмотрено отправка всех отзывов в Битрикс24 в Лиды. Важно! При первоначальной настройки на вкладке Битрикс 24 указать «Количество дней за которые выгружать отзывы в b24» по умолчанию значение равно 10 Настройки Импорта Лидов Для импорта Лидов в Битрикс24 необходимо указать следующие настройки: - Шаблон названия (для формирования названия Лида доступны поля отзыва, поля отзыва необходимо указывать в #...#) - Текстовый идентификатор статусы Лида. - Менеджер, ответственный за Лид - Текстовый идентификатор Источника Лида - Шаблон для комментария (описания) Лида (для формирования комментария Лида доступны поля отзыва. , поля отзыва необходимо указывать в #...#) 6 Настройки Импорта Задач При отрицательной оценки отзыва предусмотрено конвертация отзывов в задачи. Для формирования отзыва в задачу необходимо указать следующие параметры: - Какие оценки выгружать в отзывы (множественное поле). - Постановщик задачи (список пользователей из облака) - Ответственный за задачи (список пользователей из облака) - Наблюдатели (список пользователей из облака) - Шаблон для названия задачи (для генерации названия задачи доступны поля отзыва, поля отзыва необходимо указывать в #...#) - Шаблон для описания задачи (для генерации названия задачи доступны поля отзыва, поля отзыва необходимо указывать в #...#) 7 4.2.5. Служебные скрипты (агенты) Для экспорта данных в Битрикс24, импорта данных из Яндекс.Маркета и обновления ключей доступа для Битрикс24 при установки модуля формируется 3 агента, работающих в периодическом режиме 1. Reviews::AgentReviews(); - импорт данных из Яндекс.Маркета 2. *BIT24::RefreshToken(); - обновление ключей доступа к bitrix24 3. Reviews::SelectReviews(); - выгрузка Лидов и Задач в bitrix24 *Для BIT24::RefreshToken(); не рекомендуется изменять интервал работы агента. Это связано с тем, что ключи действительны в течение часа. 8