AI Actions Reference

Kiedy połączysz się z odpowiednimi uprawnieniami API, twój asystent AI może wykonywać następujące działania w twoim sklepie PrestaShop w czasie rzeczywistym. Te działania są dostępne w przepływach pracy SmartFlow i mogą być również używane przez AI podczas rozmów z twoimi klientami.

---

Produkty

Pobierz Produkt

Pobierz pełne szczegóły produktu według jego ID.

• Wejście: ID produktu
• Zwraca: Nazwa, opis, krótki opis, referencja, cena, ilość w magazynie, status aktywności, pola SEO (meta tytuł, meta opis, meta słowa kluczowe)
• Uprawnienie API: products (GET)

Zaktualizuj Treść Produktu

Zaktualizuj opis i/lub krótki opis produktu, z pełnym wsparciem wielojęzycznym.

• Wejścia: ID produktu, opis (opcjonalnie), krótki opis (opcjonalnie), ID języka (opcjonalnie — domyślnie używa głównego języka sklepu)
• Zwraca: Potwierdzenie z listą zaktualizowanych pól
• Uprawnienie API: products (GET + PUT)

wskazówka

AI zachowuje treści w innych językach podczas aktualizacji konkretnego języka. Na przykład, aktualizacja opisu w języku francuskim nie wpłynie na wersję angielską.

Zaktualizuj SEO Produktu

Zaktualizuj pola SEO produktu, z wsparciem wielojęzycznym.

• Wejścia: ID produktu, meta tytuł (opcjonalnie), meta opis (opcjonalnie), meta słowa kluczowe (opcjonalnie), ID języka (opcjonalnie)
• Zwraca: Potwierdzenie z zaktualizowanymi wartościami SEO
• Uprawnienie API: products (GET + PUT)

---

Zamówienia

Pobierz Zamówienie według Referencji

Wyszukaj konkretne zamówienie używając jego numeru referencyjnego (np. ABCDEF123).

• Wejście: Referencja zamówienia
• Zwraca: Pełne szczegóły zamówienia, w tym data, status, całkowita kwota, metoda płatności, informacje o wysyłce oraz lista produktów
• Uprawnienie API: orders (GET), order_details (GET), order_states (GET)

Pobierz Zamówienia według E-maila

Pobierz wszystkie zamówienia złożone przez konkretnego klienta.

• Wejścia: E-mail klienta, limit (opcjonalnie — domyślnie 10)
• Zwraca: Lista zamówień z pełnymi szczegółami, całkowita liczba
• Uprawnienie API: orders (GET), order_details (GET), order_states (GET), customers (GET)

Pobierz Ostatnie Zamówienie

Pobierz najnowsze zamówienie dla konkretnego klienta.

• Wejście: E-mail klienta
• Zwraca: Najnowsze zamówienie z pełnymi szczegółami lub null, jeśli nie znaleziono zamówień
• Uprawnienie API: orders (GET), order_details (GET), order_states (GET), customers (GET)

Zaktualizuj Status Zamówienia

Zmień status zamówienia (np. oznacz jako wysłane, oznacz jako dostarczone).

• Wejścia: ID zamówienia, nowy ID stanu zamówienia, wysyłanie powiadomienia e-mail (opcjonalnie — domyślnie nie)
• Zwraca: Potwierdzenie z nowym statusem i informacją, czy wysłano e-mail
• Uprawnienie API: order_histories (GET + POST)

ostrzeżenie

Zmiana statusu zamówienia może wywołać powiadomienia e-mail dla klientów, jeśli opcja sendEmail jest włączona. Upewnij się, że zastosowano poprawny status.

---

Klienci

Pobierz Klienta

Wyszukaj klienta według jego adresu e-mail.

• Wejście: E-mail klienta
• Zwraca: ID klienta, imię, nazwisko, e-mail, data urodzenia, status subskrypcji newslettera, data rejestracji, notatki
• Uprawnienie API: customers (GET)

Zaktualizuj Klienta

Zaktualizuj informacje profilowe klienta.

• Wejścia: ID klienta, imię (opcjonalnie), nazwisko (opcjonalnie), e-mail (opcjonalnie), notatki (opcjonalnie)
• Zwraca: Potwierdzenie z listą zaktualizowanych pól
• Uprawnienie API: customers (GET + PUT)

---

Konfiguracja

Pobierz Języki

Wypisz wszystkie języki skonfigurowane w twoim sklepie PrestaShop.

• Nie wymaga wejścia
• Zwraca: Lista języków z ID, nazwą i kodem ISO (np. fr, en, de)
• Uprawnienie API: languages (GET)

informacja

To działanie jest używane wewnętrznie przez AI podczas wykonywania wielojęzycznych aktualizacji produktów, aby zapewnić użycie poprawnego ID języka.

---

Tabela podsumowująca

Działanie	Kategoria	Odczyt	Zapis
Pobierz Produkt	Produkty	Tak	—
Zaktualizuj Treść Produktu	Produkty	Tak	Tak
Zaktualizuj SEO Produktu	Produkty	Tak	Tak
Pobierz Zamówienie według Referencji	Zamówienia	Tak	—
Pobierz Zamówienia według E-maila	Zamówienia	Tak	—
Pobierz Ostatnie Zamówienie	Zamówienia	Tak	—
Zaktualizuj Status Zamówienia	Zamówienia	—	Tak
Pobierz Klienta	Klienci	Tak	—
Zaktualizuj Klienta	Klienci	Tak	Tak
Pobierz Języki	Konfiguracja	Tak	—

---

Powiązane

• Uprawnienia API — Skonfiguruj wymagane uprawnienia Webservice
• Webhooki i Umiejętności — Automatycznie wyzwalaj te działania na zdarzenia w sklepie