Instalacja widgetu czatu nie powinna zamieniać się w projekt. Mimo to ten mały snippet działa na prawdziwej stronie klienta, obok checkoutu, analityki, banerów cookies, landing page'y i czasem starego motywu, którego nikt nie chce ruszać. Nie chodzi tylko o szybkie wklejenie skryptu. Chodzi o to, żeby wkleić go raz i później do niego nie wracać z bólem głowy.
Zacznij w panelu
Utwórz albo wybierz organizację, wejdź w ustawienia widgetu i skopiuj klucz osadzenia. Ten klucz jest publiczny. Każdy może zobaczyć go w źródle strony, więc nie może działać jak token administratora. W Convorze wskazuje, którą konfigurację widgetu pobrać. Prawdziwy zapis nadal przechodzi przez token odwiedzającego, sprawdzenie organizacji i walidację po stronie serwera.
Przed publikacją ustaw podstawy: pozycję, kolor, język, powitanie, zachowanie poza godzinami pracy, zasady plików i ewentualne triggery proaktywne. Loader przyjmuje opcje lokalne oraz konfigurację z serwera. Wartości, które trafiają do CSS, na przykład kolor i zaokrąglenie, są walidowane zanim dotkną strony hosta. Pole od brandingu ma zmienić wygląd przycisku, a nie stać się sposobem na wstrzyknięcie losowego CSS-u do cudzej strony.
Instalacja zwykłym skryptem
Najkrótsza ścieżka to zwykły skrypt: załaduj go asynchronicznie pod koniec body i zainicjuj widget kluczem z panelu. Loader dodaje przycisk i tworzy iframe dla interfejsu rozmowy. Trzymanie UI czatu w iframe jest mało efektowną decyzją, ale usuwa wiele prawdziwych problemów: konflikty CSS, odziedziczone resety, błędy layoutu i zderzenia JavaScriptu z aplikacją hosta.
Next.js i inne aplikacje SPA
W Next.js ładuj skrypt po tym, jak strona stanie się interaktywna. Najważniejsze jest śledzenie tras. Aplikacja SPA może zmieniać URL bez pełnego przeładowania, a widget działający w iframe widzi własny adres iframe, nie adres strony klienta. Loader Convoru obserwuje nawigację i przekazuje aktualny URL hosta do iframe. Dzięki temu triggery oparte o podstronę działają na cenniku, dokumentacji albo kroku checkoutu.
Google Tag Manager i strony CMS
Google Tag Manager jest w porządku, gdy stroną zarządza marketing albo release kodu trwałby zbyt długo. Utwórz tag Niestandardowy HTML, wklej loader, ustaw uruchamianie na wszystkich stronach i opublikuj kontener. Potem sprawdź produkcję, nie tylko tryb podglądu. Upewnij się, że zgody cookies nie blokują skryptu przypadkiem, polityka CSP go przepuszcza i widget nie ładuje się podwójnie przez dwie różne ścieżki wdrożenia.
Szybki test przed produkcją
- Otwórz i zamknij widget na desktopie i telefonie.
- Wyślij wiadomość jako odwiedzający i odpowiedz z panelu.
- Przejdź między podstronami w jednej karcie i sprawdź, czy triggery używają URL-a hosta.
- Wyłącz na chwilę sieć i sprawdź, czy rozmowa wraca po połączeniu.
Pięć minut wystarczy na instalację. Poświęć jeszcze kilka minut na testy. Ta mała różnica oddziela wklejony snippet od wdrożenia, do którego nie trzeba wracać po pierwszym prawdziwym ruchu.
Nowe wpisy na Twoją skrzynkę
Bez spamu. Wypisz się w dowolnej chwili.
