WooCommerce — katalog produktów

Po podłączeniu katalogu asystent zna Twoje produkty, ceny i dostępność — poleca je w rozmowie jako karty z przyciskiem kupna i mówi wprost, gdy czegoś nie ma na stanie.

Konfiguracja w sklepie WordPress

1. Klucz REST API: WooCommerce → Ustawienia → Zaawansowane → REST API → Dodaj klucz → uprawnienia Odczyt → skopiuj consumer key (ck_…) i consumer secret (cs_…) (secret jest pokazywany raz).
2. Permalinki: Ustawienia → Bezpośrednie odnośniki — dowolne ustawienie poza „Proste" (REST API wymaga działających permalinków).
3. Wtyczka Clovie Embed: Wtyczki → Dodaj nową → Wyślij wtyczkę → clovie-embed-woocommerce.zip → Zainstaluj → Włącz.

Konfiguracja w panelu Clovie

1. Konfigurator asystenta → krok Integracje → karta Sklep internetowy → platforma WooCommerce.
2. Wpisz URL sklepu, consumer key i consumer secret; zaznacz, czy ceny są brutto.
3. Testuj połączenie → po sukcesie Połącz sklep (uruchamia pierwszy pełny sync).
4. Skopiuj Endpoint zdarzeń i Token synchronizacji → wklej w WordPressie (Ustawienia → Clovie) i włącz Synchronizuj katalog produktów.

Co wysyła wtyczka (sync zdarzeniowy)

Hooki: woocommerce_new/update_product, woocommerce_new/update_product_variation, woocommerce_product_set_stock, woocommerce_variation_set_stock, woocommerce_order_status_processing/completed, wp_trash_post/before_delete_post (typ product). Id produktów są zbierane per żądanie PHP i wysyłane raz w shutdown (debounce — masowa edycja/import nie generuje lawiny POST-ów), fire-and-forget (blocking => false, timeout 3 s).

Typowe błędy

Objaw	Rozwiązanie
401/403 przy teście	Sprawdź consumer key/secret i uprawnienie Odczyt; klucz musi należeć do użytkownika z dostępem do produktów
404 /wp-json/…	Włącz permalinki (inne niż „Proste"); sprawdź, czy WooCommerce jest aktywne
Katalog się nie odświeża po sprzedaży	W Ustawienia → Clovie sprawdź endpoint+token i włączony przełącznik syncu
Brak liczby sztuk w odpowiedziach	Sklep nie śledzi stanów (manage_stock wyłączone) — zachowanie zamierzone