Przejdź do treści
chatwoot.plNiezależny serwis po polsku

Poradnik

Jak dodać widżet Chatwoot do strony

Osadź widżet własnej skrzynki i sprawdź domenę, język oraz dostarczanie wiadomości.

W tym artykule
Przestrzenna ilustracja okien rozmów, poczty i serwera
Ilustracja tematyczna Chatwoot.pl: rozmowy i infrastruktura. Nie przedstawia interfejsu programu.
Dla kogo
Administrator
Zakres
Cloud i self-hosted; dostępność zależy od edycji

Zanim wstawisz kod

Potrzebujesz uprawnień administratora Chatwoot i możliwości edycji strony. Przygotuj testową skrzynkę Website oraz stronę roboczą. Domena serwera Chatwoot musi działać przez HTTPS.

Dodaj fragment instalacyjny

Otwórz ustawienia swojej skrzynki WWW i pobierz wygenerowany fragment. Wstaw go do szablonu strony w miejscu wskazanym przez dokumentację. Nie kopiuj tokenu skrzynki innej organizacji. Na stronie ma działać jedna konfiguracja widżetu; sprawdź też menedżer tagów, żeby nie osadzić go drugi raz.

Token publikowany w osadzeniu identyfikuje skrzynkę i nie jest sekretnym tokenem użytkownika API. Klucz HMAC do weryfikacji tożsamości musi pozostać na serwerze aplikacji. Sama deklaracja adresu e-mail w JavaScript nie potwierdza tożsamości klienta.

Ustaw wygląd i treść

W ustawieniach skrzynki sprawdź nazwę, powitanie, kolor, godziny pracy i opcje formularza. Wybierz język widżetu oddzielnie od języka panelu. Tekst powitalny powinien wyjaśniać, kto obsługuje rozmowę i kiedy można oczekiwać odpowiedzi.

Test i wycofanie

Otwórz stronę na telefonie i komputerze. Wyślij testowe pytanie, odpowiedz z panelu i sprawdź, czy widżet nie zasłania nawigacji ani przycisków. Jeżeli strona ma politykę CSP, porównaj blokowane połączenia z własną domeną Chatwoot.

Aby wycofać zmianę, usuń własne osadzenie z szablonu lub menedżera tagów i sprawdź stronę po odświeżeniu pamięci podręcznej. Nie usuwaj skrzynki z historią rozmów tylko po to, aby ukryć widżet.

Źródła i dalsza lektura

Sprawdzono 26.10.2026. Własne opracowanie po polsku na podstawie dokumentacji i komunikatów producenta.