Возможности

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.