Заметки
Как отличить входящий вебхук, исходящий вебхук и OAuth-приложение
Входящий вебхук позволяет вашей системе вызывать REST Bitrix24. Секрет находится в URL, а действия выполняются в пределах прав его владельца и разрешённых разделов.
Исходящий вебхук делает обратное: Bitrix24 сообщает вашему обработчику о выбранном событии. Сам факт получения такого запроса не превращает его в постоянный ключ для любых последующих REST-вызовов.
OAuth-приложение имеет установку, набор scope и токены доступа. Оно подходит, когда нужны интерфейс, события и управляемая авторизация на одном или нескольких порталах. Токены и данные установки нужно хранить по порталам, не смешивая их.
Для одного серверного скрипта может хватить входящего вебхука. Для реакции на событие нужен принимающий обработчик. Для встройки в карточку и более сложного жизненного цикла обычно выбирают приложение. Эти механизмы можно сочетать, но у каждого должна оставаться понятная роль.