Типичные причины, по которым чат не появляется или метод не срабатывает, и как их проверить.

Если что-то не работает

У каждого вопроса своя ссылка — нажмите на заголовок и скопируйте адрес, чтобы отправить ответ клиенту.

Кнопка чата не появляется

Проверьте orgId — удобнее всего заново скопировать код из Настройки → Установка.
Убедитесь, что виджет включён в панели.
Проверьте disabledOnMobile, mobileOnly и startHidden.
Если на странице есть и SvyazioConfig, и SvyazioSetup, виджет читает только SvyazioSetup — в нём тоже должен быть orgId.
Откройте консоль браузера: ошибки с пометкой [Svyazio] и запреты Content Security Policy подскажут причину.
Если оператор заблокировал посетителя, виджет не показывается в этом браузере — проверьте в другом браузере или в режиме инкогнито.

В консоли «Svyazio is not a function»

Ваш вызов выполнился раньше кода установки или код вставлен не целиком — без функции-очереди w[c] = w[c] || function() {…}. Поставьте код установки выше своих скриптов или пишите window.Svyazio?.(…).

Цвет не применился или кнопка стала фиолетовой

Цвет задан не в формате #RRGGBB. accentColor: 'red' виджет отбросит и покрасится в запасной фиолетовый. Короткий '#0a7' проверку проходит, но кнопка красится градиентом, к цвету дописывается прозрачность — #0a7dd уже не цвет, и браузер отбрасывает правило целиком. Поэтому только шесть шестнадцатеричных цифр: '#00AA77'.

Виджет закрывают другие элементы сайта

Поднимите слой: zIndex в конфигурации или Svyazio('setZIndex', …). Если мешает баннер cookie или кнопка «Наверх», можно также сдвинуть кнопку чата через buttonPosition.

customWidgetButton не открывает чат

На момент запуска виджета элемента с этим селектором не было на странице. Проверьте селектор в консоли: document.querySelector('#support-button'). Для кнопок, которые появляются позже, используйте обработчик на документе.

Дополнительные данные не появились в карточке посетителя

Скорее всего, они переданы до того, как виджет подключился, — вызовите setIntegrationData позже. Другие причины: весь набор данных больше 4 КБ или ключ входит в служебные. Подробнее — в разделе «Правила».

На телефоне кнопка «Назад» закрывает чат, а не уводит со страницы

Так задумано: открытый чат на телефоне занимает весь экран, и «Назад» его закрывает. Отключить — disableChatOpenHash: true.

На сайте настроен Content Security Policy

Разрешите сервер Связио в этих директивах — остальные правила оставьте своими:

Заголовок CSP

Content-Security-Policy:
  script-src  'self' https://app.svyazio.ru;
  connect-src 'self' https://app.svyazio.ru wss://app.svyazio.ru;
  img-src     'self' https://app.svyazio.ru;
  media-src   'self' blob:;
  style-src   'self' 'unsafe-inline';

'unsafe-inline' в style-src нужен для стилей внутри виджета, blob: в media-src — для звука уведомлений.

У меня кнопка есть, а у части посетителей — нет

Скорее всего, блокировщик рекламы: некоторые списки режут сторонние скрипты чатов. Проверьте сайт с включённым блокировщиком — в консоли будет ошибка загрузки svyazio.js, а window.SvyazioWidget окажется пустым. Обойти это со стороны сайта нельзя; оставьте на странице почту или телефон для таких посетителей.