Dlaczego czat / przewodniki w programie nie są widoczne?
Jeśli w programach Publink nie pojawia się ikona/okno czatu, albo nie wyświetlają się okna przewodników, przyczyną jest najczęściej firewall, proxy z filtrowaniem treści lub restrykcyjna polityka Content Security Policy (CSP) w sieci urzędu. Publink korzysta z dwóch niezależnych usług zewnętrznych — czatu i przewodników — które mogą zostać zablokowane od siebie niezależnie.
Możliwą przyczyną braku działania czatu lub przewodników są problemy u dostawców usług dla Publink. Zwykle są to problemy niezależne od nas. Staramy się to jak najszybciej o tym informować i przedstawiać alternatywne rozwiązania.
W przypadku braku działania tych usług zalecamy w pierwszej kolejności skorzystanie w bazy wiedzy Publink lub kontakt na pomoc@publink.com.
Inne możliwe techniczne przyczyny opisano niżej.
Czat nie działa
- Jeżeli ikonka czatu w ogóle się nie pojawia, prawdopodobnym powodem jest zablokowanie przez firewall, proxy lub reguły CSP w sieci urzędu jednej z domen, z których ładuje się czat. Najprościej i najbezpieczniej jest odblokować je regułą z gwiazdką (HubSpot rotuje subdomeny):
| *.hubspot.com *.hs-scripts.com *.hs-analytics.net *.usemessages.com *.hs-banner.com *.hsforms.com |
Jeśli whitelist musi być precyzyjna, pełny zestaw domen wykorzystywanych przez czat to:
| js-eu1.hs-scripts.com js-eu1.hs-analytics.net js-eu1.usemessages.com js-eu1.hubspot.com js-eu1.hs-banner.com api-eu1.hubspot.com app-eu1.hubspot.com track-eu1.hubspot.com cta-eu1.hubspot.com perf-eu1.hsforms.com |
-
Jeżeli ikonka czatu jest widoczna, ale po kliknięciu okno się nie otwiera albo nie da się wysłać/odebrać wiadomości, prawdopodobnym powodem jest zablokowanie app-eu1.hubspot.com (okno rozmowy ładuje się jako ramka z tej domeny) lub api-eu1.hubspot.com (wysyłanie i odbieranie wiadomości oraz połączenie na żywo). To najczęstsza sytuacja, gdy skrypty czatu są już odblokowane, ale sama rozmowa nie działa.
-
Jeżeli czat działał przez chwilę, a potem się „zawiesił" lub przestał odpowiadać w trakcie rozmowy, prawdopodobnym powodem jest program antywirusowy lub system ochrony sieci (np. EDR), który skanuje ruch szyfrowany (SSL/HTTPS) i po pewnym czasie przerywa długo trwające połączenia. Czat korzysta ze stałego połączenia (WebSocket), więc jest na to szczególnie narażony — objaw ten może wystąpić także wtedy, gdy wszystkie domeny są już na białej liście. W takim przypadku należy dodać wyjątek od inspekcji SSL i skanowania długich połączeń dla wymienionych wyżej domen.
-
Jeśli sieć urzędu korzysta z reguł CSP, należy dodać:
| script-src ... js-eu1.hs-scripts.com js-eu1.hs-analytics.net js-eu1.usemessages.com js-eu1.hubspot.com js-eu1.hs-banner.com; connect-src ... api-eu1.hubspot.com app-eu1.hubspot.com track-eu1.hubspot.com cta-eu1.hubspot.com perf-eu1.hsforms.com wss://*.hubspot.com; frame-src ... app-eu1.hubspot.com js-eu1.usemessages.com; img-src ... track-eu1.hubspot.com; |
Szybka diagnostyka (ok. 2 minuty):
otwórz stronę aplikacji, naciśnij F12, przejdź do zakładki Network, wpisz w filtr eu1, odśwież stronę i otwórz czat. Jeśli którekolwiek żądanie do app-eu1.hubspot.com lub api-eu1.hubspot.com ma status inny niż prawidłowy („blocked", „failed", „403", timeout) albo połączenie wss:// się nie ustanawia, oznacza to, że blokada wciąż obejmuje te konkretne adresy lub warstwę połączenia na żywo.
Przewodniki nie działają
Jeżeli przewodniki, podpowiedzi lub okienka pomocy w aplikacji się nie wyświetlają, prawdopodobnym powodem jest zablokowana domena, z której ładuje się ta usługa. Należy sprawdzić, czy odblokowane są:
| cdn.productfruits.com *.productfruits.com productfruits.help |
Jeżeli przewodniki nie wyświetlają się tylko na części stron albo tylko u niektórych pracowników, prawdopodobnym powodem jest ustawienie nagłówka Referrer-Policy: no-referrer na stronie urzędu. Usługa sprawdza, z jakiego adresu pochodzi żądanie, aby zweryfikować, czy dana strona ma prawo wyświetlać przewodniki. Jeśli ten nagłówek „chowa" adres źródłowy, weryfikacja się nie powiedzie i przewodniki się nie pokażą, mimo że wszystkie domeny są odblokowane. W takim przypadku należy sprawdzić nagłówki odpowiedzi serwera dla strony aplikacji.
Jeśli sieć urzędu korzysta z reguł CSP, należy dodać:
| script-src cdn.productfruits.com *.productfruits.com; connect-src *.productfruits.com; style-src *.productfruits.com; img-src *.productfruits.com; frame-src *.productfruits.com; media-src *.productfruits.com; |
Jeśli po odblokowaniu wskazanych adresów problem nie ustąpi, prosimy o kontakt z naszym zespołem wsparcia - najlepiej z informacją, którego elementu dotyczy problem (czat czy przewodniki) oraz czy zmiana była wprowadzona po stronie sieci, czy nie dała efektu.