Виджет не работает — что проверить

Вставили <script>-тег, открыли сайт — никакой круглой кнопки в углу нет.

DevTools → Network → фильтр widget-bundle. Должен быть GET 200 (или 304 if-cached).

• 404 — опечатка в URL (проверьте support.forestsnet.com/widget-bundle?ws=…) или некорректный ?ws= (workspace не существует / был удалён).
• Запроса нет вообще — Adblock или CSP блокирует. См. ниже.
• 500 — серверная ошибка на нашей стороне. Сразу пишите в саппорт, пришлите URL.

Откройте Console. Типичные сообщения:

• __SH_API_BASE not set — preamble бандла не сработал. Проверьте что URL запроса с ?ws=… и backend ответил 200 (см. предыдущий шаг).
• WebSocket connection failed — норма пока визитор не отправил первое сообщение (backend отвечает 4401, бандл переподключается). Если ошибка персистит после первого сообщения — проверьте что api.support.forestsnet.com разрешён в CSP connect-src.

Если ваш сайт настроил CSP — добавьте наши хосты:

• script-src — для загрузки бандла. 'unsafe-inline' нужен потому что IIFE-loader инжектит inline-script тег. Если не хотите unsafe-inline — используйте прямой <script async src="…"> вместо loader-сниппета.
• connect-src — для REST вызовов и WebSocket к нашему API.
• img-src 'self' data: — операторские аватары + загруженные визиторами вложения приходят как data URLs.

widget-bundle не сматчит ни один популярный фильтр (EasyList / EasyPrivacy / etc), но отдельные пользователи могут блокировать вручную. Если конкретный посетитель сообщает что у него виджета нет — пусть проверит Adblock / NoScript / Privacy Badger.

В Console видно WebSocket connection to wss://… failed каждые несколько секунд.

Backend отвергает WS handshake с кодом 4401 пока не существует Contact с этим visitor_session. Контакт создаётся при первом сообщении. Бандл реконнектится opportunistic'но и подцепится сразу как только первое сообщение уйдёт.

Если визитор не собирается ничего писать (просто смотрит сайт) — это reconnect-loop в фоне, безвредный. Можно игнорировать.

Если ваш сайт за Cloudflare с включённым «Bot Fight Mode» — WSS upgrade может рубиться как подозрительный трафик. Решение:CloudflareSecurityWAFSkip rule for api.support.forestsnet.com.

Посетитель пишет с example.com, потом переходит на app.example.com, и в дашборде это выглядит как два разных контакта с двумя параллельными беседами.

Visitor session ID хранится в cookie scoped по host. По умолчанию cookies не делятся между поддоменами.

Задайте cookie domain с лидирующей точкой:

То же самое можно настроить в SettingsWidget BuilderConversationCookie domain — и сниппет на всех поддоменах останется одинаковый. data-cookie-domain выигрывает у конфига (удобно если стейдж и прод на разных доменах).

В Safari посетитель возвращается через неделю и SupportHub показывает его как нового — старый ticket history не подхватывается.

Safari Intelligent Tracking Prevention режет client-set cookies до 7 дней. Cookie с visitor session ID удаляется → backend считает посетителя новым.

Виджет уже хранит ID параллельно в 5 уровнях (cookie + localStorage + sessionStorage + IndexedDB + legacy LS). При следующем визите ID поднимается из localStorage обратно в cookie. Если визитор вручную не очистил весь сайт data — он не «забудется».

Если хотите гарантировать сохранение между девайсами/браузерами — используйте identify с visitor_token из вашей CRM.

Кликнули по FAB — панель открылась пустая, белая, с иконкой загрузки которая не пропадает.

В корпоративных сетях WSS бывает заблокирован — виджет долго ждёт connection, не показывает контент. Console покажет WebSocket connection failed.

Воркэраунд: сейчас mandatory. Ждём решения от сетевого админа клиента. Long-polling fallback в roadmap.

Если в Builder вы вписали невалидный custom_css или сломанный JSON в advanced поля — preview покажет ошибку. На проде виджет всё ещё пытается отрендерить и падает в whitescreen.

Решение: SettingsWidget BuilderDiscard draft вернёт последнюю опубликованную версию. Или починить custom_css по сообщению об ошибке в preview.

Pre-chat skip срабатывает только если переданы оба поля: email + name. Если только один — форма всё ещё спросит недостающее.

Передавайте оба:

Тоггл Hide Powered by в Brand-секции plan-gated — доступен только на тарифах с фичей custom_branding. На бесплатном плане отображается заблокированным.

SettingsBillingUpgrade на тариф который включает custom_branding. После апгрейда тоггл разблокируется автоматически.

Builder сохраняет в draft. Прод-виджет видит толькоопубликованную версию. Кнопка Publish в правом верхнем углу промотирует draft в эфир.

Bundle кешируется браузером и CDN на 60 секунд. Если опубликовали — посетители получат новый конфиг при следующем заходе через минуту. Hard-refresh не нужен.

Эти фичи отключены в дефолтном конфиге для нового workspace.

SettingsWidget BuilderConversation → включите Reactions enabled и Inline keyboard enabled. Опубликуйте.