Rozwiązania · Handel online
Łączymy asystenta z katalogiem sklepu przez jego publiczną bramę, uruchamiamy go na kanałach, na których klienci już piszą, i dajemy mu zasadę, której nie może złamać: nie podawaj ceny, która nie jest opublikowana w sklepie. Gdy wykracza poza rolę, przekazuje rozmowę człowiekowi, z zapisem.
Już zbudowaneMożna to sprawdzić z zewnątrz, bez pytania nas. Nasz punkt katalogowy dostarczony dystrybutorowi zwraca 200 i pokazuje „154 wyniki”, a publiczny interfejs jego sklepu, wywołany bezpośrednio, zwraca nagłówek `x-wp-total: 154` — ta sama liczba, dwa niezależne źródła, 06.09.2026. Druga implementacja to funkcja katalogu w platformie asystentów: `storeCatalog.service.js` plus trzy wbudowane narzędzia, które agent może wywołać w trakcie rozmowy. Zastrzeżenie, które podajemy przed umową: wiadomości z szablonu WhatsApp nie istnieją w kodzie platformy, więc nie obiecujemy żadnej proaktywnej wiadomości poza 24-godzinnym oknem; a ścieżka katalogu znajduje się na gałęzi rozwojowej, która nie jest scalona do pnia — dostarczona dla sklepów, które podłączyliśmy, a nie uruchomiona domyślnie dla wszystkich.
Asystent sklepu nie psuje się dlatego, że nie rozumie pytania. Psuje się dlatego, że odpowiada z kopii katalogu. Ktoś raz wyeksportował produkty, wkleił je do pliku i od tamtej pory asystent czyta stare zdjęcie sklepu: cenę sprzed trzech tygodni, stan magazynowy sprzed weekendu. Działa idealnie aż do pierwszej zmiany ceny i do pierwszego wyczerpanego produktu — a wtedy myli się z przekonaniem, co jest gorsze niż milczenie. W handlu to nie jest błąd niuansu: klient przychodzi do sklepu z ceną, którą podał mu bot.
Nasz wybór jest prosty i ma konsekwencje: katalog nie jest kopiowany, jest odczytywany. Dla sklepów na WooCommerce interfejs Store API jest publiczny — więc podłączenie odbywa się przez adres strony, bez klucza konsumenta i bez sekretu. Gdy klient pyta o produkt, agent wywołuje narzędzie, narzędzie pyta sklep, sklep odpowiada aktualną ceną i dostępnością. To, co pojawia się w rozmowie, jest tym, co jest w sklepie, a nie tym, co było w chwili integracji.
Koszt tego wyboru widać w kodzie, nie jest ukryty: katalog ładuje się stronicowo, do trzydziestu stron po sto produktów, jest trzymany w tymczasowej pamięci przez dziesięć minut na stronę i normalizowany do jednej formy, czytanej bez zmian przez wszystkich odbiorców — w tym przez karuzelę produktów w komunikatorze, która potrzebuje ceny liczbowej, oraz przez widget na stronie. Dziesięć minut to kompromis: zmiana ceny dokonana teraz jest widoczna najpóźniej po dziesięciu minutach, nie natychmiast. Podajemy tę liczbę, żeby można ją było zakwestionować.
Reszta ograniczeń nie pochodzi od nas, tylko od kanałów, i uczciwiej jest je znać wcześniej: Meta odrzuca dowolny tekst poza 24-godzinnym oknem od ostatniej wiadomości klienta, Instagram nie ma w ogóle karuzel produktów, a zdjęcie wysłane przez klienta jest oznaczane w rozmowie, nie jest automatycznie dołączane do zamówienia. Każde z tych zdań jest zacytowane niżej z plikiem i linią.
Co obejmuje
Agent ma trzy wbudowane narzędzia nad wspólnym serwisem katalogu: `store_catalog_search` do wyszukiwania, `store_catalog_match` do dopasowania formułowania klienta do konkretnego produktu, `store_catalog_product` do pełnej karty. To nie są narzędzia pisane osobno dla każdego sklepu — to funkcja platformy. Praktyczna różnica: gdy naprawiamy coś w dopasowaniu, naprawia się to jednocześnie dla wszystkich podłączonych sklepów.
Wynik narzędzia pochodzi z Twojego sklepu, a nie z pliku od nas. Pamięć tymczasowa wynosi dziesięć minut na stronę, a katalog jest przeglądany stronicowo — do 30 stron po 100 produktów. Konsekwencja, którą trzeba zaakceptować: zmiana ceny pojawia się w rozmowie z opóźnieniem najwyżej dziesięciu minut. Konsekwencja, którą zyskujesz: nie ma scenariusza, w którym agent przez miesiące powtarza cenę wyjętą ze sklepu.
Sześć kanałów ma własny kod w platformie: Messenger, Instagram Direct, Telegram, widget na stronie, lokalna platforma ogłoszeniowa oraz WhatsApp przez Cloud API na Graph v22.0. To nie jest jeden „chat” przemianowany sześć razy: każdy kanał ma własne reguły formatu i własne sposoby awarii, a my sprawdzamy też zły przypadek — wygasły token strony cicho zatrzymuje kanał, jeśli nie jest monitorowany.
Store API jest publiczne, więc nie prosimy o `consumer_key` ani `consumer_secret`. To nie wygoda, tylko decyzja o ryzyku: ręcznie pisane narzędzia, które ten wariant zastąpił, miały niektóre z nich klucze sklepu zapisane jawnie w bazie danych. Nowa ścieżka zastąpiła 109 ręcznie pisanych narzędzi, z których 28 było scraperami po HTML — czyli integracjami, które psuły się przy pierwszej zmianie motywu sklepu.
Na Messengerze karuzela wyświetla się tylko wtedy, gdy jednocześnie spełnione są trzy warunki; jeśli jednego brakuje, odpowiedź pozostaje tekstowa, a nie psuje się. Na Instagramie nie ma karuzeli produktów — Meta nie ma ogólnych szablonów na Instagramie, więc nikt nie może tego tam dostarczyć, niezależnie od tego, co jest w ofercie. To rodzaj zdania, które wolimy, żebyś usłyszała od nas przed umową.
Poza 24-godzinnym oknem od ostatniej wiadomości klienta Meta odrzuca dowolny tekst z błędem 131047, a wiadomość pozostaje oznaczona jako nieudana na platformie. Wiadomości szablonowe — jedyna legalna droga, by napisać jako pierwsza po upływie okna — nie istnieją w kodzie platformy: wyszukanie po typie `template` zwraca zero wyników, wysyłany jest tylko typ `text`. Czyli: odzyskiwania porzuconego koszyka na WhatsApp po 48 godzinach nie możemy dziś obiecać.
Webhook Meta naprawdę wysyła ponownie tę samą wiadomość: deduplikacja odbywa się po identyfikatorze wiadomości, z 120 sekundami pamięci. A klient, który pisze „hej”, „macie”, „czarny model” w trzech liniach, dostaje jedną odpowiedź na wszystko, co napisał, a nie trzy częściowe odpowiedzi — wiadomości są zbierane w buforze 15 sekund. W handlu ma to większe znaczenie, niż wygląda: trzy częściowe odpowiedzi na jeden zamiar wyglądają dokładnie jak bot.
Wątek ma jawny stan `bot` lub `human`. Dziennik przejęcia zna trzy działania: przejęcie przez człowieka, powrót do bota, automatyczna reaktywacja. Osobno wątek ma stan dotrzymania czasu odpowiedzi — `ok`, `warning`, `breached` — więc widać, która rozmowa została bez odpowiedzi człowieka, a nie tylko ile ich było.
Nie przyjmuje płatności. Nie tworzy zamówienia w sklepie, jeśli sklep nie ma ścieżki zapisu — odczyt jest publiczny, zapis nie. Nie dołącza zdjęcia wysłanego przez klienta do zamówienia: otrzymana fotografia jest oznaczana w rozmowie, tyle, a generowanie PDF nie istnieje na platformie. I nie powtarza poprzedniego zamówienia klienta bez autoryzowanego dostępu do jego historii. Każdą z tych rzeczy można zbudować, ale jako osobną pracę, a nie jako checkbox w ofercie.
Traseul
Pierwsza kontrola, nie ostatnia: pobieramy katalog z zewnątrz i liczymy, co wraca. Jeśli sklep działa na WooCommerce z aktywnym Store API, integracja nie potrzebuje kluczy. Jeśli nie, przechodzimy do uwierzytelniania — a wtedy klucz staje się elementem do zarządzania, ze wszystkim, co to oznacza. Wynik tej kontroli dostarczamy na piśmie, także wtedy, gdy odpowiedź brzmi, że się nie da.
Połączenie Meta odbywa się przez Embedded Signup. Przy każdym kanale sprawdzamy nie tylko pierwszą udaną wiadomość, lecz także to, co dzieje się, gdy token wygasa albo gdy sklep nie odpowiada. Dostarczamy połączone kanały i pisemną listę zachowania dla każdego trybu awarii.
Każde narzędzie ma pisany opis dla modelu, typowane parametry i własny czas wykonania — domyślnie 15 sekund. Rola agenta wyraźnie mówi, czego nie wolno mu twierdzić: nieopublikowanej ceny, terminu dostawy, dostępności, której nie odczytał. Dostarczamy konfigurację agenta i listę dołączonych do niego narzędzi — nie wszystkich narzędzi platformy, tylko tych, których potrzebuje.
Startujemy z skonfigurowanym przekazaniem do człowieka i z włączonym dziennikiem zapytań, aby było widać, z jakich fragmentów korzystał agent i z jakimi wynikami. Na tej podstawie reguluje się próg podobieństwa i liczbę fragmentów na pytanie. Dostarczamy raport rozmów z decyzjami regulacyjnymi, a nie tylko uruchomionego asystenta.
Dane
Zasady różnią się w zależności od branży. To są te, które obowiązują w handlu online.
Przykład
Sytuacja
Dystrybutor z Kiszyniowa sprzedawał przez sklep WooCommerce i odpowiadał na pytania o produkty na kanałach wiadomości. Oczywista integracja — eksport produktów umieszczony w bazie wiedzy agenta — działałaby do pierwszej kampanii rabatowej.
Co zbudowaliśmy
Połączyliśmy katalog przez publiczny interfejs sklepu, który nie wymaga kluczy, i dodaliśmy nad nim trzy narzędzia, które agent wywołuje w rozmowie: wyszukiwanie, dopasowanie i kartę produktu. Wyniki są normalizowane do jednej formy, czytanej tak samo przez karuzelę w komunikatorze i przez widget na stronie, żeby nie było dwóch prawd o tej samej cenie.
Co z tego wyszło
Sprawdzenie można wykonać z zewnątrz, bez wiary na słowo: nasz punkt katalogowy odpowiada 200 i raportuje 154 wyniki, a publiczny interfejs sklepu, odpytywany bezpośrednio, zwraca nagłówek `x-wp-total: 154`. Ta sama liczba, dwa niezależne źródła, tego samego dnia.
Czego nie mówi ten przypadek
Liczba dotyczy tego dnia, 06.09.2026, i zmienia się, gdy dystrybutor dodaje produkty — o to właśnie chodzi. To nie jest pomiar wydajności i nie mówi nic o sprzedaży; mówi tylko, że agent czyta rzeczywisty katalog.
Pytania
Bo nie ma skąd jej wziąć. Cena pochodzi z odpowiedzi Twojego sklepu w chwili pytania, przechowywanej w pamięci tymczasowej maksymalnie przez dziesięć minut. U nas nie ma kopii katalogu, z której mógłby czytać. Sprawdzenie możesz wykonać samodzielnie: pytasz agenta o produkt, zmieniasz cenę w sklepie, czekasz dziesięć minut i pytasz ponownie.
To, co mówi sklep. Dostępność pochodzi z tej samej odpowiedzi co cena. Czego nie robi — i to decyzja, a nie przeoczenie — to nie wymyśla daty ponownego zaopatrzenia. Jeśli chcesz, aby agent proponował alternatywy, gdy produktu nie ma, to reguła, którą zapisujemy wprost w jego roli i testujemy, a nie coś, co dzieje się samo.
Nie z czytania katalogu. Publiczne Store API to brama do odczytu; zapisanie zamówienia wymaga uwierzytelnionej ścieżki do sklepu, więc to osobna praca, z kluczami, którymi się zarządza. Co robi dziś: prowadzi klienta do właściwego produktu, z właściwą ceną, i daje link albo przekazuje rozmowę człowiekowi.
Na WhatsAppie nie, poza oknem 24 godzin. Meta odrzuca dowolny tekst z błędem 131047, a wiadomości szablonowe nie istnieją w kodzie platformy. Na Telegramie i Messengerze, w granicach reguł każdego kanału, istnieją zaprogramowane automatyzacje, które wznawiają rozmowy pozostawione bez odpowiedzi, z widocznymi licznikami tego, ile zostało wysłanych i ile zostało pominiętych.
Nie. Meta nie ma ogólnych szablonów na Instagramie, więc karuzeli tam nie ma dla nikogo. Na Messengerze jest, ale wymaga trzech warunków jednocześnie; gdy jednego brakuje, odpowiedź pozostaje tekstem. Wolimy powiedzieć to teraz, a nie w trzecim tygodniu wdrożenia.
Zmienia się pierwszy etap: zamiast łączyć adres, sprawdzamy, jaki publiczny interfejs ma Twoja platforma i czy odpowiada wystarczająco szybko do rozmowy. Jeśli nie ma żadnego, albo piszemy uwierzytelniony konektor — i wtedy omawiamy, kto zarządza kluczem — albo mówimy, że nie da się uczciwie zrobić żywego katalogu i zostajemy przy okresowo aktualizowanej bazie wiedzy, oznaczonej jako taka.
Fotografia jest oznaczana w rozmowie i zostaje tam dla osoby, która przejmuje. Nie jest automatycznie dołączana do zamówienia i nie generuje się z niej żaden dokument — nie ma na to kodu. Agent, który twierdziłby, że zarejestrował zamówienie ze zdjęcia, kłamałby, a to wychodzi przy dostawie.
Dostaje jedną odpowiedź na wszystko, co napisał. Wiadomości zbierają się w buforze 15 sekund przed wysłaniem do modelu. Osobno, jeśli platforma Meta wyśle tę samą wiadomość ponownie — a robi to — deduplikacja po identyfikatorze wiadomości, z pamięcią 120 sekund, zapobiega drugiej odpowiedzi.
Osoba z Twojego zespołu, a przekazanie widać w systemie: wątek przechodzi ze stanu `bot` do `human`, dziennik przejęcia zapisuje, kto i kiedy, a stan dotrzymania czasu odpowiedzi pokazuje, czy wątek został zawieszony. Bez tego mechanizmu „przekaż do operatora” to obietnica, której nikt nie może zweryfikować miesiące później.
Opowiedz nam o swoim procesie. Wspólnie ustalimy, co warto zbudować, co da się połączyć i jak sprawdzimy wynik.