← Wszystkie integracje
Rozszerzenie aplikacji motywu

Shopify, z publicznie dostępną dokumentacją.

Instaluje widżet Saazly w motywie sklepu. Ta wersja nie odczytuje zamówień ani nie prosi o uprawnienia do nich.

Instalacja deweloperska

Kandydat techniczny jest gotowy do weryfikacji w development store.

Weryfikacja platformy

Przesłano do Shopify i oczekuje na zatwierdzenie.

Publiczna publikacja

Nie opublikowano. Dostępność zostanie zadeklarowana dopiero po zatwierdzeniu przez Shopify.

01 / Od zera do widżetu

Instalacja

Zainstaluj aplikację w Shopify development store albo skorzystaj z linku instalacyjnego udostępnionego przez Saazly.

Otwórz osadzoną aplikację w Shopify Admin. Sesja Shopify zostanie zweryfikowana, a token offline instalacji utworzony lub odnowiony.

Wybierz Połącz studio. Nowe okno Saazly w domenie własnej wymaga zalogowanego administratora i wyświetla wyłącznie aktywne widżety w wybranym studio.

Wybierz widżet i zatwierdź połączenie.

Otwórz edytor motywu za pomocą linku aktywacyjnego, włącz Saazly Chat i zapisz motyw.

02 / Minimalny dostęp

Uprawnienia i zakresy

Zakresy Admin API

Brak w wersji widżetowej. Konfiguracja korzysta z pustej listy zakresów.

Dane zamówień

Dane zamówień nie są odczytywane ani zapisywane. Uprawnienia do zamówień nie są wymagane.

Tożsamość sklepu

Token sesji Shopify identyfikuje sklep i sesję użytkownika. Sam w sobie nigdy nie daje prawa do wyboru studia Saazly.

03 / Kontrakt danych

Odczytywane i zapisywane dane

Odczytywane z Shopify

Domena sklepu i podpisane deklaracje sesji. Na stronie sklepu widżet odczytuje zgłaszany przez przeglądarkę koszyk z własnego pliku cart.js sklepu.

Zapisywane w Shopify

Brak danych biznesowych. Sprzedawca samodzielnie aktywuje osadzenie aplikacji i zapisuje Widget ID w ustawieniach motywu.

Zapisywane w Saazly

Domena sklepu, zaszyfrowany offline access token, zaszyfrowany refresh token, czas wygaśnięcia, studio id i widget id. Wszystkie połączenia są ograniczone do konkretnego studia.

04 / Zdarzenia

Webhooki

app/uninstalled

Usuwa aktywny dostęp za pomocą tokenu i oznacza instalację jako odinstalowaną.

customers/data_request

Jest weryfikowany i rejestrowany. Instalacja widżetu nie przechowuje profilu klienta Shopify.

customers/redact

Jest weryfikowany i rejestrowany. Instalacja widżetu nie ma profilu klienta Shopify do usunięcia.

shop/redact

Usuwa rekord instalacji oraz ewentualne przyszłe dane katalogowe Shopify dla połączonego studia.

05 / Dane poufne

Przechowywanie tokenów

Dane w spoczynku

Access token i refresh token są szyfrowane za pomocą AES 256 GCM przed zapisaniem w bazie danych. Klienci nigdy nie otrzymują wartości tokenów.

Rotacja

Wygasające tokeny offline są odnawiane za pomocą refresh tokenu pięć minut przed wygaśnięciem. Pole updated_at w bazie danych służy jako optymistyczna blokada rotacji.

Unieważnienie

Shopify unieważnia dostęp podczas odinstalowania. Następnie webhook czyści oba zaszyfrowane pola tokenów i lokalny aktywny dostęp.

06 / Czyste usunięcie

Odinstalowanie

Odinstaluj Saazly Chat w Shopify Admin.

Shopify unieważni dostęp aplikacji i wyśle app/uninstalled.

Saazly wyczyści zaszyfrowane tokeny i oznaczy instalację jako odinstalowaną.

Usuń lub wyłącz Saazly Chat w sekcji App embeds, jeśli motyw nadal wyświetla zapisane osadzenie.

07 / Gdy coś przestaje działać

Rozwiązywanie problemów

Aplikacja informuje o braku sesji

Ponownie otwórz aplikację z Shopify Admin. Sprawdź, czy skrypty zewnętrzne z cdn.shopify.com nie są blokowane.

Widżet nie jest widoczny

Sprawdź, czy połączono aktywny widżet, osadzenie aplikacji jest włączone, a motyw został zapisany.

Wyświetla się niewłaściwe studio

Zamknij okno łączenia, wybierz właściwe studio w Saazly i otwórz nowy link do połączenia z Shopify Admin.

Nadal nie działa?

Wyślij domenę sklepu, godzinę wystąpienia problemu i komunikat o błędzie. Nigdy nie wysyłaj tokenu ani hasła.

Skontaktuj się z pomocą
Integracja Shopify | Dokumentacja Saazly