Integracje

Magento — katalog produktów

Jak podpiąć sklep Magento 2 do Clovie: token integracji, moduł, synchronizacja zdarzeń.

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 adminie Magento

Token integracji: System → Extensions → Integrations → Add New Integration → w zakładce API zaznacz zasoby Catalog i Sales → Save → Activate → skopiuj Access Token.
Moduł Clovie Embed: rozpakuj clovie-embed-magento2.zip do app/code/Clovie/Embed/, następnie:
```
bin/magento module:enable Clovie_Embed
bin/magento setup:upgrade && bin/magento setup:di:compile && bin/magento cache:flush
```
(alternatywnie composer require clovie/module-embed — patrz README modułu).

Konfiguracja w panelu Clovie

Konfigurator asystenta → krok Integracje → karta Sklep internetowy → platforma Magento 2 / Adobe Commerce.
Wpisz URL sklepu i Access Token integracji; zaznacz, czy ceny są brutto.
Testuj połączenie → Połącz sklep (pierwszy pełny sync).
Skopiuj Endpoint zdarzeń i Token synchronizacji → wklej w Magento (Stores → Configuration → General → Clovie Embed) i włącz Synchronizuj katalog produktów.

Co wysyła moduł (sync zdarzeniowy)

Observery: catalog_product_save_after, catalog_product_delete_after, cataloginventory_stock_item_save_after, sales_order_place_after → POST listy id produktów (fire-and-forget, curl timeout 4 s, token szyfrowany Encryptorem).

Typowe błędy

Objaw	Rozwiązanie
401 przy teście	Integracja nieaktywowana (Activate) albo token bez zasobu Catalog
Zły URL produktu	Sklep używa innego sufiksu niż `.html` (Stores → Configuration → Catalog → SEO) — zweryfikuj linki w czacie
Liczby sztuk nie zgadzają się per magazyn	MSI uproszczone do agregatu (v1) — stan łączny, nie per source
Moduł nie wysyła zdarzeń	Sprawdź endpoint (https), token i przełącznik w Stores → Configuration → Clovie Embed