Получение данных по HTTP-запросу Добавление контакта в CRM Bitrix

Интеграция

Получение данных по HTTP-запросу Добавление контакта в CRM Bitrix

В этой инструкции настроим связку HTTP-вебхук → контакт Bitrix24: приём входящих HTTP-запросов и разбор JSON, создание контакта в Bitrix24. Ниже — шаги по порядку, с примерами.

Отдельные инструкции: источник «Получение данных по HTTP-запросу» · действие «Добавление контакта в CRM Bitrix»

Создание подключений

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

Подключение Bitrix24

Приложение в маркетплейсе

Перед подключением через OAuth установите приложение Webjack в маркетплейсе Bitrix24 для своей страны:

Создание подключения

  1. В меню слева выберите «Подключения».
  2. Нажмите «+».
  3. Выберите тип «Bitrix» и нажмите «Выбрать».
  4. В поле «Сайт» укажите адрес портала Bitrix24, например https://company.bitrix24.ru.
  5. В поле «Регион» выберите способ подключения.

Регион «Россия», «Беларусь» или «Казахстан»

  1. Убедитесь, что приложение для этой страны уже установлено в портале.
  2. В поле «Регион» выберите «Россия», «Беларусь» или «Казахстан».
  3. При необходимости включите «Использовать постоянные IP».
  4. Нажмите «Подключить» и авторизуйтесь в Bitrix24 под администратором портала.
  5. После успешной авторизации подключение появится в списке.

Регион «Webhook»

Используйте этот способ, если приложение из маркетплейса установить нельзя - например, на коробочном Bitrix24.

  1. В Bitrix24 создайте входящий вебхук с правами CRM.
  2. Скопируйте URL вебхука для вызова REST API.
  3. В поле «Сайт» вставьте этот URL.
  4. В поле «Регион» выберите «Webhook».
  5. При необходимости включите «Использовать постоянные IP».
  6. Нажмите «Подключить».

Создайте обработку

В левом меню откройте «Обработки» и нажмите «+».

processing-01.png

В списке типов источника выберите «HTTP» и нажмите кнопку «Выбрать».

Источник «HTTP»

Приём входящих HTTP-запросов (вебхуков) на уникальный URL. В источнике выберите метод, настройте ответ и при необходимости укажите параметры и заголовки для разбора входящего запроса.

Метод и ответ

  1. В поле «HTTP-метод» выберите метод, который нужно принимать, или оставьте «Любой».
  2. При необходимости задайте ответ отправителю: «Код статуса ответа», «Текст статуса ответа», «Заголовки ответа» и «Тело ответа».
  3. Нажмите «Сохранить».
    source_http2.png

URL приёма

  1. Откройте вкладку «Источник данных».
  2. Скопируйте «URL» - на этот адрес нужно отправлять HTTP-запросы из внешней системы.
    source_http3.png

Параметры и заголовки

  1. В блоке «Параметры» нажмите «Добавить параметр», укажите «Название» и «Приоритет» («Строка запроса» или «Тело запроса»).
  2. В блоке «Заголовки» при необходимости нажмите «Добавить заголовок» и укажите «Название».
  3. Нажмите «Сохранить».

Действие «Добавление контакта в CRM Bitrix»

В Bitrix24 создаётся контакт с именем и контактными данными из сценария. Выберите подключение и заполните поля карточки.

Перейдите в обработке во вкладку "Действия" и нажмите на кнопку "Добавить действие"
wj2-action-create-01.png

Подключение

  1. В поле «Подключение» выберите подключение Bitrix.

Параметры контакта

  1. Заполните «Имя», при необходимости «Отчество» и «Фамилия».
  2. Укажите «Телефон» и «Email» или подставьте переменные из сценария.
  3. При необходимости заполните «Ответственный», «Комментарий» и «Источник».
  4. При необходимости настройте «Обработка дубликатов» и «Выбирать дубль по макс. ID».
  5. Нажмите «Сохранить».

Запустите обработку

  1. В обработку начнут поступать данные из настроенного источника.
  2. По очереди выполнятся все добавленные действия.
  3. Входящие данные, статус и история отобразятся в «Истории операций».

vk-ads-02.png