Установка виджета на сайт

Установка за 4 шага

1. 1
   Найдите свой workspace_id

   В дашборде откройте SettingsWidget Builder — кнопка «Embed» в правом верхнем углу даёт готовый сниппет. Если хотите вставить вручную — workspace_id виден в URL дашборда: /settings/widget-builder?ws=UUID.
2. 2
   Вставьте loader-сниппет перед </body>

   На каждой странице, где должен быть чат — copy-paste изSettingsWidget BuilderEmbed:

   index.htmlhtml

   <script>
   (function(w, d){
     function loadWidget(token){
       var s = d.createElement('script');
       s.async = 1;
       s.src = 'https://support.forestsnet.com/widget-bundle?ws=00000000-0000-0000-0000-000000000000';
       if (token) s.setAttribute('data-visitor-token', token);
       d.head.appendChild(s);
     }
     // ── Optional: cross-device HMAC visitor token ─────────────────
     // Uncomment + implement /api/supporthub/token on your backend to
     // bind the same visitor across devices. Recipes per stack:
     //   https://support.forestsnet.com/docs/widget/hmac-examples
     //
     // fetch('/api/supporthub/token', { credentials: 'include' })
     //   .then(function(r){ return r.ok ? r.json() : null; })
     //   .then(function(data){ loadWidget(data && data.token); })
     //   .catch(function(){ loadWidget(); });
     //
     // Default — anonymous (no token):
     loadWidget();
   })(window, document);
   </script>

   Копировать

   По умолчанию loader подключает виджет в анонимном режиме — один <script>, никакого бэкенда у вас не требуется. Если хотите cross-device идентификацию (один визитор с iPhone и MacBook → один Contact) — раскомментируйте блок fetch('/api/supporthub/token') и реализуйте endpoint у себя по одному из шаблонов; виджет передаст токен в data-visitor-token автоматически. Bundle injects через document.createElement('script') с async=1, не блокирует first paint. Параметр ?ws= — единственный обязательный; API URL бэкенда уже зашит в preamble. Полный референс HMAC — /docs/widget/hmac, identify-flow целиком — /docs/widget/identify.
3. 3
   Проверьте, что FAB появился

   Откройте сайт в режиме инкогнито. В правом нижнем углу должна появиться круглая индиго-кнопка с иконкой чата (через ~100ms после полной загрузки). Если её нет — посмотрите в консоли. Самые частые причины:

   • ?ws= опечатка → бандл не запустится (auto-boot ищет валидный UUID)
   • CSP блокирует загрузку bundle → добавьте support.forestsnet.com и api.support.forestsnet.com в script-src и connect-src
   • Adblock — widget-bundle не сматчит ни один популярный фильтр, но отдельные пользователи могут блокировать вручную
4. 4
   Откройте чат и отправьте тестовое сообщение

   Кликните по FAB → откроется панель → нажмите «Задать вопрос» → отправьте «привет». В дашборде во вкладке «Входящие» моментально появится новый тикет — это значит embed подключён правильно.

Что делает тег

Параметры тега

Программное управление

// Кнопка «Связаться с поддержкой» где-то у вас на сайте:
document.getElementById("contact-support").addEventListener("click", () => {
  window.SupportHub?.open();
});

Удаление и обновление

Удалить виджет с сайта

Обновлять не нужно