Все параметры конфигурации виджета: внешний вид, тексты, язык, поведение, маршрутизация, события.
Параметры конфигурации
Параметры задаются в объекте SvyazioConfig в коде установки — до того, как загрузится svyazio.js. Любой параметр необязателен, кроме orgId. Всё, что указано здесь, действует только на этой странице и главнее настроек из панели управления.
Код установки со всеми группами параметров
<script>(function(d, w, c){
w.SvyazioConfig ={orgId:"ВАШ_ORG_ID",serverUrl:"https://app.svyazio.ru",// внешний видskin:"aurora",accentColor:"#0F8770",buttonPosition:"br",chatWidth:380,// тексты этой страницыheaderText:"Отдел продаж",welcomeText:"Подберём тариф и ответим на вопросы по оплате.",// поведениеdeferredLoading:true,groupId:"ID_ОТДЕЛА_ПРОДАЖ",// событияonNewMessage:function(message){console.log("Новое сообщение:", message.text);}};
w[c]= w[c]||function(){(w[c].q = w[c].q ||[]).push(arguments);};var s = d.createElement('script');
s.async=true;
s.src ='https://app.svyazio.ru/widget/svyazio.js';if(d.head) d.head.appendChild(s);})(document,window,'Svyazio');</script>
Обязательный
Параметр
Тип
Что делает
orgId
string
ID вашей организации. Уже подставлен в код установки (Настройки → Установка). Без него виджет не запускается.
Внешний вид
Параметр
Тип
По умолчанию
Что делает
skin
'classic''aurora''soft'
из панели
Оформление виджета. Неизвестное значение игнорируется — остаётся оформление из панели (Настройки → Виджет).
theme
'light''dark'
из панели, иначе как в системе
Светлая или тёмная тема окна. Определяется один раз при загрузке страницы.
accentColor
string
из панели
Фирменный цвет: кнопка, шапка, сообщения посетителя. Только HEX из шести цифр — #0F8770. red и rgb() виджет не принимает и красится в запасной #6C5CE7; короткая запись #0a7 проходит проверку, но ломает градиент кнопки (см. «Цвет не применился»).
Где стоит кнопка чата — один из девяти кодов, таблица ниже. Окно открывается рядом с кнопкой.
buttonSize
number
60
Диаметр кнопки чата в пикселях.
chatWidth
number
400
Ширина окна чата, px. Минимум 280. На экранах до 600 px окно всегда открывается на весь экран.
chatHeight
number
600
Высота окна чата, px. Минимум 300.
zIndex
number
999999
Слой виджета. Поменяйте, если его перекрывают элементы сайта: шапка, баннер cookie.
Коды позиций кнопки
Код
Где кнопка
br
справа снизу
bc
снизу по центру
bl
слева снизу
rt
справа сверху
rm
справа посередине
rb
справа снизу (как br)
lt
слева сверху
lm
слева посередине
lb
слева снизу (как bl)
Первая буква — сторона экрана (b — низ, l — лево, r — право), вторая — место на ней (t — верх, m — середина, b — низ, c — центр). На телефоне отступ от края меньше — 16 px вместо 24.
Тексты
Заменяют тексты из панели только на этой странице — удобно, когда на разных разделах сайта нужен свой заголовок или приветствие.
Параметр
Тип
Что делает
headerText
string
Заголовок окна чата.
onlineTitle
string
Подзаголовок в рабочее время (по расписанию из панели).
offlineTitle
string
Подзаголовок в нерабочее время.
welcomeText
string
Приветствие в пустом чате — когда идёт рабочее время и в сети есть хотя бы один оператор.
offlineText
string
Текст в пустом чате, когда рабочее время закончилось или операторов нет в сети.
Язык
Параметр
Тип
По умолчанию
Что делает
locale
stringobject
из панели
Строка — язык интерфейса: ru, en, es, pt, de, fr, tr. Объект — замена отдельных надписей. Подробно — в разделе «Язык и тексты».
language
string
—
Синоним locale для строкового значения — оставлен для совместимости с Chatra. В новых интеграциях используйте locale.
Поведение и показ
Параметр
Тип
По умолчанию
Что делает
startHidden
boolean
false
Загрузить виджет скрытым: ни кнопки, ни автооткрытия. Показать — show или openChat.
customWidgetButton
string
—
CSS-селектор вашей кнопки. Клик по ней открывает чат, стандартная кнопка прячется. Подробно — в разделе «Своя кнопка».
disabledOnMobile
boolean
false
Не запускать виджет на телефонах и планшетах.
mobileOnly
boolean
false
Запускать виджет только на телефонах и планшетах.
deferredLoading
boolean
false
Стартовать после полной загрузки страницы (событие load) — картинки и скрипты сайта грузятся первыми.
disableChatOpenHash
boolean
false
Не трогать адресную строку: виджет перестаёт следить за ссылками #svyazioChatExpanded и не добавляет этот хеш на телефонах.
Маршрутизация
Параметр
Тип
По умолчанию
Что делает
groupId
string
—
ID отдела, в который попадут обращения со страницы. Скопировать ID — Настройки → Отделы, иконка рядом с названием. ID чужой организации сервер игнорирует.
groupID
string
—
То же, что groupId: внутреннее имя параметра, его показывает справка в кабинете. Если заданы оба, побеждает groupId.
События для вашей аналитики: загрузка виджета и открытие чата.
Служебные
Параметр
Тип
По умолчанию
Что делает
serverUrl
string
адрес скрипта
Адрес сервера Связио. Уже прописан в коде установки, менять не нужно. Если не указан, берётся из адреса, откуда загружен svyazio.js.
position
'right''bottom-left'
из панели
Устаревшая упрощённая позиция из первых версий. Если задан buttonPosition, действует он.
Объявлено, но не работает
В типах конфигурации есть два ключа, которые виджет не читает: buttonStyle (кнопка всегда круглая) и clientId (привязку к аккаунту делайте через данные посетителя). Ошибок они не вызывают, но и эффекта не дают.