Uprawnienia API

Aby odblokować pełny potencjał AI SmartTalk — takie jak przeszukiwanie zamówień, aktualizowanie opisów produktów czy zarządzanie klientami — musisz skonfigurować token API Webservice PrestaShop z odpowiednimi uprawnieniami.

informacja

Ten krok jest wymagany, jeśli chcesz korzystać z AI Actions (SmartFlow). Bez tego twój asystent AI może nadal odpowiadać na pytania na podstawie zsynchronizowanej wiedzy, ale nie będzie w stanie uzyskać dostępu do danych sklepu w czasie rzeczywistym.

---

1. Włączenie Webservice

1. Przejdź do Zaawansowane parametry > Webservice
2. Włącz webservice PrestaShop
3. Kliknij Zapisz

---

2. Tworzenie klucza API

1. Na stronie Webservice kliknij Dodaj nowy klucz webservice
2. Wypełnij formularz:
   • Klucz: Kliknij Generuj, aby utworzyć bezpieczny token, lub wprowadź własny
   • Opis klucza: AI SmartTalk
   • Status: Włączony
3. Ustaw uprawnienia zgodnie z opisem poniżej
4. Kliknij Zapisz

ostrzeżenie

Skopiuj i zapisz klucz API — będziesz go potrzebować podczas konfigurowania integracji w AI SmartTalk.

---

3. Wymagane uprawnienia

W sekcji uprawnień twojego klucza API włącz następujące zasoby:

Zasób	GET	PUT	POST	Opis
produkty	Tak	Tak	—	Odczyt szczegółów produktu, aktualizacja opisów i SEO
zamówienia	Tak	—	—	Wyszukiwanie zamówień według referencji lub klienta
szczegóły_zamówienia	Tak	—	—	Wyświetlanie produktów w zamówieniu
stany_zamówienia	Tak	—	—	Odczyt etykiet statusów zamówienia
historie_zamówień	Tak	—	Tak	Odczyt historii statusów, dodawanie zmian statusu
klienci	Tak	Tak	—	Wyszukiwanie i aktualizacja informacji o kliencie
języki	Tak	—	—	Lista dostępnych języków sklepu

wskazówka

Zaznacz tylko uprawnienia wymienione powyżej. Nie ma potrzeby przyznawania dostępu do innych zasobów.

---

4. Do czego służy każdy zasób

Produkty (odczyt + zapis)

• Odczyt: Pobieranie szczegółów produktu — nazwa, opis, krótki opis, cena, referencja, stan magazynowy, pola SEO (meta tytuł, meta opis, meta słowa kluczowe)
• Zapis: Aktualizacja opisów produktów, krótkich opisów i pól SEO z pełnym wsparciem wielojęzycznym

Zamówienia (tylko odczyt)

• Wyszukiwanie zamówienia po numerze referencyjnym
• Lista zamówień dla konkretnego klienta (po e-mailu)
• Uzyskanie najnowszego zamówienia dla klienta

Szczegóły Zamówienia (tylko odczyt)

• Wyświetlanie produktów w zamówieniu: nazwa, referencja, ilość, cena jednostkowa

Stany Zamówienia (tylko odczyt)

• Pobieranie etykiety w formie czytelnej dla człowieka dla każdego statusu zamówienia (np. "Płatność zaakceptowana", "Wysłane")

Historie Zamówień (odczyt + tworzenie)

• Odczyt: Wyświetlanie historii zmian statusu zamówienia
• Tworzenie: Dodawanie nowej zmiany statusu do zamówienia (np. oznaczenie jako wysłane), z opcjonalnym powiadomieniem e-mailowym do klienta

Klienci (odczyt + zapis)

• Odczyt: Wyszukiwanie klienta po e-mailu lub ID — pobieranie imienia, nazwiska, daty rejestracji, statusu subskrypcji newslettera, notatek
• Zapis: Aktualizacja informacji o kliencie (imię, nazwisko, e-mail, notatki)

Języki (tylko odczyt)

• Lista wszystkich języków skonfigurowanych w twoim sklepie (używana do wielojęzycznych aktualizacji produktów)

---

5. Wprowadzenie klucza API w AI SmartTalk

Gdy twój klucz Webservice zostanie utworzony i skonfigurowany:

1. Przejdź do konfiguracji modułu AI SmartTalk w PrestaShop
2. Klucz API jest zazwyczaj przesyłany podczas połączenia OAuth
3. Jeśli musisz go zaktualizować, przejdź do swojego pulpitu AI SmartTalk > Integracja > PrestaShop i zaktualizuj token Webservice

Dla konfiguracji wielostanowiskowych, każda witryna może mieć własny klucz API Webservice skonfigurowany niezależnie.

---

Następne kroki

• Synchronizuj dane swojego sklepu — Prześlij swój katalog produktów do AI
• Zobacz, co może AI — Pełna dokumentacja dostępnych działań