← Wszystkie integracje
Wtyczka WordPress 1.0.0

WooCommerce, z publicznie dostępną dokumentacją.

Wtyczka widżetu i podpisane połączenie z zamówieniami to dwie osobne integracje. Wtyczka instaluje czat. Połączenie z zamówieniami odczytuje zweryfikowane zamówienia przez WooCommerce REST API.

Instalacja deweloperska

Plik zip i powtarzalny skrypt weryfikacyjny są dostępne w wersji kandydującej.

Weryfikacja platformy

Przesłano do WordPress i oczekuje na zatwierdzenie.

Publiczna publikacja

Nie opublikowano w katalogu WordPress. Podpisany plik zip stanowi osobny kanał dystrybucji.

01 / Od zera do widżetu

Instalacja

Pobierz saazly-chat.zip z kanału dystrybucji wskazanego przez Saazly.

Otwórz Wtyczki w WordPress Admin, wybierz Dodaj nową, a następnie Wyślij wtyczkę na serwer.

Zainstaluj plik zip i aktywuj Saazly Chat.

Otwórz Ustawienia, a następnie Saazly Chat. Wklej Widget ID z Saazly i zapisz.

Otwórz publiczną stronę sklepu i sprawdź, czy wyświetla się przycisk czatu.

Aby odczytywać zamówienia, administrator WooCommerce tworzy klucz REST API z uprawnieniem read i łączy sklep w Saazly w sekcji Ustawienia i Połączenia zamówień.

02 / Minimalny dostęp

Uprawnienia i zakresy

Uprawnienie WordPress

Tylko użytkownicy z uprawnieniem manage_options mogą zmieniać Widget ID.

Wtyczka widżetu

Wtyczka nie wymaga żadnych specjalnych uprawnień WooCommerce i nie korzysta z kluczy REST API.

Połączenie z zamówieniami

Oddzielne połączenie serwerowe korzysta z klucza WooCommerce REST API z uprawnieniem read. Saazly nie zapisuje zamówień, płatności, realizacji ani danych klientów.

Dopasowywanie klienta

Sam adres e-mail lub numer zamówienia nigdy nie daje zweryfikowanego dopasowania. Numer zamówienia musi być połączony z imieniem i nazwiskiem lub adresem e-mail zgodnym z zamówieniem u dostawcy.

03 / Kontrakt danych

Odczytywane i zapisywane dane

Odczytywane lokalnie

Zapisany publiczny Widget ID. Strona ustawień może odczytać publiczną nazwę widżetu z Saazly.

Zapisywane lokalnie

Jedna wartość opcji WordPress zawierająca publiczny Widget ID.

Koszyk zgłaszany przez przeglądarkę

Widżet może odczytywać produkty, liczbę, cenę i walutę z aktualnego koszyka odwiedzającego. Jest to kontekst behawioralny, a nie zweryfikowane dane zamówienia.

Zamówienie zweryfikowane przez dostawcę

Adapter serwerowy odczytuje identyfikator zamówienia, przyjazny dla klienta numer zamówienia, kwotę, walutę, status płatności, status realizacji, przesyłki, znaczniki czasu dostawcy, źródło danych i ich aktualność.

04 / Zdarzenia

Webhooki

Wtyczka nie korzysta z webhooków

Wersja 1.0.0 wtyczki widżetu nie rejestruje ani nie odbiera żadnych webhooków.

Podpisane webhooki zamówień

Połączenie serwerowe rejestruje order.created i order.updated. Każde dostarczenie jest weryfikowane za pomocą HMAC SHA 256, deduplikowane według delivery id i uzgadniane z czasem modified dostawcy.

Reconciliation

Podpisane wykonanie po stronie serwera odczytuje zmienione zamówienia z WooCommerce i odtwarza pominięte webhooki, nie pozwalając starszym zdarzeniom nadpisać nowszych danych.

Ruch widżetu

Załadowany widżet korzysta z publicznej konfiguracji widżetu i usługi czatu Saazly zgodnie z polityką prywatności Saazly.

05 / Dane poufne

Przechowywanie tokenów

Wtyczka nie przechowuje tokenów

Wtyczka widżetu nie przechowuje access tokenów, refresh tokenów, kluczy API ani haseł.

Zaszyfrowane dane dostępowe serwera

Consumer key, consumer secret i webhook secret są szyfrowane za pomocą AES 256 GCM przed zapisaniem w bazie danych. Uwierzytelnieni klienci nie mają dostępu do tabeli z tymi wartościami.

Widget ID

Widget ID jest publicznym identyfikatorem i jest przechowywany jako wartość opcji WordPress.

06 / Czyste usunięcie

Odinstalowanie

Wyłącz Saazly Chat w sekcji Wtyczki.

Usuń wtyczkę, jeśli chcesz pozbyć się jej całkowicie.

Podczas usuwania uninstall.php kasuje klucz opcji saazly_chat_widget_id ze zwykłej instalacji, z każdej witryny w WordPress multisite oraz z site options sieci.

Czyszczeniem danych przeglądarki zarządza standardowy proces usuwania danych Saazly i usunięcie plików WordPress nie ma na niego wpływu.

Połączenie z zamówieniami wyłącza się osobno w Saazly. Zaszyfrowane dane dostępowe są czyszczone, lokalny dostęp blokowany, a zarejestrowane webhooki zamówień usuwane w WooCommerce, gdy sklep odpowiada.

07 / Gdy coś przestaje działać

Rozwiązywanie problemów

Widget ID nie jest akceptowany

Skopiuj pełną wartość UUID z Saazly. Spacje są usuwane, ale niepełna wartość nie zostanie zapisana.

Widżet się nie wyświetla

Sprawdź, czy wtyczka jest aktywna, Widget ID został zapisany, a Content Security Policy strony zezwala na cdn.saazly.com.

Weryfikacja nie dociera do Saazly

Widget ID zostanie zapisany nawet wtedy, gdy sprawdzenie nazwy tymczasowo się nie powiedzie. Sprawdź wychodzące połączenia HTTPS z serwera WordPress.

Połączenie z zamówieniami zostało odrzucone

Sprawdź, czy klucz ma uprawnienie read, adres HTTPS jest dokładny, a status systemu pokazuje ten sam adres witryny.

Dane zamówienia są nieaktualne

Sprawdź status integracji w Saazly. Ponowne odtworzenie webhooka jest bezpieczne, a reconciliation pobiera zamówienia zmienione od ostatniego cursor.

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 WooCommerce | Dokumentacja Saazly