Konektor Shopify
Współpracuje z Shopify
Połącz Shopify z FreeScout, aby rozmowy pokazywały dopasowane zamówienia klientów i kontekst zakupów. Tworzysz aplikację niestandardową tylko do odczytu w panelu administracyjnym Shopify i wklejasz jej token dostępu do FreeScout, więc nie ma konta Partnera ani procesu przeglądu aplikacji. ReplyRabbit przekazuje także kontekst własności produktów do warstwy AI, aby szkice mogły odwoływać się do tego, co klient kupił.
Szukasz przeglądu?
Przegląd
Konektor Shopify dodaje pasek boczny zamówienia do rozmów FreeScout. Gdy rozmowa ma adres e-mail klienta, konektor odpytuje GraphQL Admin API Shopify w Twoim sklepie o pasujące zamówienia i pokazuje je obok rozmowy.
Pasek boczny pokazuje panel klienta, pełną historię zamówień, pozycje zamówień z ilościami i cenami, sumy finansowe, wartość życiową klienta (CLV), średnią wartość zamówienia (AOV) oraz uprawnienia do posiadania produktu, które trafiają do kontekstu AI ReplyRabbit w celu tworzenia trafniejszych szkiców.
Do zainstalowania jest jeden komponent: Moduł konektora FreeScout Shopify. Odczytuje Shopify GraphQL Admin API przez HTTPS przy użyciu tokenu dostępu Admin API z niestandardowej aplikacji, a następnie renderuje pasek boczny zamówienia. Ma własną stronę ustawień dla każdej skrzynki w FreeScout.
Panel boczny zamówień działa samodzielnie. Częścią, która korzysta z ReplyRabbit, są uprawnienia do produktów przekazywane do szkiców AI.
Wymagania wstępne
Zanim zaczniesz, upewnij się, że masz:
- Działająca instalacja FreeScout.
- Sklep Shopify na
your-store.myshopify.comdomenie (lub domenie niestandardowej, która do niej prowadzi), z uprawnieniami personelu do tworzenia aplikacji. - ReplyRabbit zainstalowany i aktywowany, jeśli chcesz kontekst własności produktów w wersjach roboczych AI.
- Licencja Shopify Connector (18 EUR jednorazowo, na jedną instalację FreeScout) lub aktywny plan ReplyRabbit Pro albo Team, który ją obejmuje.
Jeśli ReplyRabbit nie jest jeszcze zainstalowany, zacznij od Jak zainstalować moduł ReplyRabbit, a następnie dokończ Jak skonfigurować ReplyRabbit.
Utwórz aplikację niestandardową w Shopify
Konektor uwierzytelnia się tokenem dostępu Admin API z aplikacji niestandardowej, która działa w Twoim własnym sklepie.
Otwórz Develop apps
W panelu administracyjnym Shopify przejdź do Ustawienia, następnie Aplikacje i kanały sprzedaży, następnie Twórz aplikacje. Jeśli zostaniesz o to poproszony, zezwól na tworzenie niestandardowych aplikacji.Utwórz aplikację
Kliknij Utwórz aplikację, nazwij go "ReplyRabbit Connector" i utwórz go.Ustaw zakresy Admin API
Otwórz Skonfiguruj zakresy Admin API i zaznaczread_customers,read_orders, orazread_products. Zaznaczread_all_ordersrównież, jeśli chcesz historię zamówień starszą niż 60 dni. Zapisz.Zainstaluj i skopiuj token
Kliknij Zainstaluj aplikację, następnie Pokaż token raz i skopiuj Token dostępu API administratora (zaczyna się odshpat_). Shopify pokazuje go tylko raz, więc zapisz go w bezpiecznym miejscu.
Dostęp tylko do odczytu
Zainstaluj moduł łącznika FreeScout
Pobierz moduł konektora
Pobierz moduł konektora FreeScout w formacie ZIP z Panel ReplyRabbit. Pobranie pojawia się po zakupie konektora lub posiadaniu aktywnego planu ReplyRabbit Pro lub Team.Prześlij do FreeScout
W FreeScout przejdź do Moduły, kliknij przycisk przesyłania, wybierz plik ZIP i zainstaluj go.Aktywuj moduł
Aktywuj Integracja Shopify moduł z listy modułów.
Skonfiguruj dla każdej skrzynki
Otwórz ustawienia konektora
W FreeScout otwórz skrzynkę, która powinna pokazywać dane zamówień Shopify, otwórz menu ustawień skrzynki i wybierz Konektor sklepu. To jest strona ustawień konektora Shopify, a nie sekcja w ustawieniach ReplyRabbit.Wpisz domenę sklepu i token dostępu
Wpisz domenę sklepu, na przykładyour-store.myshopify.com, i wklej token dostępu Admin API. Zapisz. Konektor sprawdza token i zakresy względem Twojego sklepu przed zapisaniem; token jest przechowywany zaszyfrowany i nigdy więcej nie jest wyświetlany.Dodaj klucz licencji konektora
Jeśli kupiłeś konektor, ustawSHOPIFYINTEGRATION_LICENSE_KEYw Twoim FreeScout.envdo jego klucza licencji. Pomiń ten krok, jeśli aktywny plan ReplyRabbit Pro lub Team obejmuje instalację.Test
Otwórz rozmowę FreeScout, w której e-mail klienta pasuje do zamówienia Shopify, i potwierdź, że pojawia się pasek boczny zamówienia.
Każda skrzynka FreeScout przechowuje własną domenę sklepu i token dostępu, więc możesz połączyć różne skrzynki z różnymi sklepami.
Co pokazuje konektor
- Panel klienta dla osoby w rozmowie.
- Pełna historia zamówień z numerem zamówienia, datą, statusem i sumą.
- Pozycje dla poszczególnych zamówień z ilościami i cenami.
- Sumy finansowe (subtotal, discount, shipping, tax, refunds).
- Wartość życiowa klienta (CLV) i średnia wartość zamówienia (AOV).
- Uprawnienia do własności produktu dla szkiców AI.
Jak zdobyć konektor
Konektor Shopify to płatny moduł. Możesz go uzyskać na dwa sposoby:
- Kup Shopify Connector za 18 EUR jako jednorazową licencję na jedną instalację FreeScout, a następnie ustaw jego klucz licencji jako
SHOPIFYINTEGRATION_LICENSE_KEYw FreeScout.env. - Użyj aktywnego planu ReplyRabbit Pro lub Team, który obejmuje konektor bez dodatkowych kosztów.
Kup licencję lub pobierz connector ze swojego Panel ReplyRabbit. Odwiedź strona z cennikiem dla opcji planów ReplyRabbit. Jeśli aktywny plan ReplyRabbit Pro lub Team obejmuje instalację, konektor działa po skonfigurowaniu, bez potrzeby osobnego klucza licencji.
Rozwiązywanie problemów
| Objaw | Co sprawdzić |
|---|---|
| "Shopify odrzucił połączenie" podczas zapisywania | Token został błędnie wpisany, unieważniony lub należy do innego sklepu. Ujawnij nowy token, ponownie instalując niestandardową aplikację, i wklej go ponownie. |
| "Brakujące zakresy Admin API" podczas zapisywania | Otwórz aplikację niestandardową, dodaj brakujące zakresy w sekcji Skonfiguruj zakresy Admin API, zapisz i ponownie zainstaluj aplikację. Ponowna instalacja wydaje nowy token. |
| Domena sklepu jest odrzucana | Użyj your-store.myshopify.com domenie lub domenie niestandardowej, która do niej prowadzi. Prywatne hosty i adresy IP są odrzucane. |
| Pasek boczny zamówienia nie pojawia się | Potwierdź, że panel skrzynki jest włączony, a połączenie jest pokazane jako połączone na stronie ustawień. |
| Zamówienia są puste dla znanego klienta | Potwierdź, że adres e-mail klienta w rozmowie FreeScout odpowiada adresowi e-mail w jego zamówieniach Shopify. |
| Pokazywane są tylko zamówienia z ostatnich 60 dni | Dodaj read_all_orders zakres do niestandardowej aplikacji, zainstaluj ją ponownie i wklej nowy token. |
| Pozycje, finanse lub CLV nie są wyświetlane | Potwierdź, że klucz licencji konektora jest zapisany lub że aktywny plan ReplyRabbit Pro lub Team obejmuje instalację. |
| Kontekst własności produktu nie pojawia się w szkicach | Potwierdź, że konektor jest licencjonowany, ReplyRabbit jest zainstalowany, konektor zwraca zamówienia, a funkcja kontekstu AI jest włączona dla skrzynki. |
Szersze problemy znajdziesz w Rozwiązywanie problemów z ReplyRabbit.
Prywatność i przetwarzanie danych
Gdy konektor odpytuje Shopify, wysyła adres e-mail klienta do Shopify GraphQL Admin API przez HTTPS przy użyciu tokena Twojej aplikacji niestandardowej. Dane zamówień zwrócone z Twojego sklepu zasilają panel boczny FreeScout, a z ReplyRabbit budują kontekst AI dla szkiców.
Aplikacja niestandardowa ma tylko zakresy odczytu, więc konektor nigdy nie zapisuje do Twojego sklepu. Token dostępu jest przechowywany zaszyfrowany w FreeScout, a żądania wychodzące weryfikują TLS i nie podążają za przekierowaniami.
Żadne dane zamówień Shopify nie są wysyłane stronom trzecim, z wyjątkiem dostawcy AI wybranego dla skrzynki i tylko wtedy, gdy korzysta z nich funkcja kontekstu AI. Jeśli Twoja polityka wymaga, aby dane zamówień pozostały całkowicie na Twoich serwerach, użyj lokalnego dostawcy AI (takiego jak Ollama) dla skrzynki.
Następne kroki
- Zakończ Jak skonfigurować ReplyRabbit jeśli skrzynka nadal wymaga ustawień dostawcy, kontekstu lub stylu.
- Masz też WooCommerce lub Magento? Zobacz konektor WooCommerce oraz Konektor Magento przewodniki.
FAQ
Jak konektor Shopify łączy się z moim sklepem?
Z aplikacją niestandardową utworzoną w panelu administracyjnym Shopify (Settings, Apps and sales channels, Develop apps). Nadaj jej zakresy read_customers, read_orders i read_products, zainstaluj ją i wklej jej token dostępu Admin API wraz z domeną sklepu do ustawień konektora FreeScout. Konektor weryfikuje token w Twoim sklepie przed zapisaniem.
Czy potrzebuję konta Shopify Partner lub wpisu w App Store?
Nie. Niestandardowa aplikacja jest tworzona w panelu administracyjnym Twojego sklepu i nie wymaga konta Partnera, przeglądu aplikacji ani publicznej publikacji.
Ile kosztuje konektor Shopify?
Konektor Shopify jest dołączony do aktywnego planu ReplyRabbit Pro lub Team. W przeciwnym razie kosztuje 18 EUR jako jednorazowa licencja na jedną instalację FreeScout. Jeśli go kupisz, ustaw jego klucz licencji jako SHOPIFYINTEGRATION_LICENSE_KEY w pliku .env FreeScout.
Dlaczego widzę tylko zamówienia z ostatnich 60 dni?
Shopify ogranicza aplikacje do 60 dni historii zamówień, chyba że aplikacja ma zakres read_all_orders. Zaznacz read_all_orders podczas konfigurowania aplikacji niestandardowej, aby zobaczyć pełną historię.
Czy każda skrzynka FreeScout może łączyć się z innym sklepem Shopify?
Tak. Każda skrzynka przechowuje własną domenę sklepu i token dostępu w ustawieniach konektora, więc różne sklepy mogą łączyć się z różnymi skrzynkami.