Integracja HubSpot Chat: konfiguracja i pomoc

Ten przewodnik pozwala połączyć sklep z HubSpot. Potrzebujesz istniejącego konta w usłudze i wartości jego pola ID portalu. Skonfiguruj rozmowy i widoczny widget na koncie usługi.

Akcja "Configure" modułu otwiera stronę Konfiguracja HubSpot Chat. Kontroler konfiguracji wyświetla także powiadomienie o wymaganej konfiguracji i baner integralności. Do odpowiednich prac konserwacyjnych używaj stron modułu Konfiguracja, "Integrity", Licencja, Wsparcie i Aktualizuj.

Znajdowanie wartości połączenia

Skopiuj numeryczny identyfikator portalu HubSpot (Portal ID), zwany też Hub ID, ze szczegółów konta lub kodu instalacyjnego. Panel konfiguracji modułu wskazuje "Settings" > "Account Defaults" > "Account Info". Wklej wyłącznie identyfikator, nie cały URL ani skrypt. Ścieżka w koncie dostawcy pochodzi z instrukcji modułu i może być inna na Twoim koncie.

Domyślnie pole jest puste. Dla nowych lub zmienionych identyfikatorów moduł wymaga od 1 do 20 cyfr. Odrzucenie identyfikatora zachowuje poprzednio zapisaną konfigurację. Popraw wartość i zapisz ponownie.

Ustaw te pola na stronie Konfiguracja HubSpot Chat, a następnie kliknij Zapisz.

Grupy stron

Kierowanie używa nazw kontrolerów. Własny kontroler zamówienia spoza listy nie jest uwzględniany przez Tylko strony zamówienia. Nie ma pola 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

Przed załadowaniem skryptu szablon kolejkuje _hsq.push(['identify', {email: 'customer@example.com'}]) dla zalogowanego klienta z włączonym przekazywaniem danych. Wysyła tylko adres e-mail; imię i nazwisko klienta nie są wysyłane. Loader używa hs-script-loader i pomija wstawianie drugiego elementu z tym ID.

Moduł nie przekazuje pól tożsamości klienta PrestaShop dla gości. Usługa nadal może zbierać informacje przez własny widget. 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. Loader uruchamia się przy pierwszej interakcji lub po dwóch sekundach bez interakcji.

Moduł rejestruje displayBeforeBodyClosingTag. Najpierw sprawdza przełącznik włączenia, wartość połączenia oraz reguły urządzeń i stron. Następnie umieszcza opóźniony loader pod koniec strony.

Przewiń, kliknij, dotknij strony lub naciśnij klawisz, aby uruchomić loader. Bez interakcji poczekaj na skonfigurowane ładowanie awaryjne. Wspólny loader usuwa wewnętrzne opóźnienie szablonu, więc czasy oczekiwania się nie sumują. Przy domyślnym 0 poczekaj 10 sekund, zanim uznasz ładowanie strony bez interakcji za nieudane.

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

//js.hs-scripts.com/{Portal ID}.js

Otwórz widget i wyślij wiadomość testową. Sprawdź, czy dotarła do skrzynki 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.

Opublikuj i skonfiguruj chatflow w HubSpot. Zarządzaj wyglądem, routingiem skrzynki odbiorczej, spotkaniami i działaniem CRM w HubSpot.

• Jeśli loader nie jest generowany, sprawdź Włącz HubSpot Chat, ID portalu, Pokaż na stronach i Pokaż na urządzeniach mobilnych.
• Jeśli strona pozostaje bez interakcji, poczekaj na ładowanie awaryjne lub wykonaj interakcję. "Fallback Delay (seconds)" ustawione na 0 nie oznacza natychmiastowego ładowania.
• Jeśli zapis się nie powiedzie, pozostaw identyfikator, sprawdź jego format, odśwież stronę konfiguracji i spróbuj ponownie. Nie używaj zastępczych danych dostępowych do testu na żywo.
• Jeśli żądanie zewnętrzne się nie powiedzie, sprawdź błędy konsoli przeglądarki, blokowanie skryptów, Content Security Policy i narzędzia zgody w sklepie.
• Jeśli skrypt się ładuje, lecz brak przycisku uruchamiającego, sprawdź publikację widgetu, dostępność konta i reguły wyświetlania po stronie usługi.
• Jeśli brakuje pola klienta, zaloguj się i potwierdź, że Przekaż dane klienta ma wartość Tak. Porównaj z dokładną listą pól powyżej.
• Jeśli inna integracja też wstawia skrypt usługi, sprawdź wyrenderowaną stronę pod kątem powielonego lub kolidującego kodu instalacyjnego.

Sprawdzanie własnego motywu

Motyw musi wykonywać hook przed zamknięciem body. Jeśli go brakuje, programista może przywrócić to wywołanie przed </body>:

{hook h='displayBeforeBodyClosingTag'}

Aby dostosować szablon motywu, skopiuj:

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

do:

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

Zachowaj zmienne Smarty modułu i escapowanie identyfikatora. Wspólna warstwa obsługi interakcji nadal obejmuje ten szablon hooka.

Formularz używa prefiksu MPRHSCHAT_ w nazwach przesyłanych pól. Obecnie dane są przechowywane dla modułu mprhubspotchat we wspólnej tabeli mpr_config, pod krótkimi kluczami:

ENABLED
PORTAL_ID
SHOW_MOBILE
PAGES
DELAY
PASS_USER_DATA

Tabela bazy danych używa prefiksu tabel 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 obecnych kluczy bazy danych.

Ustaw Włącz HubSpot Chat na Nie i zapisz z pozostawionym identyfikatorem, aby wstrzymać wyświetlanie przez moduł. Możesz też wyłączyć moduł w "Module Manager".

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