WEB SDK позволяет дорабатывать amoCRM путем внедрения пользовательских скриптов и стилей, в терминологии системы мы называем эту возможность – "виджеты".
Виджет – это архив с JS, CSS файлами, а также файлами шаблонов Twig, который может быть загружен в интеграцию. В таком случае JS файлы и верстка будет подгружена в браузер вместе с интерфейсом amoCRM, что даст возможность интегратору взаимодействовать с пользователем, взаимодействовать с API amoCRM или API собственного сервиса непосредственно из интерфейса amoCRM.
Виджеты могут работать как постоянно (с момента загрузки страницы и не прекращать свою работу, такие виджеты имеют флаг "init_once"), так и включаться в определенные моменты в указанных интерфейсах системы, эти определенные интерфейсы мы называем "области подключения" или "locations".
Области подключения представляют из себя по сути перечисление мест интерфейса, где будет выполнен колбэк виджета, а виджет уже на своей стороне решает какую логику для данного колбэка выполнить. Более подробное описание работы каждой области подключения можно почитать по соответствующей ссылке в таблице ниже, но для начала давайте рассмотрим что из себя представляет минимальный виджет и разберемся с механикой работы.
Список возможных областей подключения:
| Значение | Описание |
|---|---|
| lcard, cucard, ccard, comcard | Карточки сделок, покупателей, контактов и компаний |
| llist, culist, clist, tlist | Списки сделок, покупателей, контактов и задач |
| tline, tcalendar | Разделы задач в виде канбан и календаря, на данный момент используются для работы виджета в модальном окне синхронизации задач |
| settings | Cтраница установки и настройки виджетов |
| advanced_settings | Собственная страница расширенных настроек виджета |
| card_sdk | Добавляет собственную вкладку в левой части карточки (требует lcard, ccard, comcard для работы соответствующих сущностях) |
| catalogs | Позволяет изменять внешний вид карточки элемента сущности "Списки" |
| digital_pipeline | Триггеры в Digital Pipeline |
| lead_sources | Источники сделок в Digital Pipeline |
| whatsapp_modal | Модальное окно интеграций, работающих с WhatsApp |
| everywhere | Виджет будет инициализироваться в любой из перечисленных областей видимости: lcard, cucard, ccard, comcard, llist, culist, clist, tlist. |
