Переход с Chatra
JS API Связио совместим с Chatra по названиям: большинство настроек и методов переносятся заменой префикса. Поменяйте код установки и названия объектов:
| Было в Chatra | Стало в Связио |
|---|---|
window.ChatraID = '…' | orgId в SvyazioConfig |
window.ChatraSetup = { … } | window.SvyazioSetup или window.SvyazioConfig |
window.ChatraIntegration = { … } | window.SvyazioIntegration |
Chatra('метод', …) | Svyazio('метод', …) |
код установки Chatra | код из Настройки → Установка |
Работают без изменений: buttonPosition, buttonSize, customWidgetButton, chatWidth, chatHeight, zIndex, colors, startHidden, mobileOnly, disabledOnMobile, groupId, onNewMessage, onAnalyticEvent, deferredLoading, disableChatOpenHash и методы openChat, expandWidget, minimizeWidget, hide, show, setButtonPosition, resetButtonPosition, setButtonSize, setChatWidth, setChatHeight, setZIndex, setColors, resetColors, pageView, setIntegrationData, updateIntegrationData, setLocale, restart, kill. Ссылка #chatraChatExpanded превращается в #svyazioChatExpanded. ID организации и ID отделов — новые, из панели Связио.
Чего нет или что работает иначе
| В Chatra | В Связио |
|---|---|
buttonStyle: 'tab' | Кнопка всегда круглая. |
mode и injectTo | Встраивание чата в блок страницы не поддерживается — виджет всегда плавающий. |
clientId | Не поддерживается. Передавайте данные посетителя через setIntegrationData. |
language | Работает как синоним locale — переписывать не обязательно. В новых интеграциях используйте locale: 'en'. |
locale (объект) | Заменяются шесть надписей — список в разделе «Язык и тексты». Остальные ключи файла локали Chatra игнорируются. |
setGroupId | Отдел закрепляется при загрузке страницы — см. описание метода и рецепт смены отдела. |
gaTrackingId, yaCounterId, disableGaTracking, disableYaTracking | Виджет сам в счётчики не пишет. Передавайте события через onAnalyticEvent — пример в разделе «События». |
sendAutoMessage | Убран из соображений безопасности: посетитель мог вызвать его из консоли и показать себе «сообщение оператора». Сообщения по условиям — Настройки → Автоматизация. |
NPM-пакет | Виджет подключается кодом установки. |
Только в Связио: оформления (skin, setSkin), тёмная тема (theme), фирменный цвет accentColor, тексты страницы (headerText и другие), большой режим окна (setExpanded) и setLanguage.