Dokumentacja

Shopify

Dodaj agenta do dowolnego sklepu Shopify, wklejając kod do osadzenia w motywie.

Dodaj swojego agenta AI do sklepu Shopify, wklejając kod do osadzenia w pliku motywu theme.liquid. Działa z każdym planem Shopify.

Najpierw pobierz kod do osadzenia z zakładki Agent > Publikuj w panelu.

Metoda 1: edycja theme.liquid (zalecana)

Dodaj widżet do całej witryny, edytując opublikowany motyw:

  1. W panelu administracyjnym Shopify przejdź do Online Store → Themes.
  2. W wierszu aktywnego motywu kliknij menu ... (Actions) → Edit code.
  3. W folderze Layout po lewej stronie otwórz theme.liquid.
  4. Przewiń na sam dół i wklej kod do osadzenia tuż przed zamykającym tagiem </body>.
  5. Kliknij Save.

Przykładowy format (użyj rzeczywistych wartości z Agent > Publikuj):

<script
  src="YOUR_WIDGET_URL"
  data-chatbot="YOUR_CHATBOT_ID"
  async
></script>

Widżet pojawia się na każdej stronie sklepu — produktu, kolekcji, koszyka i strony głównej.

Metoda 2: najpierw zduplikuj, potem edytuj

Jeśli chcesz mieć możliwość bezpiecznego wycofania zmian:

  1. Online Store → Themes.
  2. Na aktywnym motywie kliknij menu ... (trzy kropki) → Duplicate. Kopia pojawi się na dole listy motywów.
  3. Edytuj plik theme.liquid duplikatu tak jak powyżej.
  4. Kliknij menu ... przy duplikacie → Preview, aby przetestować.
  5. Gdy wszystko działa poprawnie, kliknij menu ... → Publish, aby opublikować zmiany.

Metoda 3: wklejenie na wybranej stronie

Aby dodać widżet tylko do jednej strony (np. strony pomocy):

  1. W panelu administracyjnym Shopify przejdź do Online Store → Pages.
  2. Otwórz stronę, którą chcesz edytować.
  3. Kliknij ikonę <> (Show HTML) w edytorze treści.
  4. Wklej kod do osadzenia na końcu treści.
  5. Kliknij Save.

Widżet będzie ładował się tylko na tej stronie.

Wymagania

  • Motyw, który edytujesz, musi być opublikowanym lub płatnym motywem. Kodu motywu próbnego nie można zapisać.
  • Jeśli masz włączone ograniczanie dozwolonych domen, domena Twojego sklepu powinna znaleźć się na liście dozwolonych domen agenta.

Po opublikowaniu

Shopify serwuje zasoby sklepu z CDN. Zmiany propagują się w ciągu minuty lub dwóch. Jeśli nie widzisz widżetu:

  1. Wykonaj twarde odświeżenie strony (⌘+Shift+R na Macu, Ctrl+F5 na Windows).
  2. Otwórz witrynę w oknie incognito.
  3. Sprawdź konsolę przeglądarki pod kątem błędów.

Rozwiązywanie problemów

Widżet się nie pojawia.

  • Upewnij się, że edytowałeś motyw aktywny (lub opublikowałeś duplikat).
  • Upewnij się, że fragment kodu znajduje się przed </body>, a nie wewnątrz <head>.
  • Zweryfikuj, czy domena Twojego sklepu jest dozwolona w Agent > Publikuj > Zabezpieczenia.

Widżet nakłada się na czat Shopify lub panel koszyka.

  • Dostosuj pozycję widżetu w ustawieniach Wygląd swojego agenta.

Widżet pojawia się w edytorze, ale nie w aktywnym sklepie.

  • Upewnij się, że po wklejeniu kliknięto Save — edytor kodu nie zapisuje automatycznie.

Testowanie

  1. Otwórz swój sklep w oknie incognito.
  2. Sprawdź, czy w rogu widoczny jest dymek czatu.
  3. Kliknij, aby go otworzyć, i wyślij testową wiadomość.

Połącz sklep, aby wyszukiwać zamówienia i produkty

Osadzenie widżetu i połączenie sklepu to dwie osobne sprawy. Powyższy kod do osadzenia umieszcza widżet czatu w Twoim sklepie. Osobne połączenie z Shopify — utworzone z zakładki Akcje → Integracje Twojego agenta — dodatkowo pozwala agentowi przeszukiwać Twój aktywny katalog i sprawdzać status zamówienia w trakcie rozmowy.

Możesz skorzystać z każdej z tych opcji osobno. Użyj samego osadzenia, jeśli agent ma odpowiadać wyłącznie na podstawie treści treningowych, i dodaj połączenie ze sklepem, gdy chcesz mieć dostęp do danych o produktach i zamówieniach na żywo.

Połączenie sklepu dostarcza tylko dane uwierzytelniające i samo w sobie niczego nie włącza: następnie dodaj w zakładce Akcje swojego agenta akcje Wyszukiwanie produktów i Status zamówienia, i włącz każdą z nich, której agent ma używać.

Skonfiguruj akcje Shopify →

Kolejne kroki