Integracja Freshchat: konfiguracja i pomoc

Połącz sklep z Freshchat za pomocą istniejącego konta w usłudze i jego wartości Token. Rozmowy i widoczny widżet skonfiguruj na koncie usługi.

Akcja "Configure" modułu otwiera Konfiguracja Freshchat. Strona wyświetla również komunikat o wymaganej konfiguracji oraz baner integralności. Korzystaj ze stron modułu Konfiguracja, "Integrity", Licencja, Wsparcie i Aktualizuj do odpowiednich czynności konserwacyjnych.

Znajdź wartość połączenia

Skopiuj Token z kodu instalacyjnego Freshchat Web Messenger. Moduł wskazuje "Settings" > "Web Messenger". Wklej tylko identyfikator. Nie wklejaj całego adresu URL ani skryptu.

Wartość domyślna jest pusta. Dla nowych lub zmienionych identyfikatorów moduł oczekuje identyfikatora UUID zawierającego cyfry szesnastkowe w formacie 8-4-4-4-12. Odrzucenie identyfikatora pozostawia poprzednio zapisaną konfigurację. Popraw wartość i zapisz ponownie.

Ustaw te pola w Konfiguracja Freshchat, a następnie kliknij Zapisz.

Grupy stron

Kierowanie opiera się na nazwach kontrolerów. Własny kontroler zamówienia spoza tej listy nie jest uwzględniany przez Tylko strony zamówienia. Nie ma pola do własnych reguł URL. Pokaż na urządzeniach mobilnych korzysta z wykrywania urządzeń mobilnych w PrestaShop, a nie tylko z szerokości przeglądarki.

Pola klienta

Widżet używa zapisanego tokenu i łączy się z https://wchat.freshchat.com. Gdy Przekaż dane klienta jest włączone, wysyła e-mail zalogowanego klienta jako identyfikator klienta i adres e-mail, a pełne imię i nazwisko jako imię.

Ten moduł nie przekazuje gościom pól tożsamości klienta PrestaShop. Usługa nadal może zbierać informacje przez własny widżet. Moduł nie synchronizuje historii zamówień ani zawartości koszyka.

Przykładowa konfiguracja

Dla stron zamówienia na komputerach wybierz Tylko strony zamówienia, ustaw Pokaż na urządzeniach mobilnych na Nie, a "Fallback Delay (seconds)" na 2. Mechanizm ładowania uruchamia się przy pierwszej interakcji lub po dwóch sekundach bez interakcji.

Mechanizm ładowania widżetu pojawia się pod koniec dozwolonych stron sklepu, gdy moduł jest włączony, wartość połączenia jest wypełniona, a reguła urządzenia na to pozwala.

Przewiń stronę, kliknij, dotknij jej lub naciśnij klawisz, aby uruchomić ładowanie. Bez interakcji poczekaj na skonfigurowane ładowanie awaryjne. Przy domyślnej wartości instalacyjnej 0 odczekaj 10 sekund, zanim uznasz brak ładowania na stronie bez interakcji za błąd.

W narzędziach deweloperskich przeglądarki sprawdź żądanie pasujące do:

https://wchat.freshchat.com/js/widget.js

Otwórz widżet i wyślij wiadomość testową. Sprawdź, czy dociera do skrzynki odbiorczej usługi. Jeśli włączono Przekaż dane klienta, przetestuj zalogowane konto i sprawdź, które pola tożsamości otrzymuje usługa. Na koniec przetestuj wykluczone strony i urządzenia mobilne.

Ten moduł nie ma ustawienia "Host". Regionalny lub własny host wymaga zmiany szablonu przez programistę. Powitaniami, kolorami, botami, kampaniami, agentami i regułami skrzynki odbiorczej zarządzaj w Freshchat.

• Jeśli mechanizm ładowania nie jest generowany, sprawdź Włącz Freshchat, Token, Pokaż na stronach i Pokaż na urządzeniach mobilnych.
• Jeśli na stronie nie ma interakcji, poczekaj na ładowanie awaryjne lub wejdź z nią w interakcję. "Fallback Delay (seconds)" ustawione na 0 nie oznacza natychmiastowego ładowania.
• Jeśli zapis się nie udaje, pozostaw identyfikator wypełniony, sprawdź jego format, odśwież stronę konfiguracji i spróbuj ponownie. Nie używaj przykładowych danych dostępowych do rzeczywistego testu.
• Jeśli żądanie zewnętrzne się nie udaje, sprawdź błędy w konsoli przeglądarki, blokowanie skryptów, Content Security Policy oraz narzędzia do obsługi zgód w sklepie.
• Jeśli skrypt się ładuje, ale brakuje przycisku otwierania, sprawdź publikację widżetu po stronie usługi, dostępność konta i reguły wyświetlania.
• Jeśli brakuje pola klienta, zaloguj się i potwierdź, że Przekaż dane klienta jest ustawione na Tak. Porównaj z dokładną listą pól powyżej.
• Jeśli inna integracja również dodaje skrypt usługi, sprawdź wygenerowaną stronę pod kątem zduplikowanego lub kolidującego kodu instalacyjnego.

Sprawdź własny motyw

Motyw musi wykonywać hook przed zamknięciem body. Programista może przywrócić to wywołanie przed </body>, jeśli motyw go nie zawiera:

{hook h='displayBeforeBodyClosingTag'}

Aby dostosować szablon motywu, skopiuj:

modules/mprfreshchat/views/templates/hook/displayBeforeBodyClosingTag.tpl

do:

themes/your-theme/modules/mprfreshchat/views/templates/hook/displayBeforeBodyClosingTag.tpl

Zachowaj zmienne Smarty modułu i escapowanie identyfikatora. Wspólna otoczka obsługująca interakcje nadal obejmuje ten szablon hooka.

Formularz używa prefiksu MPRFCHAT_ dla nazw przesyłanych pól. Obecnie konfiguracja jest przechowywana dla modułu mprfreshchat we wspólnej tabeli mpr_config, z krótkimi kluczami:

ENABLED
TOKEN
SHOW_MOBILE
PAGES
DELAY
PASS_USER_DATA

Tabela bazy danych używa prefiksu tabel Twojego sklepu, więc ps_mpr_config to tylko przykładowa nazwa. Do zwykłych zmian używaj formularza konfiguracji. Nie traktuj nazw pól formularza jako aktualnych kluczy bazy danych.

Ustaw Włącz Freshchat na Nie i zapisz z nadal wypełnionym identyfikatorem, aby wstrzymać wyświetlanie przez ten moduł. Możesz też wyłączyć moduł w "Module Manager".

Aby go usunąć, użyj "Uninstall" w "Module Manager" i potwierdź. Odinstalowanie usuwa konfigurację modułu i jego pozycje menu administracyjnego. Nie zamyka konta w usłudze zewnętrznej ani nie usuwa kodu dodanego przez inny moduł lub motyw.