Integracja Smartsupp Chat: konfiguracja i pomoc

Potrzebujesz istniejącego konta w usłudze oraz jego identyfikatora Website Key. Rozmowy i widoczny widżet skonfiguruj na koncie usługi.

Działanie "Configure" modułu otwiera Konfiguracja Smartsupp. Strona pokazuje również komunikat o wymaganej konfiguracji i baner integralności. Do odpowiednich czynności konserwacyjnych używaj stron konfiguracji, integralności, licencji, pomocy i aktualizacji modułu.

Znajdź wartość połączenia

Skopiuj _smartsupp.key z kodu instalacyjnego czatu Smartsupp. Formularz wskazuje "Settings" > "Chat box". Wklej tylko identyfikator. Nie wklejaj całego adresu URL ani skryptu.

Wartość domyślna jest pusta. Dla nowych lub zmienionych identyfikatorów moduł oczekuje od 16 do 128 liter, cyfr, łączników lub podkreśleń. Odrzucenie identyfikatora pozostawia poprzednio zapisaną konfigurację. Popraw wartość i zapisz ponownie.

Ustaw te pola w Konfiguracja Smartsupp, 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

Moduł łączy się przez _smartsupp.key. Gdy przekazywanie danych klienta jest włączone, przekazuje do Smartsupp również adres e-mail (_smartsupp.email) i imię oraz nazwisko (_smartsupp.name) zalogowanego klienta.

Moduł nie przekazuje do Smartsupp danych identyfikujących niezalogowanych gości z 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 Opóźnienie awaryjne (sekundy) na 2. Mechanizm ładowania uruchamia się przy pierwszej interakcji lub po dwóch sekundach bez interakcji.

Moduł rejestruje displayBeforeBodyClosingTag. Najpierw sprawdza przełącznik włączenia, wartość połączenia, regułę urządzenia i regułę strony. Następnie umieszcza mechanizm odroczonego ładowania pod koniec strony.

Przewiń stronę, kliknij, dotknij ekranu lub naciśnij klawisz, aby rozpocząć ładowanie. Bez interakcji poczekaj na ustawiony czas awaryjnego uruchomienia. Jest to cały czas oczekiwania, bez dodatkowego opóźnienia. Przy wartości domyślnej 0 odczekaj 10 sekund, zanim uznasz brak ładowania na nieaktywnej stronie za błąd.

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

https://www.smartsuppchat.com/loader.js?

Otwórz widżet i wyślij wiadomość testową. Sprawdź, czy dociera do skrzynki odbiorczej usługi. Jeśli włączono Przekazuj 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.

Operatorami, dostępnością, powiadomieniami, nagraniami i chatbotami zarządzaj w Smartsupp. Moduł nie tworzy konta ani nie konfiguruje tych funkcji usługi.

• Jeśli mechanizm ładowania nie jest generowany, sprawdź Włącz czat Smartsupp, Website Key, 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ę. Opóźnienie awaryjne (sekundy) 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 Przekazuj 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/mprsmartsupp/views/templates/hook/displayBeforeBodyClosingTag.tpl

do:

themes/your-theme/modules/mprsmartsupp/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 MPRSMART_ dla nazw przesyłanych pól. Obecnie konfiguracja jest przechowywana dla modułu mprsmartsupp we wspólnej tabeli mpr_config, z krótkimi kluczami:

ENABLED
WEBSITE_KEY
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 czat Smartsupp 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.