Настройки профиля интеграции с Битрикс24 на вебхуках

Если у вас установлен модуль интеграции веб-сайта с CRM Битрикс24 на вебхуках, то в административном интерфейсе в списке меню Сервис должен быть доступен блок Scoder: Вебхуки. Профили интеграции (Сервисы - Scoder: Интеграция сайта с CRM Битрикс24 на вебхуках - Профили). Необходимо зайти в этот блок и добавить профиль, который будет являться профилем интеграции вашего интернет ресурса с Битрикс24. 

Чтобы корректно настроить профиль, нужно достаточно хорошо знать объекты CRM (или иных интересуемых Вас сущностей в Битрикс24) и их поля. Пример заполнения полей:

Для настройки  

• Название - название профиля.
• Вебхук для вызова rest api - обязательное поле, необходимо создать входящий вебхук в Битрикс24 - в меню вашего Битрикс24 выбрать пункт Разработчикам, далее Другое, далее Входящий вебхук (более подробно на официальной странице поддержки  Готовые сценарии вебхуков для разработчиков). В данное поле нужно указать соответствующее поле из карточки редактирования вебхука. Свойства вебхука должны быть следующие: "Генератор запросов" - profile, "Настройка прав" - CRM, остальное оставляем по умолчанию.
• Объект на сайте - обязательно указать один из вариантов:
  • элементы инфоблока (возможны варианты с полями торгового каталога и с ценой),
  • пользователи,
  • заказы,
  • почтовые события - нельзя недооценивать этот метод: любые события на сайте, которые сопровождаются стандартными почтовыми событиями можно перехватить и отправить в Битрикс24. Возможно и те объекты, что нужны вам Это могут быть:
    • отзывы
    • вопросы
    • результаты форм обратной связи
    • регистрация пользователей
    • создание заказа
    • смена статусов заказа
    • оплата
    • заказать звонок
    • и многое другое...
  • произвольный post или get запрос.
• Дополнительный идентификатор объекта на сайте -  ИД инфоблока, если это выбранный объект на сайте - элементы инфоблока, или код типа почтового события, если выбраны почтовые события.
• Объект в Битрикс24- обязательное поле, доступны значения:
  • лид (LEAD),
  • контакт (CONTACT),
  • контакт + сделка,
  • контакт + компания,
  • контакт + компания + сделка,
  • компания (COMPANY),
  • компания + сделка,
  • сделка (DEAL),
  • товары CRM,
  • элементы смарт-процесса,
  • другое - универсальный метод, если вы планируете создавать иной объект в Битрикс24.
  • идентификация / редактирование / добавление - универсальный метод, связка рест-методов:
    • .list,
    • .update,
    • .add.

    Позволяет идентифицировать объект в Битрикс24 по заданным признакам, если находит, то редактирует, если нет, то добавляет.

    С каким объектом будет работать профиль необходимо обязательно указать в поле Метод rest / Объект. Например:

    • crm.lead
    • tasks.task
    • sale.property.
    • и многое другое. Доступные методы указаны в официальной документации - Документация по REST. Объект, с которым проводится работа, должен поддерживать методы: list, update и add, т.е. например: crm.lead.list, crm.lead.update, crm.lead.add.

• Метод rest / Объект- необходимо указать метод rest-апи, обязательное поле, если выбран собственный объект в Битрикс24. например:
  • crm.lead.add.json,
  • crm.contact.add.json,
  • crm.company.add.json.
• Поля объекта в Битрикс24 - обязательное поле, в каждой строке указываются соответствующие поля или пользовательские поля объекта CRM. Если возникли сложности, напишите нам (чат для связи с нами в правом нижнем углу экрана). Такие необычные поля как телефон, e-mail, сайт, мессенджер имеют еще свой тип, например: рабочий, мобильный, корпоративный и тому подобные. Для них заложили возможность также указать код типа, например PHONE_MOBILE, EMAIL_HOME и т.д. А если просто указать "PHONE","EMAIL","WEB","IM", то будет тип по умолчанию (первый).
• Поля объекта на текучем сайте - обязательное поле, значение или переменные, которые должны передаваться в качестве соответствующих полей объекта в Битрикс24, соответствующие статичные значения (текст, число) и их поля должны совпадать по номеру строк, (см. пример на скрине выше). Например, поле Название лида имеет код TITLE, ему соответствует значение - Лид с сайта #SERVER_HTTP_HOST# из формы #IBLOCK_NAME#. Если возникли сложности, напишите нам (чат для связи с нами в правом нижнем углу экрана). Значения должно соответствовать значению объекта в CRM, особенно это касается таких полей, которые не является строкой, например SOURCE_ID имеет какие то определённые значение WEB, CALL...

Как формируются переменные (макросы) для полей объекта на сайте:

• #IBLOCK_<КОД_ПОЛЯ_ИНФОБЛОКА># - это характеристики инфоблока, который указан в Дополнительном идентификаторе объекта на сайте, доступные поля.
• #ELEMENT<КОД_ПОЛЯ_ЭЛЕМЕНТА_ИНФОБЛОКА># - это основные характеристики элемента инфоблока, доступные поля.
• #PROPERTY_<КОД_СВОЙСТВА># - это значения свойств элемента инфоблока, доступные поля и #PROPERTY_КОД_СВОЙСТВА_VALUE# (значение свойства для элемента), а также для свойств заказа.
  
• #SERVER_<КЛЮЧ_МАССИВА># - ключи глобальной переменной (массива) $_SERVER.
• #<КОД_ПЕРЕМЕННОЙ># - для почтовых событий, пользователей, заказов.

На первый взгляд настройки могут показаться несколько сложными для простого обывателя, если у вас остались вопросы, напишите нам. В рамках технической поддержки мы поможем настроить один экземпляр - профиль интеграции, но не очень объемный по количеству полей, свойств (4-5).

Интеграция Excel, XML, CSV, WordPress, Joomla, OpenCart, MODX, веб-сайта на любой CMS с Битрикс24

Интегрировать можно веб-сайт на любой CMS, например: 1С-Битрикс, CMS.S3, Drupal, WordPress, NetCat и прочие.

Мы предлагаем следующий подход - использовать как буфер для обмена ядро 1С-Битрикс Управление сайтом любой редакции (достаточно редакции Старт), импортировать в инфоблоки нужные нам данные. Т.е. в качестве основного модуля, на который будем опираться - инфоблоки. Нам понадобятся следующие ресурсы:

• Движок 1С-Битрикс редакции Старт + площадка (хостинг), на котором разместить данное ядро.
• Модуль Scoder: Интеграция сайта с CRM Битрикс24 на вебхуках.
• Использовать стандартные возможности 1С-Битрикс для импорта данных в инфоблоки из csv, xlsx (excel), xml, а лучше использовать зарекомендовавшие себя из маркетплейса, например, мы рекомендуем модули наших коллег:  Импорт из Excel,  Импорт из XML и YML,  Экспорт/Импорт товаров в Excel.

Иными словами подход следующий:

• Нужные данные из вашей CMS выгрузить в какой либо файл, например, xml, csv, xlsx.
• Импортировать эти данные из файла в виде элементов инфоблока во вспомогательный сайт на CMS 1С-Битрикс, на котором установлен наш модуль Интеграция сайта с CRM Битрикс24 на вебхуках.
• Настроить профиль соответствия полей и свойств инфоблока с полями объектов (лиды, контакты, сделки, товары CRM) в Вашем Битркис24.

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

Интеграция сайта недвижимости с Битрикс24. Примеры передачи объектов недвижимости в товары CRM или смарт-процессы

В данном материале рассмотрен кейс по передаче объектов недвижимости в CRM Битрикс24

По просьбе клиента необходимо было передать одни и те же в объекты в 2 портала в виде:

• товаров CRM,
• элементов смарт-процесса.

Требования к передаваемым объектам

• Интеграция односторонняя: объекты передаются с веб-сайта в Битрикс24.
• В качестве признака идентификации выбран ИД объекта (элемента инфоблока) на веб-сайте. Т.е. товары которые уже были созданы в Битрикс24 по новой не создаются, а редактируются.
• Часть полей редактируется в Битрикс24, они не должны затрагиваться при синхронизации.
• Передаются: название, символьный код, цена, ссылка на оригинал, картинки и некоторые свойства.

ТОВАРЫ CRM

ЭЛЕМЕНТЫ СМАРТ-ПРОЦЕССА

Дублирование пользователей в инфоблоки на ЦМС 1С-Битрикс

На веб-сайтах типа: доски объявлений, биржи фрилансеров (например  fl.ru), соискателей по трудоустройству есть раздел с информацией о пользователях сервиса. Т.е. вывод ограниченной информации по пользователем в списке и карточке пользователей.

Реализуется это, обычно, двумя способами:

1. Напрямую выводится информация с базы зарегистрированных пользователей.
2. Нужная информация по пользователям дублируется в элементы инфоблока, и выводятся элементы инфоблока.

Первый способ не удобен тем, что очень мало компонентов для работы (вывода) с пользователями, а удобных комплексных компонентов в стандартной поставке и вовсе нет. А если нужна индексация модулем поиска, то это еще дополнительные сложности. Но, если этот способ более по душе, то расстраиваться не стоит, у нас модуль, решающий этот вопрос - Список пользователей с ЧПУ.

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

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

1. Интеграция сайта с CRM Битрикс24 на вебхуках. Конструктор запросов
2. Rest API для БУС. Бэкенд мобильных приложений. Конструктор запросов

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

• Вебхук для вызова rest api - ссылку на страницу, где будет размещен компонент второго модуля , подробнее Установка и настройка компонента scoder:api.
• Объекты на текучем веб-сайте - Пользователь.
• Добавлять/редактировать объекты в Битрикс24 при добавлении объекта на сайте - Да, т.к. необходимо создавать элементы при регистрации пользователей.
• Добавлять/редактировать объекты в Битрикс24 при изменениях объекта на сайте - Да, т.к. нужно модифицировать поля и свойства элементов при модификациях пользователей.
• Объекты в Битрикс24 (или стороннем сервисе) - Идентификация / добавление / редактирование/ удаление (универсальный). Позволяет отправлять в виде произвольных rest-методов.
• Метод rest / Объект - user.duplicate, следовательно модуль будет отправлять запросы по следующим методам: user.duplicate.list.json, user.duplicate.add.json, user.duplicate.update.json, user.duplicate.delete.json при событиях с пользователями на указанный вами адрес.
• На втором шаге соотнести поля поля с нужными полями или свойствами элементов ифноблока, не забыв указать поле для идентификации, у нас это внешний код (XML_ID) и ИД инфоблока.

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

Во всех профилях указать поля:

• Возвращать только массив данных по объекту - Да.
• Если результат один, то возвращать одномерный массив - Да.
• Количество возвращаемых объектов - 1.
• Соответствующий Метод АПИ и Выполняемый метод.

Если все правильно сделали, то должны создаваться элементы инфоблока при добавлении/редактировании пользователей: