Битрикс24 — очень гибкая платформа, позволяющая выполнять интеграцию с большим количеством сторонних сервисов. Штатные возможности интеграции удовлетворяют потребности большинства компаний, а для тех, кому их недостаточно, есть множество других способов организовать работу с внешними ресурсами.
Битрикс24 поддерживает REST API, открывающий широкие возможности кастомизации портала, но они требуют привлечения разработчиков и дополнительных вложений. Если нужно сделать сложную интеграцию, которая будет задействовать большое количество разных переменных, то без этого не обойтись, а если требуется что-то более простое, то помогут вебхуки.
Какие бывают вебхуки
Вебхуки позволяют выполнять простые интеграции со сторонними системами, не используя программирование, но при этом получая стабильный и гарантированный результат. По принципу работы они подразделяются на входящие и исходящие:
- входящий вебхук — активируется, если к порталу был запрос по специальной ссылке, сгенерированной заранее;
- исходящий вебхук — выполнение определенного события инициирует отправку данных на заданный адрес, где они могут дальше обрабатываться.
Такая автоматизация позволяет реализовать различные сценарии использования вебхуков для повышения эффективности работы портала, при этом не привлекая программистов и не вкладывая дополнительные денежные средства — потребуется лишь время, чтобы самостоятельно разобраться и все настроить.
Использование вебхуков имеет свои особенности, о которых нужно помнить:
- ключи доступа не имеют срока годности — потеря ключа означает потерю контроля над функционалом вебхука;
- возможности этой технологии ограничены — эти ограничения вызваны особенностями REST и обойти их не получится;
- в облачной редакции портала есть лимит на частоту запросов — он не должен превышать 2 запроса в секунду.
В коробочной версии Битрикс24 ограничений по частоте запросов нет, но все остальные — сохраняются.
Создание вебхуков
В основном меню портала, расположенном в левой части страницы, выберите вкладку «Разработчикам», а затем — «Другое». Откроется раздел, содержащий карточки «Локальное приложение», «Исходящий вебхук» и «Входящий вебхук» — выбирайте нужную.
Входящий
Открыв страницу, вы увидите предупреждение об ответственности, а чуть ниже — поле с названием «Вебхук для вызова REST API». В нем содержится часть ссылки, включающая в себя уникальный ключ. Если он по каким-то причинам вам не нравится, то можно создать новый, нажав кнопку «Перегенерировать», но при этом все, что было настроено на текущий вебхук, перестанет работать.
Важно: Помните, что чужие ключи недоступны никому, даже администратору портала. Если администратор попытается внести изменения в чужой вебхук, то все настройки будут сброшены, а он станет владельцем этой интеграции.
Ниже расположен «Генератор запросов», позволяющий сконфигурировать сам вебхук, выбирая нужные значения из выпадающих списков: выбрать метод REST API — по расположенным рядом ссылкам доступны подробные описания и примеры — и указать права доступа. При необходимости можно добавить дополнительный параметр, нажав на «+ добавить параметр» — все изменения динамически отображаются в ссылке, которая будет использоваться для работы вебхука.
В результате всех манипуляций, в поле «URL» будет находиться ссылка, позволяющая активировать действие, соответствующее заданным настройкам — ее работу можно проверить тут же, нажав размещенную под ней кнопку «Выполнить». Теперь осталось переименовать вебхук — для этого поднимитесь вверх страницы и нажмите значок карандаша. Не забудьте сохранить внесенные изменения.
Исходящий
Настройка исходящего вебхука выполняется в несколько шагов. Первым делом отредактируйте название, а затем внесите данные в предлагаемые поля:
- URL обработчика — укажите web-адрес, на который будет необходимо отправлять данные;
- События — выберите одно или несколько событий для запуска вебхука.
Настройка обработчика выполняется на стороне, принимающей данные. Ключ авторизации, размещенный в поле «Токен приложения», необходим для подтверждения личности портала — так обработчик поймет, что именно этот портал отправил данные.
Готовые сценарии
Стремясь максимально упростить и сделать комфортным использование портала Битрикс24, разработчики не ограничились простой возможностью работы с вебхуками, а добавили множество готовых сценариев, содержащих различные интеграции и доработки — они доступны в разделе главного меню «Разработчикам».
На странице находятся карточки, которые распределяют все сценарии по группам:
- импорт и экспорт данных — дает возможность импортировать и экспортировать контрагентов, а также реализовать другие сценарии;
- интеграция с внешними сервисами — позволяет синхронизировать контрагентов или добавлять лиды;
- автоматизация продаж — доступна настройка автоматического продвижения лида или сделки по воронке продаж;
- автоматизация управления — можно автоматизировать нотификации или разместить отчет в живой ленте;
- виджеты — кастомизация интерфейса портала;
- работа с чат-ботом — оповещение сотрудников в чате, передача сообщений в чат-бот.
Эти сценарии уже настроены для использования. Все созданные интеграции доступны по пути «Разработчикам» / «Интеграции» — отсюда ими можно управлять: настраивать и удалять.
Краткие итоги
Более 11 лет мы помогаем бизнесу повышать эффективность своей работы, автоматизируя и оптимизируя бизнес-процессы в Битрикс24. Вебхуки — один из способов автоматизации, позволяющий повысить скорость и точность процессов, расширить стандартные возможности портала Битрикс24.
Если настройка показалась сложной и вы не смогли разобраться — позвоните или напишите нам. Мы можем настроить как штатный функционал, так и внести любые доработки, необходимые именно под ваш бизнес. Мы решаем задачи любой сложности.
