Instrukcja Integracji

Aby Twój asystent AI mógł nauczyć się Twojej oferty, potrzebujemy bezpiecznego dostępu do treści strony. Wybierz swój system poniżej i postępuj zgodnie z instrukcją.

🛍️ Sklep (WooCommerce)📝 Strona / Blog (WordPress)🛒 Shoper 🛍️ Shopify 🌐 Wix

🛍️WooCommerce (Sklep)

Instrukcja generowania kluczy Consumer Key oraz Consumer Secret.

Wejdź w ustawienia

Zaloguj się do panelu administratora WordPress. W menu po lewej wybierz: WooCommerce → Ustawienia.

Znajdź zakładkę REST API

Kliknij w zakładkę Zaawansowane (na górze po prawej), a następnie w podmenu wybierz REST API.

Dodaj nowy klucz

Kliknij przycisk Dodaj klucz. Opis: np. "ZenTalk AI". Użytkownik: administrator. Uprawnienia: Odczyt (Read).

Skopiuj dane

Kliknij "Wygeneruj klucz API". Zobaczysz dwa ciągi znaków: Consumer Key i Consumer Secret.

Klucz klienta (Consumer Key)

ck_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Sekret klienta (Consumer Secret)

cs_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

⚠️ Ważne: Skopiuj te klucze TERAZ. Po opuszczeniu tej strony nie będziesz mógł ich już zobaczyć!

📝WordPress (Strona / Blog)

Instrukcja generowania Hasła Aplikacji (Application Password).

Uwaga: Hasło Aplikacji to NIE jest Twoje hasło do logowania. To specjalny kod, który pozwala systemom zewnętrznym (jak nasz bot) czytać treść strony w bezpieczny sposób.

Wejdź w swój profil

Zaloguj się do panelu WordPress. W menu po lewej wybierz: Użytkownicy → Profil (lub "Twój profil").

Znajdź sekcję Haseł Aplikacji

Przewiń stronę na sam dół, aż znajdziesz sekcję Hasła aplikacji (Application Passwords). * Jeśli nie widzisz tej sekcji, upewnij się, że WordPress jest zaktualizowany (5.6+).

Utwórz nowe hasło

W polu "Nazwa nowego hasła aplikacji" wpisz np. ZenTalk i kliknij "Dodaj nowe hasło aplikacji".

Skopiuj hasło

WordPress wyświetli hasło w ramce. Skopiuj je w całości (spacje nie mają znaczenia, system je usunie).

Hasło aplikacji

xxxx xxxx xxxx xxxx

🛒Shoper

Instrukcja generowania klucza API z ograniczonymi uprawnieniami (tylko odczyt katalogu). Klucz wkleisz w panelu ZenTalk w zakładce Integracje.

Zalecana praktyka bezpieczeństwa: używaj osobnego użytkownika z dostępem tylko do WebAPI w trybie odczytu. ZenTalk nie potrzebuje dostępu do zamówień ani danych klientów.

Utwórz grupę administratorów

Zaloguj się do panelu Shopera. Wejdź w: Ustawienia → Ogólne → Grupy administratorów. Kliknij Dodaj grupę i nazwij ją np. "AI Integracja".

Ustaw tylko odczyt WebAPI

W zakładce Uprawnienia odznacz wszystko. Zaznacz jedynie WebAPI (dostęp do API). W sekcji WebAPI ustaw TYLKO odczyt (GET) dla: Produkty (Kategorie, Producenci, Atrybuty, Warianty, Zdjęcia), Strony informacyjne, Blog (Wpisy, Kategorie). Ważne: Zamówienia i Klienci muszą być ODZNACZONE.

Dodaj użytkownika do grupy

Wejdź w: Ustawienia → Ogólne → Użytkownicy. Dodaj nowego użytkownika (np. api_zenTalk), ustaw hasło i przypisz go do grupy "AI Integracja". Zapisz.

Wygeneruj klucz API

W panelu Shopera wejdź w sekcję WebAPI lub Integracje (w zależności od wersji). Utwórz nowy klucz API / token dla utworzonego użytkownika (lub zaloguj się na tego użytkownika i wygeneruj klucz). Skopiuj wyświetlony klucz API – to jedyna wartość, której potrzebujesz.

Wklej klucz w ZenTalk

W panelu ZenTalk (zakładka Integracje przy danym kliencie) dodaj integrację typu Shoper. W polu "Shoper API Key" wklej skopiowany klucz. Zapisz. Od tego momentu synchronizacja będzie pobierać tylko produkty, strony i blog.

Shoper API Key

wklej_skopiowany_klucz_api

🛍️Shopify

Instrukcja generowania kluczy API z ograniczonymi uprawnieniami (odczyt katalogu). Klucze wkleisz w panelu ZenTalk w zakładce Integracje.

Zalecane: utwórz aplikację niestandardową z uprawnieniami tylko do odczytu (read_products, read_content). ZenTalk nie potrzebuje dostępu do zamówień ani danych klientów.

Utwórz aplikację niestandardową

Zaloguj się do panelu Shopify. Wejdź w: Ustawienia → Aplikacje i kanały sprzedaży → Opracuj aplikacje → Utwórz aplikację. Nazwij ją np. "ZenTalk AI".

Skonfiguruj uprawnienia API

W konfiguracji aplikacji wybierz Admin API. Ustaw tylko uprawnienia do odczytu, np.: read_products, read_online_store_pages (strony), read_content (blog). Nie włączaj uprawnień do zamówień ani klientów. Zapisz.

Zainstaluj aplikację i pobierz dane

Zainstaluj aplikację na sklepie (jeśli wymagane). W sekcji Klucze API / Tokeny skopiuj Client ID (lub API key) oraz Client Secret (lub API secret). W nowszych wersjach Shopify możesz wygenerować Admin API access token – skopiuj go.

Wklej klucze w ZenTalk

W panelu ZenTalk (zakładka Integracje) dodaj integrację typu Shopify. Wklej skopiowany API Key i API Secret w odpowiednie pola. Zapisz. Synchronizacja będzie pobierać tylko produkty i treści zgodnie z uprawnieniami.

Shopify API Key

shpua_xxxxxxxxxxxxxxxx

Shopify API Secret

shpus_xxxxxxxxxxxxxxxx

⚠️ Skopiuj klucze od razu – w niektórych konfiguracjach Secret pokazywany jest tylko raz.

🌐Wix

Instrukcja generowania klucza API. Klucz wkleisz w panelu ZenTalk w zakładce Integracje.

Użyj klucza API z uprawnieniami tylko do odczytu treści strony (produkty, blog, strony). ZenTalk nie potrzebuje dostępu do zamówień ani danych użytkowników.

Wejdź do Centrum Deweloperów

Zaloguj się na konto Wix. Wejdź na developers.wix.com lub w panelu strony: Ustawienia strony → Zaawansowane → API. Otwórz dashboard dewelopera / integracje.

Utwórz aplikację lub wybierz stronę

Utwórz nową aplikację (lub użyj istniejącej). Wybierz swoją stronę / sklep. W konfiguracji ustaw uprawnienia tylko do odczytu (np. odczyt katalogu, stron, bloga).

Wygeneruj klucz API

W sekcji API Keys / Credentials wygeneruj nowy klucz API (lub skopiuj istniejący). Zapisz go w bezpiecznym miejscu – to jedyna wartość, której potrzebujesz do ZenTalk.

Wklej klucz w ZenTalk

W panelu ZenTalk (zakładka Integracje przy danym kliencie) dodaj integrację typu Wix. W polu "Wix API Key" wklej skopiowany klucz. Zapisz. Synchronizacja będzie pobierać treści zgodnie z uprawnieniami klucza.

Wix API Key

wklej_skopiowany_klucz_api