← К заметкам

Заметки

Как отличить входящий вебхук, исходящий вебхук и OAuth-приложение

Входящий вебхук позволяет вашей системе вызывать REST Bitrix24. Секрет находится в URL, а действия выполняются в пределах прав его владельца и разрешённых разделов.

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

OAuth-приложение имеет установку, набор scope и токены доступа. Оно подходит, когда нужны интерфейс, события и управляемая авторизация на одном или нескольких порталах. Токены и данные установки нужно хранить по порталам, не смешивая их.

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