Если у вас еще нет amoCRM
Создать прямо сейчас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. |