Jak AI może obsługiwać zamówienia i pisać opisy produktów w sklepie na Shopware lub Sylius?

Shopware 6 i Sylius mają otwarte REST API, przez które AI może czytać zamówienia, stany dostaw, dane klientów i zawartość katalogu produktów bez żadnych dodatkowych wtyczek. Oznacza to, że AI może odpowiadać klientom na pytania o status paczki, pisać opisy produktów dla całego katalogu i wysyłać alert do managera, gdy zamówienie od 48 godzin nie zmieniło statusu. Żadna z tych rzeczy nie wymaga przepisywania sklepu od podstaw.

Co siedzi w Shopware i Sylius, zanim AI cokolwiek zobaczy

Shopware 6 to platforma sklepowa z siedzibą producenta w Niemczech, popularna w Polsce przy wdrożeniach B2B i większych sklepach wielokanałowych. Sylius to framework e-commerce rozwijany przez firmę z Poznania, oparty na Symfony. Oba systemy mają bogatą strukturę danych i dobrze udokumentowane API.

W Shopware każde zamówienie ma swój orderNumber, stan w polu stateMachineState.technicalName (np. open, in_progress, completed, cancelled) i osobny stan dostawy: open, shipped, returned. Do każdego zamówienia doczepiony jest klient (orderCustomer) z adresem e-mail, pozycje (lineItems) z nazwami produktów i ilościami oraz informacje o sposobie płatności i dostawy. To są pola, z których AI czerpie, gdy odpowiada na pytanie klienta.

Sylius ma podobną strukturę, ale stany zamówienia nazywają się inaczej: cart, new, payment_pending, payment_processing, confirmed, fulfilled, cancelled. Porzucony koszyk to po prostu zamówienie w stanie cart, które nie było aktualizowane od kilku godzin. Każdy produkt ma warianty (ProductVariant) z własnym kodem, ceną (price) i stanem magazynowym (stockOnHand).

Shopware ma też pojęcie Verkaufskanäle (kanałów sprzedaży): możecie mieć osobny kanał dla sklepu detalicznego, B2B, wersji na rynek niemiecki i polskiej domeny, każdy z własną dziedziną, cennikiem i widocznością produktów. W Sylius to samo realizują Channels. AI może raportować sprzedaż osobno dla każdego kanału, bo każde zamówienie jest przypisane do konkretnego z nich.

Jak fizycznie wygląda podłączenie: Admin API, klucze i uprawnienia

Shopware 6 ma dwa główne API: Admin API do zarządzania sklepem (zamówienia, produkty, klienci, promocje) i Store API do interakcji z frontendem. Do integracji z AI wykorzystujemy Admin API.

Żeby się do niego dostać, wchodzicie w panelu admina do Ustawienia / System / Integracje i tworzycie nową integrację z opisową nazwą (np. "Integracja AI redAi"). Shopware wygeneruje Client ID i Client Secret. Kod wysyła żądanie POST na /api/oauth/token z tymi danymi i w odpowiedzi dostaje token dostępu. Kolejne żądania dołączają ten token w nagłówku Authorization: Bearer. Token wygasa co kilkadziesiąt minut, więc kod sam go odświeża. Klucz możecie unieważnić w każdej chwili z poziomu panelu.

Przykładowe zapytanie do zamówień: /api/order?filter[stateMachineState.technicalName]=open&sort=-orderDateTime zwraca listę otwartych zamówień, posortowanych od najnowszego. Możecie zawęzić do konkretnego kanału sprzedaży, zakresu dat albo konkretnego klienta. Shopware ma też webhooks w Ustawienia / System / Webhooki, które mogą wysłać zdarzenie do Waszego serwera natychmiast przy zmianie statusu zamówienia.

Sylius od wersji 1.9 korzysta z API Platform opartego na standardzie JSON:API i OpenAPI. Uwierzytelnianie idzie przez JWT: wysyłacie dane logowania na /api/v2/admin/token i dostajecie token. Zasoby są dostępne pod adresami w stylu /api/v2/admin/orders, /api/v2/admin/products, /api/v2/admin/customers. Na Waszej instalacji Sylius wystawia interaktywną dokumentację pod /api/v2/docs, gdzie można przetestować każde zapytanie bez pisania kodu.

Czego producent nie udostępnia wprost: Shopware nie ma gotowego "endpointu porzuconych koszyków" w Admin API. Koszyki siedzą w bazie w tabeli cart, ale dostęp przez API jest tu ograniczony. Praktyczna droga to albo bezpośredni dostęp do bazy przez bezpieczne połączenie, albo wtyczka, która wystawia te dane przez API. W Sylius jest prościej: zamówienia w stanie cart to porzucone koszyki i możecie je odpytać normalnym zapytaniem z filtrem na datę ostatniej aktualizacji.

Co AI robi z zamówieniami i pytaniami klientów

Typowe pytanie do obsługi: "Kiedy dotrze moje zamówienie numer 12345?" Zamiast żeby pracownik logował się do panelu, szukał zamówienia i pisał odpowiedź ręcznie, AI może to zrobić sama. Klient wysyła pytanie przez czat albo formularz na stronie, narzędzie wyciąga numer zamówienia z treści, pyta API Shopware o stateMachineState i deliveries[0].trackingCodes, a potem układa odpowiedź po polsku z konkretnymi danymi.

U jednego klienta, który prowadzi sklep na Shopware z własną obsługą logistyki, zanim uruchomiliśmy takie narzędzie, znaczna część czasu dwóch osób z obsługi szła na odpowiadanie właśnie na tego rodzaju pytania o paczki. Po wdrożeniu AI te zapytania obsługuje sama, a team zajmuje się przypadkami wyjątkowymi: reklamacjami, zwrotami, sprawami wymagającymi decyzji, których AI nie podejmie.

AI potrafi też wykrywać zamówienia, które utknęły. Wyobraźcie sobie codzienną kontrolę uruchamianą o 7 rano: skrypt pyta API o zamówienia, których stateMachineState.technicalName nie zmieniło się przez ostatnie 48 godzin i które nie mają statusu completed ani cancelled. AI przegląda tę listę, sprawdza, czy przy zamówieniu jest numer śledzenia i czy nie ma notatki od obsługi, a potem wysyła podsumowanie do managera z listą numerów do sprawdzenia. Bez takiego narzędzia te zamówienia leżą niezauważone, dopóki klient sam nie napisze reklamacji.

Sylius ma tutaj dodatkową zaletę: stany płatności i stany zamówienia to osobne byty. AI może wyłapać zamówienia w stanie payment_pending trwającym dłużej niż kilka godzin i oznaczyć je jako wymagające sprawdzenia, bo może coś poszło nie tak przy bramce płatniczej.

Porzucone koszyki: jak je wyciągnąć i co z nimi zrobić

Porzucony koszyk to klient, który dodał produkty, zaczął checkout i zniknął. Powodów jest wiele: rozproszenie, wątpliwości co do ceny dostawy, konieczność porównania z konkurencją. AI może tu zadziałać na dwa sposoby.

Pierwszy: identyfikacja i raportowanie. W Sylius zapytanie /api/v2/admin/orders?state=cart z filtrem na pole updatedAt zwraca wszystkie koszyki niezmodyfikowane od np. dwóch godzin. AI może codziennie generować zestawienie: ile koszyków porzuconych, jaka łączna wartość, jakie produkty najczęściej w tych koszykach. To informacja dla managera o tym, gdzie jest nieszczelność w procesie zakupowym.

Drugi: personalizacja wiadomości odzyskującej. AI czyta zawartość koszyka (jakie produkty, w jakiej ilości, o jakiej wartości), patrzy na historię klienta w polu customer.orders i układa wiadomość dopasowaną do kontekstu. Nie wysyła generycznego "zostawiłeś coś w koszyku", tylko pisze coś konkretnego. Klientowi, który kupował już regularnie, wystarczy krótkie "Coś przerwało? Koszyk na Ciebie czeka." Nowemu klientowi, który nie kupował nigdy, AI może dołączyć do wiadomości odpowiedź na najczęstsze obiekcje dotyczące tego produktu.

Shopware ma wbudowany moduł odzyskiwania koszyków w sekcji Marketing / Automatyzacje, ale AI daje tu więcej: analizuje wzorce (o jakiej porze klienci najczęściej porzucają, przy którym kroku checkoutu, przy jakim typie produktu) i dostosowuje treść maila do kontekstu, zamiast wysyłać jeden szablon dla wszystkich.

Opisy produktów: od wariantu do tekstu gotowego na sklep

Shopware trzyma produkty w zasobie /api/product. Każdy produkt ma name, description, customFields i doczepione opcje wariantów przez configuratorSettings. Warianty to osobne byty ProductVariant z własnymi cenami i stanami magazynowymi.

Typowy problem przy dużym katalogu: producent dostarcza excel z parametrami produktów i jednolinijkowym opisem z katalogu technicznego. Trzeba to zamienić w opisy przyjazne klientom i zoptymalizowane pod wyszukiwarki. AI czyta parametry z pliku albo bezpośrednio przez API, dostaje wytyczne (ton, długość, słowa kluczowe do wplenienia, grupę docelową) i pisze opisy dla kolejnych produktów.

Przy wariantach jest dodatkowa logika: nie piszemy osobnego opisu dla każdego koloru i rozmiaru, ale AI rozumie, że opis dotyczy produktu bazowego, a warianty to różnice do wyliczenia. Shopware umożliwia ustawienie jednego opisu na poziomie produktu nadrzędnego i AI może to sensownie obsłużyć, bez dublowania treści.

W Sylius produkty siedzą pod /api/v2/admin/products, a warianty pod /api/v2/admin/product-variants. Każdy produkt ma też przynależność do taxonów (kategorii), co AI może wykorzystać do dostosowania języka opisu. Inaczej pisze się o elektronice użytkowej, inaczej o artykułach dziecięcych, inaczej o produktach B2B.

• Nowe produkty z dostawy: AI przetwarza je na bieżąco, opisy gotowe tego samego dnia
• Stary katalog bez opisów: AI przechodzi przez produkty w partiach, każdy dostaje opis według jednego szablonu
• Tłumaczenia dla kanałów zagranicznych: AI tłumaczy i adaptuje opisy pod konkretny rynek, nie kalkuje słowo po słowie
• Aktualizacje po zmianie specyfikacji: AI porównuje stary opis z nowymi parametrami i wskazuje, co wymaga korekty

Raporty według kanału sprzedaży: co się sprzedaje gdzie i kiedy

Jeśli prowadzicie sprzedaż przez kilka kanałów w Shopware (własny sklep detaliczny, sklep B2B, wersja zagraniczna), każde zamówienie ma przypisane salesChannelId. AI może codziennie rano wyciągać zamówienia z poprzedniej doby, grupować według kanału i pisać krótkie podsumowanie dla managera: ile zamówień, jaka wartość, co się sprzedało najlepiej, gdzie było wyjątkowo spokojnie.

Shopware ma wbudowane raporty w sekcji Statystyki, ale to dashboardy do klikania w panelu, nie coś, co wpada do Waszej skrzynki albo do Teams o konkretnej godzinie. AI-owy raport działa jak asystent, który już przejrzał dane i mówi Wam, co ważne, zamiast czekać, aż sami znajdziecie czas na logowanie.

W Sylius kanały to osobne byty Channel. Możecie mieć sklep detaliczny na polskim rynku i sklep B2B z innymi cenami i innymi widocznymi produktami, każdy z własną walutą i lokalizacją. Raportowanie AI może obejmować oba jednocześnie i pokazywać różnice: na którym kanale więcej porzuconych koszyków, gdzie wyższy kosz zamówienia, gdzie więcej reklamacji w polu notes.

To nie jest zamiana dashboardu na chatbota. To jest godzinne zestawienie, które wpada do konkretnej osoby i zawiera zdania, a nie tylko liczby: "W kanale B2B wczoraj o 15 zamówieniach więcej niż tydzień temu, z czego 11 to klienci zarejestrowani w ostatnim miesiącu." Takie zdanie manager czyta w 10 sekund. Dashboard z tym samym przekazem zajmuje mu 5 minut klikania.

Od czego zaczęć: dwa konkretne pierwsze kroki

Zanim podłączycie AI, zróbcie jeden krok: sprawdźcie, jakie dane w ogóle macie w systemie. Otwórzcie kilka zamówień w panelu i zobaczcie, czy pola takie jak adres e-mail klienta, numer śledzenia i stan dostawy są wypełnione. Jeśli przez lata ktoś wpisywał dane nieregularnie albo sklep nie zbierał adresów e-mail przy checkout jako gość, AI nie wyczaruje danych, których tam nie ma. To dużo częstszy problem niż brak dostępu do API.

Drugi krok: wybierzcie jeden konkretny problem. Nie "integracja z AI ogólnie", tylko "chcemy, żeby klienci mogli przez czat zapytać o status zamówienia bez angażowania obsługi" albo "chcemy codziennie rano mieć raport o zamówieniach z poprzedniego dnia". Jedno konkretne zadanie daje mierzalny efekt i pozwala ocenić, czy warto iść dalej.

Po stronie technicznej potrzebujecie:

• W Shopware: Ustawienia / System / Integracje, nowa integracja z Client ID i Client Secret
• W Sylius: konto z rolą API, token JWT generowany przez /api/v2/admin/token
• Miejsca, gdzie kod będzie działał: serwer portalu, cron, narzędzie uruchamiane na żądanie
• Listy pól, które chcecie przekazywać AI: zdecydujcie, które dane osobowe są potrzebne do konkretnego zadania, a które można pominąć

Shopware obsługuje też promocje przez zasób /api/promotion z regułami warunkowymi i akcjami rabatowymi. AI może analizować, które promocje przyciągają porzucone koszyki z powrotem, a które w ogóle nie działają na danym kanale. Sylius ma Promotions z podobną logiką. To nie jest priorytet na start, ale dobry krok drugi, gdy macie już działające podstawowe scenariusze.

Jeśli chcecie zobaczyć, jak taki projekt wygląda w praktyce, zajrzyjcie do realnych wdrożeń. A jeśli macie konkretny system i konkretny problem, umówcie się na 15 minut rozmowy. Sprawdzimy razem, co da się zrobić i od czego zacząć.