WEB SDK позволяет дорабатывать amoCRM путем внедрения пользовательских скриптов и стилей, в терминологии системы мы называем эту возможность – “виджеты”.

Виджет – это архив с JS, CSS файлами, а также файлами шаблонов Twig, который может быть загружен в интеграцию. В таком случае JS файлы и верстка будет подгружена в браузер вместе с интерфейсом amoCRM, что даст возможность интегратору взаимодействовать с пользователем, взаимодействовать с API amoCRM или API собственного сервиса непосредственно из интерфейса amoCRM.

Виджеты могут работать как постоянно (с момента загрузки страницы и не прекращать свою работу, такие виджеты имеют флаг “init_once”), так и включаться в определенные моменты в указанных интерфейсах системы, эти определенные интерфейсы мы называем “области подключения” или “locations”.

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

Список возможных областей подключения: