Akcje Shopify

Połącz sklep Shopify, aby agent mógł przeszukiwać Twój katalog i sprawdzać status zamówień w rozmowie.

Połącz sklep Shopify ze swoim agentem, a będzie on mógł odpowiadać na pytania o produkty na podstawie Twojego aktywnego katalogu oraz sprawdzać status zamówienia w trakcie rozmowy. To coś innego niż umieszczenie widżetu czatu w sklepie — zobacz osadzanie widżetu Shopify, aby dowiedzieć się więcej.

Najpierw połącz swój sklep

Obie akcje wymagają połączonego sklepu.

  1. Przejdź do zakładki Akcje swojego agenta
  2. Otwórz Integracje i znajdź kartę Shopify
  3. Wpisz domenę swojego sklepu w formacie store-name.myshopify.com
  4. Ukończ ekran zgody Shopify

Karta pokazuje wtedy stan połączenia i pozwala Połączyć ponownie lub Rozłączyć. Jeśli połączenie wymaga uwagi, pojawia się bursztynowy baner z podpowiedzią o ponownym połączeniu.

Połączenie jest ustawiane osobno dla każdego agenta. Każdy agent łączy się z własnym sklepem, więc agent, który ma odpowiadać dla innego sklepu, otrzymuje własne połączenie zamiast współdzielić jedno.

O jaki dostęp prosimy

Na ekranie zgody Agentkit prosi dokładnie o dwa zakresy dostępu do odczytu:

ZakresDo czego służy
read_productsPrzeszukiwanie katalogu
read_ordersSprawdzanie statusu zamówienia

Nie są proszone żadne zakresy zapisu. Połączenie korzysta też z domyślnego tokenu offline Shopify — żądanie celowo pomija opcję nadania uprawnień per użytkownik — dzięki czemu agent działa dalej, nawet gdy osoba, która połączyła sklep, wyloguje się.

To zakresy, o które prosi obecna implementacja. Shopify decyduje osobno, jakie dane aplikacja może otrzymać: niektóre pola klienta i zamówienia są chronione, a samo przyznanie zakresu read_orders nie gwarantuje zwrócenia każdego pola.

Dwie akcje

Każda akcja jest dodawana i konfigurowana osobno w zakładce Akcje.

Wyszukiwanie produktów

Pozwala agentowi przeszukiwać katalog połączonego sklepu, gdy odwiedzający pyta o produkty, ceny lub dostępność. Wyniki można zawęzić za pomocą zapytania, opcjonalnej maksymalnej ceny i limitu wyników.

Wyniki wyszukiwania obejmują tylko aktywne produkty opublikowane w Twoim sklepie internetowym. Dostępność jest ustalana na podstawie łącznego stanu magazynowego produktu w Shopify i uwzględnia również produkty bez śledzenia zapasów.

Domyślna instrukcja „kiedy używać” to "Use when the user wants to find products, compare prices, or check whether an item is available." (po polsku, w skrócie: „Użyj, gdy użytkownik chce znaleźć produkty, porównać ceny lub sprawdzić dostępność przedmiotu”). Dostosuj ją do sposobu, w jaki Twoi odwiedzający formułują pytania.

Status zamówienia

Sprawdza pojedyncze zamówienie. Odwiedzający musi podać zarówno numer zamówienia, jak i e-mail z zamówienia — oba muszą pasować do tego samego zamówienia, zanim cokolwiek zostanie zwrócone.

To połączenie dwóch danych to zabezpieczenie prywatności: sam numer zamówienia łatwo zgadnąć lub podsłuchać, więc nigdy nie wystarcza. Jeśli zamówienie nie istnieje albo e-mail nie pasuje do zamówienia, agent otrzymuje tę samą ogólną odpowiedź "We could not find an order matching those details." (po polsku, w skrócie: „Nie udało się znaleźć zamówienia pasującego do tych danych.”) — nie jest w stanie stwierdzić, które z tych dwóch danych było błędne, i odwiedzający też nie.

Starsze zamówienia mogą zwrócić tę samą odpowiedź „nie znaleziono”, nawet gdy numer i e-mail są poprawne: Agentkit prosi o standardowy zakres read_orders Shopify, który obejmuje niedawne zamówienia sklepu (mniej więcej ostatnie 60 dni), a nie osobno zatwierdzaną pełną historię zamówień. Jeśli wyszukiwanie starszych zamówień jest ważne dla Twojego sklepu, licz się z tym, że odwiedzających ze starszymi zamówieniami trzeba będzie zamiast tego kierować do wsparcia.

Domyślna instrukcja „kiedy używać” to "Use when the user asks for an order status or tracking details and can provide the order number and checkout email." (po polsku, w skrócie: „Użyj, gdy użytkownik pyta o status zamówienia lub dane śledzenia przesyłki i może podać numer zamówienia oraz e-mail z zamówienia”).

Dwa warunki włączenia akcji

Oba muszą być spełnione, zanim akcję będzie można włączyć:

  1. Połączony sklep – bez niego przełącznik włączania pokazuje komunikat z odnośnikiem do Akcje → Integracje
  2. Płatny plan – ten sam wymóg co przy Akcji niestandardowej, Wyszukiwaniu w internecie, Odczytywaniu linków do dokumentów i akcjach rezerwacji

Nadal możesz tworzyć, edytować i zapisywać każdą z akcji, gdy jest wyłączona, nawet bez spełnienia żadnego z warunków. Warunki dotyczą tylko jej włączenia.

Rozwiązywanie problemów

OAuth zakończony, ale wyszukiwanie zamówień nic nie zwraca. Sprawdź format numeru zamówienia stosowany w Twoim sklepie i upewnij się, że testowany e-mail to e-mail z tego zamówienia. Następnie zweryfikuj uprawnienia aplikacji do chronionych danych klienta i zamówienia w tym sklepie — dostęp do tych danych musi być niezbędny dla aplikacji i może zostać ograniczony przez Shopify. Proszenie o szersze zakresy tego nie zmienia, a ponowne połączenie nie gwarantuje zatwierdzenia.

Agent odpowiada na podstawie treści treningowych zamiast katalogu. Doprecyzuj instrukcję „kiedy używać”, aby pytania o produkty, ceny i dostępność wyraźnie kierowały do akcji wyszukiwania.

Karta pokazuje ostrzeżenie o konieczności ponownego połączenia. Zapisana autoryzacja nie jest już użyteczna. Kliknij Połącz ponownie i ponownie ukończ ekran zgody. Ponowne połączenie przywraca samo połączenie, ale nie akcje: gdy zapisana autoryzacja przestaje działać, obie akcje Shopify są automatycznie wyłączane, a ekran zgody nie włącza ich z powrotem. Po ponownym połączeniu wróć do zakładki Akcje i włącz ponownie każdą akcję, którą chcesz aktywować.

Kolejne kroki