Просмотров: 18574 (Статистика ведётся с 06.02.2017)

WebHooks - упрощенный вариант rest-событий и rest-команд, без написания приложения.

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

Для быстрой связи конкретного портала Битрикс24 с конкретной внутренней системой, отдельно взятой формой обратной связи или для трансляции в Живую ленту отчетов из своей складской системы удобнее использовать Вебхуки.

На странице Приложения > Вебхуки можно создать входящие и исходящие вебхуки.

Создание Входящего вебхука

  1. В выпадающем меню Добавить вебхук выберите Входящий вебхук.
  2. В открывшейся форме заполните поля:
    • Название и Описание - произвольные данные.
    • Права доступа - укажите, к каким модулям вебхук должен иметь доступ. Доступен множественный выбор.
  3. После сохранения появится код для авторизации вебхука:

    Внимание! Данный код является конфиденциальной информацией. Его необходимо держать в секрете.
  4. Вместе с кодом будет представлен образец URL, который нужно использовать при отправке данных из сторонней системы в Битрикс24:
    https://********.bitrix24.ru/rest/1/83te1pjdphsa9u15/profile/
    где:
    • ******** - имя вашего портала;
    • /rest/ - указание системе на то, что данный адрес относится в вебхукам;
    • /1/ - идентификатор пользователя, создавшего вебхук. Под правами этого пользователя будет работать этот вебхук.
    • /83te1pjdphsa9u15/ - секретный код;
    • /profile/ - метод REST, который вы хотите выполнить, обращаясь к вебхуку. Разработчик должен сам подобрать метод из REST API в зависимости от целей создания вебхука.
  5. Обратиться из сторонней системы по указанному адресу на Битрикс24.

    Рассмотрим пример такого обращения с задачей создать лид из формы. Надо сформировать URL в переменной $queryUrl, сформировать параметры для создания лида в переменной $queryData и после подготовительных шагов как раз и обратиться к Битрикс24 при помощи функции curl_exec. Полученный в виде JSON результат обработан:

    Пример кода обращения к Битрикс24

Создание исходящего вебхука

  1. В выпадающем меню Добавить вебхук выберите Исходящий вебхук.
  2. В открывшейся форме заполните поля:
    • Адрес обработчика - страница на стороннем ресурсе, куда будет обращаться вебхук.
    • Название и Описание - произвольные данные.
    • Тип события - нужно указать событие, на которое будет инициализироваться вебхук.
  3. После сохранения вебхука будет выведен Код авторизации в виде строки из случайных знаков. Этот код позволит внутри обработчика проверить, действительно ли обработчик вызван вашим Битрикс24.
  4. На странице обработчика размещаем код:

    Пример кода обработчика для события ONCRMDEALUPDATE



6


Курсы разработаны в компании «1С-Битрикс»