Sam-24

Выгрузка "Историй" ВК на сайт 1С-Битрикс

2024-03-03T15:45:08.411Z

Инструкция по автоматической выгрузки "Историй" из социальной сети ВК на сайт с CMS 1С-Битрикс, используя модуль "Stories. Блок историй на сайт и выгрузка VK "Историй"

После установки модуля необходимо перейти в его настройки по пути: "Настройки" - "Настройки модулей" - "Блок историй "Stories"".

Стартовый экран настроек:

Экран настроек импорта "Историй" ВК

Для работы нам необходимо создать приложение в ВК и получить расширенные права на аккаунте, если ранее таких не было.

Для этого переходим по ссылке: https://id.vk.com/about/business/go либо нажимаем по ссылке в самом модуле.

Стартовый экран авторизации выглядит следующим образом:

Выбираем физическое лицо и нажимаем "Далее".

На втором экране добавляем отсутствующие данные и соглашаемся с условиями ВК:

Нажимаем кнопку "Создать аккаунт".

После создания аккаунта нас перебросит на экран "Регистрация приложения". На котором необходимо указать "Название приложения" и выбрать чек-бокс "Web".

Регистрация приложения в VK

На втором шаге необходимо добавить ваш домен и URL, которые необходимо скопировать со страницы настроек модуля. В нашем случае домен и URL выглядят следующим образом:

Регистрация приложения Vk шаг 2

После добавления нажимаем кнопку "Готово".

VK перенаправит нас на страницу настроек созданного приложения, на которой нам необходимо скопировать ID-приложения и "Защищенный ключ", скриншот:

Копируем ID-приложения VK и защищенный ключ

Вставляем скопированные значения в настройки модуля:

После добавления нажимаем кнопку "Применить".

Переходим к получению токена для работы, для этого нажимаем кнопку в настройках модуля "Получить токен":

Проходим страницу авторизации:

После получения токена вас должно перенаправить на страницу настроек модуля.

Следующим шагом необходимо выбрать группу для выгрузки "Историй" и выбрать инфоблок для сохранения историй на сайте.

Перед началом импорта необходимо проверить права созданного приложения, для этого необходимо вернуться в VK и проверить "Доступы" у созданного приложения, необходимо открыть "Расширенные права" в пункте "Истории", скриншот:

После внесения настроек на странице модуля можно нажать кнопку "Запустить импорт историй вручную" для первичного импорта.

Внимание, если у вас на странице "Доступы" в приложении висит вот такое предупреждение:

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

После открытия доступов возвращаемся в модуль и нажимаем "Запустить импорт историй вручную".

Инструкция по интеграции 1С-Битрикс с сервисом Webjack

2024-02-01T21:43:45.088Z

Инструкция по интеграции сайтов на 1С-Битрикс с платформой интеграций Webjack, используя модуль "Webjack — интеграция с инфоблоками, веб-формами и почтовыми событиями".

Сервис Webjack позволяет без программистов выполнить интеграцию с основными популярными CRM и так же отправить данные в Telegram или например Google Таблицы. У сервиса есть бесплатный демо период в 5 дней, у модуля есть тестовый период в 14 дней, чего достаточно для настройки тестовых интеграций и проверки работы. Приступим к описанию основных шагов, необходимых для настройки.

Модуль устанавливается из маркетплейса Битрикс и не требует какой-то дополнительной настройки. Необходимо установить модуль на сайт через админ-часть сайта или используя маркетплейс с вводом адреса сайта в форме.

В примерах ниже рассмотрим несколько вариаций использования данной связки: отправка веб-формы, отправка формы из инфоблока и создание заказа в интернет-магазине.

Для начала необходимо зарегистрироваться в сервисе Webjack после регистрации вы попадете на страницу "Обработки", на которой необходимо справа нажать на кнопку "Создать". Скриншот:

Создание первой обработки в сервисе Webjack

Вводим название обработки, понятное для вас и нажимаем на кнопку "Сохранить". Далее нас перенаправит на общую страницу настроек обработки. Для того чтобы начать получать данные необходимо изначально создать источник данных. Скриншот:

Добавление источника данных

На странице выбора "Источника данных" находим пункт: "Запрос (Webhook)" и выбираем его. Скриншот:

Выбираем источник данных "Запрос (Webhook)"

После выбора нам необходимо выбрать HTTP-метод "POST", остальные поля необходимо заполнять только если у вас есть какие-то свои ограничения или кастомные настройки. После выбора метода нажимаем на кнопку "Сохранить". Скриншот:

Выбор HTTP-метода запроса

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

Проверка добавленного источника данных в сервисе Webjack

Далее нам необходимо создать действие, скриншот:

Добавление первого действия в сервисе

Выбираем тип действия "JSON" - Парсер, скриншот:

Выбор действия JSON - Парсер

Далее необходимо заполнить настройки, с помощью которых данные переданные с сайта на CMS 1C-Bitrix, будут обработаны сервисом для дальнейшей передачи.

Пример заполнения данных для форм на сайте, у которых есть поля: "Имя", "Телефон", "E-mail", "Комментарий". Скриншот:

Приведем ниже настройки в виде текста:

Имя - ["NAME"]

Телефон - ["PHONE"]

Почта - ["EMAIL"]

Комментарий - ["PROP_MESSAGE"]

Обратите внимание на правый столбец "Действие при отсутствии". Если вам нужны строгие права валидации получаемых данных, тогда необходимо выбрать чек-бокс "Прервать обработку", иначе выставляем чек-боксы как на скриншоте с пунктом "Вернуть пустое значение". Соответственно при таком значении, если в присланном JSON, не будет данных в любом из пунктов, то обработка все равно завершится и данные отправятся далее. После внесения всех настроек нажимаем на кнопку "Сохранить".

Следующим пунктом приведем телефон к одному виду, для того чтобы все телефоны имели у нас одинаковый вид. Для этого необходимо добавить еще одно действие: "Добавить действие" - "Преобразования" - "Номер телефона". Скриншот:

Добавление преобразования номера телефона

На следующей вкладке необходимо заполнить следующими настройками, скриншот:

Кроме того на данной вкладке вы можете сделать собственные преобразования номера телефона, которые требуются именно вам.

На этом первичная настройка получаемых данных в сервисе закончена и можно переходить к настройке отправки данных на примере amoCRM.

Для того чтобы создать сделку в amoCRM, нам необходимо изначально создать контакт, а следующим действием создать сделку.

Создадим новое действие: "Добавление контакта в amoCRM", скриншот:

После добавления необходимо авторизоваться в AmoCRM, и заполнить поля для создания контактов. Кроме того можно сразу выбрать обработку дублей, как создавать ID и что использовать в виде имени контакта. Скриншот первых настроек:

Ниже в настройках выбираем поля "Телефон" и "E-mail", скриншот:

После чего нажимаем на кнопку "Сохранить". На этом создание действия с добавлением контакта в AmoCRM завершено. И можно переходить к действию "Создание сделки".

Переходим к добавлению нового действия: "Добавить" - "AmoCRM" - "Добавление сделки в AmoCRM". На страницах настроек выбираем уже авторизованную AmoCRM, и заполняем настройки:

После внесения настроек нажимаем на кнопку "Сохранить".

Если в ваших формах есть поле "комментарий" или вы хотите добавить какую-то собственную информацию, которую необходимо записать в "Примечание" к сделке, вам в таком случае необходимо добавить еще одно действие. Если этого не требуется, то вы можете пропустить следующий шаг.

Добавляем новое действие: "Добавить" - "AmoCRM" - "Добавление примечания в AmoCRM" и добавляем следующие настройки (на примере поля комментарии у формы):

Приведенный пример выше на скриншоте показывает как добавить поле "комментарий" в примечание к сделке. Вы так же можете изменить данные настройки под ваши требования.

На этом настройка в сервисе Webjack завершена и нам необходимо теперь внести настройки в модуль в админ-части сайта.

Для этого переходим по пути: "Настройки" - "Настройки модулей" - "Интеграция с сервисом WebJack". На странице настроек у нас есть несколько типов настроек, мы можем отправлять данные по одному url в Webjack, либо отдельно для каждого типа события.

Скриншот:

URL для отправки необходимо скопировать со страницы "Обработки" в сервисе Webjack и вставить в поле "Адрес для HTTP-запроса". Здесь вы можете сделать как отдельные так и общие. Наш пример покажем на основе общего одного URL. После вставки URL-адреса необходимо нажать "Применить" на странице настроек.

После добавления URL-адреса необходимо выбрать веб-формы или инфоблоки куда записываются заявки с форм сайта. Скриншот:

Можно выбрать как отдельно какой-то один пункт, или выбрать сразу несколько, если допустим у вас формы работают как на инфоблоках, так и на веб-формах. После выбора необходимо сохранить.

На этом настройки завершены и осталось только включить обработку в сервисе Webjack, скриншот:

После включения можно начинать тестировать отправку форм и проверять результат обработки как в сервисе Webjack, так и в amoCRM.

В сервисе Webjack есть раздел "Журнал операций" куда будут записываться последние операции и их статус. Покажем на примере:

Если при обработке возникли проблемы, вы можете открыть любую операцию и посмотреть статусы, которые будут описаны в сервисе.

По всем вопросам касающихся интеграции Webjack с сайтом на 1С-Битрикс вы можете писать нам на почту: info-sam24@yandex.ru.

Инструкция по настройке модуля маркировки саморекламы на сайтах 1С-Битрикс

2024-01-24T20:54:47.553Z

Данная инструкция предназначена для модуля ОРД API - маркировка рекламы на сайте. Посмотреть модуль на маркетплейсе 1С-Битрикс можно по ссылке.

После установки модуля из маркетплейса переходим по пути: “Сервисы” - “ОРД API” - “ОРД-профили” нажимаем на кнопку “Добавить ОРД-Профиль”.

Откроется окно добавление названия профиля и Токена.

Вписываете свое понятное для вас название (оно используется только в админ-части), и переходим к получению токена.

Для получения токена необходимо иметь зарегистрированный аккаунт в Яндексе.

Внимание! Под данным аккаунтом будут передаваться данные в ОРД, соответственно сделать либо отдельный аккаунт для передачи, либо использовать уже созданные корпоративные.

Для получения токена необходимо зарегистрироваться в кабинете ОРД Яндекса: https://ord.yandex.ru/cabinet (ссылка доступна на странице добавления профиля).

На открытой ссылке проверьте что зашли под нужным аккаунтом, согласитесь с условиями и нажмите "Войти в кабинет ОРД"

После перехода вы попадете в основной кабинет ОРД. Далее необходимо выдать доступ к API. Подробную инструкцию по выдаче доступов от имени организации или выдаче доступов другому пользователю можете посмотреть на странице справки: https://yandex.ru/support2/ord/ru/api/connect ниже расскажем как выдать доступы самому себе, для этого нужно сделать несколько действий:

В левом меню перейдите в раздел Настройки → Пользователи и роли. В правом верхнем углу нажмите Открыть доступ к API;
В левом меню перейдите в раздел Настройки → Пользователи и роли → Получить токен для API;
На странице авторизации Яндекс ID разрешите доступ для сервиса «API Яндекс.ОРД». Для этого нажмите кнопку Войти как <имя пользователя>. Проверьте, что вы находитесь именно под тем аккаунтом, на который выдан доступ к API;
Скопируйте и вставьте токен для использования в модуле.

После вставки токена профиль должен выглядеть подобным образом:

После проверки нажимаем кнопку “Сохранить”.

Переходим к следующему пункту “Организации/контрагенты”. После перехода нажимаем “Добавить контрагента” и выбираем “ОРД-Профиль” - Яндекс.

В поля вписываем организацию или данные частного лица, поля у которых написано в скобках “для иностранных физлиц и юр.лиц” резидентам РФ заполнять не надо.

Пример заполнения для ИП:

Пример заполнения для ООО:

Заполнив организацию нажимаем кнопку “Сохранить” и переходим к добавлению площадки.

Переходим на вкладку “Рекламные площадки” и нажимаем кнопку “Добавить площадку”. На следующем шаге выбираем организацию, которую мы добавили на предыдущем шаге, заполняем 2 поля и ставим чек-бокс: “Площадка принадлежит контрагенту”.

Сохранив, нам необходимо вернуться на вкладку: “Организации/контрагенты” зайти в добавленную организацию и поставить чек-бокс: “Является рекламораспространителем (РР)”.

Скриншот:

После этих шагов мы подготовили модуль к передаче юр. данных и данных сайта в ОРД Яндекса. Переходим к подготовке креативов.

Модуль работает с элементами инфоблока, для его работы нам необходимо выполнить небольшие действия со свойствами инфоблока.

Для этого перейдем в настройки инфоблока, элементы которого необходимо маркировать и добавим два свойства, со следующими параметрами:

Первое свойство:

Название: «ОРД токен»

Тип: «Строка»

Код: «SAM_ORD_ERID»

Обязательное: «Нет»

Второе свойство:

Название: “Рекламный баннер”

Тип: “Простой чекбокс (число)”

Код: “IS_ADV”

Обязательное: “Нет”

Скриншот настроек инфоблока:

Данные настройки необходимо выполнить для всех инфоблоков, элементы которых необходимо маркировать.

После добавления свойств в инфоблоке переходим к созданию профиля в модуле по следующему пути: “Сервисы” - “ОРД API” - “Профили инфоблока”.

Нажимаем кнопку “Добавить профиль” и заполняем данные:

На данной странице необходимо выбрать инфоблок, в котором на прошлом шаге мы добавили свойства, остальные параметры указаны на скриншоте. Нажимаем кнопку “Далее”.

На следующей странице необходимо заполнить данные:

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

Остальные поля заполняем согласно скриншоту. После заполнения полей нажимаем кнопку “Далее”.

На последнем шаге нам осталось только задать правила фильтрации элементов, которые подлежат маркировке.

Нажимаем “Добавить фильтр” после чего можем создать как произвольные условия отбора элементов для маркировки, так и использовать созданное нами ранее свойство инфоблока.

Ниже пример фильтра с использованием созданного свойства:

После добавления фильтра необходимо нажать кнопку “Сохранить”.

На этом настройки модуля закончены. Необходимо перейти в инфоблок с элементами и добавить чек-боксы тем элементам, которые необходимо маркировать.

Покажем на примере исходя из наших условий, что мы добавили проверку на свойство “Рекламный баннер”.

Скриншот элемента:

После добавления чек-бокса “Рекламный баннер” нажимаем кнопку “Применить”. После этого в поле “ОРД токен” должен добавиться сам токен, что означает что модуль отправил.

Скриншот с полученным токеном и заполненным erid в ссылке:

Последним шагом является включение сбора статистики показов слайдеров. Для этого необходимо перейти по пути: “Сервисы” - “ОРД API” - “Настройки модуля” и включить чек-бокс: “Включить фиксирование показов”.

Скриншот:

Кроме полученных токенов в ссылках, можно добавить аннотацию к элементам с информацией о юр лице и добавлением erid в всплывающем окне.

По примеру приведем код для любого шаблона или решения:

<?if($arItem['PROPERTIES']['SAM_ORD_ERID']['VALUE'] <> '' && \Bitrix\Main\Config\Option::get('sam.ord', 'IS_TIPPY', 'N') === 'Y'):?>

<button class="samord-tippy-init" width="24" height="24" data-content="Реклама: Название_компании<br> erid: <?=$arItem['PROPERTIES']['SAM_ORD_ERID']['VALUE']?>" data-sam-ord-erid="<?=$arItem['PROPERTIES']['SAM_ORD_ERID']['VALUE']?>">

<svg width="8" height="20" viewBox="0 0 8 20">

<circle cx="4" cy="4" r="1.5"></circle>

<circle cx="4" cy="10" r="1.5"></circle>

<circle cx="4" cy="16" r="1.5"></circle>

</svg>

</button>

<?endif;?>

Если у вас остались вопросы или вам требуется помощь с настройкой, вы всегда можете обратиться к нам по нашей почте: info-sam24@yandex.ru