Moduł DomaAI dla PrestaShop

Wstawia w sklepie widżet czatu z agentem SI i sam przesyła produkty do bazy Twojej firmy w DomaAI. Instalacja zajmuje kilka minut.

PobierzWersja 1.0.0, plik zip, 46 KB, bezpłatna dla firm z planem DomaAI

Co robi moduł

  • Wstawia na każdej stronie sklepu przycisk czatu z asystentem SI Twojej firmy. Asystent odpowiada klientom o produkty, ceny i dostępność na podstawie Twojej bazy.
  • Przesyła do bazy firmy w DomaAI aktywne produkty: nazwę, opis, cechy, dostępność, warianty, cenę brutto, link, główne zdjęcie, kategorie i producenta.
  • Po każdej zmianie produktu w sklepie aktualizuje go w DomaAI, a raz na noc robi pełną synchronizację.

Instalacja w 4 krokach

  1. Pobierz plik domaai-prestashop.zip z tej strony. W panelu PrestaShop otwórz Moduły, Menedżer modułów, Załaduj moduł i wskaż pobrany plik.
  2. W panelu firmy DomaAI otwórz zakładkę Integracje, utwórz klucz API i skopiuj go. Pełny klucz widać tylko raz.
  3. W konfiguracji modułu wklej klucz i kliknij Sprawdź połączenie. Moduł pokaże nazwę firmy, plan i limit pozycji, a klucz widżetu pobierze sam.
  4. Wybierz język i walutę źródłową, opcjonalnie kategorie, i kliknij Synchronizuj teraz. Widżet pojawi się w sklepie, gdy przełącznik „Pokaż widżet w sklepie” jest włączony.

W panelu firmy DomaAI dopisz domenę sklepu do listy domen widżetu (zakładka Widżet). Na innych domenach widżet się nie wyświetli.

Ustawienia modułu

Podsumowanie

Na górze ekranu widać firmę, plan, liczbę pozycji w bazie wiedzy na tle limitu planu i stan widżetu. Pod spodem jest wynik ostatniej synchronizacji: dodane, zaktualizowane, wyłączone, pominięte przez limit planu i błędy.

Połączenie z DomaAI

Pole Klucz API oraz przyciski Sprawdź połączenie, Zapisz i Odłącz. Zapisany klucz nie jest pokazywany w całości. Pozostaw pole puste, żeby go zachować, albo wklej nowy.

Widżet czatu

Przełącznik Pokaż widżet w sklepie. Skrypt ładuje się asynchronicznie przed końcem strony i nie spowalnia sklepu. W panelu administracyjnym widżet się nie pokazuje.

Synchronizacja produktów

  • Język źródłowy: w tym języku pobierane są nazwy i opisy produktów.
  • Waluta źródłowa: w tej walucie liczone są ceny brutto. DomaAI przechowuje ceny w złotych; przy innej walucie cena trafia do opisu pozycji.
  • Kategorie do synchronizacji: nic nie zaznaczaj, żeby przesłać cały katalog.
  • Synchronizuj teraz: ręczna pełna synchronizacja z wynikiem na ekranie.

Ustawienia zaawansowane

Adres API, domyślnie https://domaai.pl/api. Zmieniaj go tylko na prośbę wsparcia DomaAI.

Jak działa synchronizacja

  • Przesyłane są produkty aktywne i widoczne, z wybranych kategorii albo z całego katalogu.
  • Limit planu: Start 15 pozycji, Firma 100, Pro 300. Gdy produktów jest więcej, najpierw idą najlepiej sprzedające się, potem najnowsze. Pozycje dodane ręcznie w panelu DomaAI też zajmują limit i moduł bierze je pod uwagę.
  • Treść pozycji: krótki opis i opis bez HTML (do 4000 znaków), najważniejsze cechy, dostępność i warianty w skrócie.
  • Zmiany na bieżąco: po zapisaniu, dodaniu albo usunięciu produktu zmiana jest wysyłana od razu po zapisie, bez spowalniania panelu. Błędy trafiają tylko do logów PrestaShop.
  • Sprzątanie: produkty wyłączone, ukryte, usunięte albo spoza wybranych kategorii znikają z bazy DomaAI.

Nocna synchronizacja (cron)

Adres crona z tajnym tokenem jest widoczny w konfiguracji modułu. Ustaw go na serwerze raz na noc. Nocny przebieg łapie zmiany, które nie przechodzą przez zapis produktu, na przykład stany magazynowe po zamówieniach i promocje.

0 3 * * * curl -fsS "https://twoj-sklep.pl/module/domaai/cron?token=TOKEN" > /dev/null

Opcjonalnie co 15 minut możesz wysyłać tylko zaległe zmiany z kolejki, na przykład po chwilowym braku sieci:

*/15 * * * * curl -fsS "https://twoj-sklep.pl/module/domaai/cron?token=TOKEN&tryb=kolejka" > /dev/null

Bez poprawnego tokenu adres zwraca błąd 403.

Jakie dane wysyła wtyczka

Wtyczka łączy się z usługą DomaAI (domaai.pl), którą świadczy MADD Marcin Kisieliński, ul. Kajki 10-12, 10-547 Olsztyn, NIP 7422297084.

  • Co jest wysyłane: wyłącznie treści katalogu: nazwy i opisy produktów z cechami, dostępnością i wariantami, ceny brutto, walutę, adresy stron produktów i zdjęć, kategorie i producenta oraz identyfikatory produktów.
  • Kiedy: przy sprawdzaniu połączenia, przy synchronizacji z panelu albo z crona oraz po zapisaniu, dodaniu lub usunięciu produktu.
  • Czego nie wysyła: danych klientów, zamówień, koszyków ani kont użytkowników i pracowników.
  • Widżet: gdy jest włączony, przeglądarki odwiedzających ładują skrypt widżetu z domaai.pl, a rozmowa toczy się w ramce z domaai.pl. Dla danych osób piszących w widżecie administratorem jest Twoja firma, a MADD Marcin Kisieliński jest podmiotem przetwarzającym na podstawie umowy powierzenia (Załącznik nr 1). W polityce prywatności swojej strony możesz podlinkować informację dla osób piszących w widżecie.

Agent SI w widżecie zna tylko bazę, którą przygotujesz w panelu firmy. Nie ma dostępu do zamówień, danych klientów, faktur, poczty ani panelu sklepu.

Rozwiązywanie problemów

Widżet się nie pokazuje

Sprawdź, czy przełącznik „Pokaż widżet w sklepie” jest włączony i czy po kliknięciu „Sprawdź połączenie” kafelek „Widżet w sklepie” pokazuje „widoczny”. Dopisz domenę sklepu do listy domen widżetu w panelu firmy. Jeśli używasz modułu łączącego albo opóźniającego skrypty, wyklucz z niego domaai.pl/api/firmy/widzet.js.

Część produktów pominięto przez limit

Plan ma limit pozycji w bazie. Moduł wysyła najpierw bestsellery, potem najnowsze. Zmień plan w panelu firmy albo zawęź kategorie.

„DomaAI odrzuciło klucz API”

Klucz został unieważniony, na przykład po utworzeniu nowego. Utwórz nowy klucz w zakładce Integracje i wklej go w module.

Czy klucz API jest bezpieczny?

Klucz jest zapisany w konfiguracji sklepu i nigdy nie trafia do kodu strony ani do logów. Moduł łączy się wyłącznie przez HTTPS.

Mam kilka sklepów (multistore)

Ustawienia są osobne dla każdego sklepu, więc każdy może mieć własny klucz API i własną firmę w DomaAI. Cron uruchamiaj dla adresu każdego sklepu.

Odinstalowanie

Moduł usuwa swoje ustawienia i tabelę pomocniczą. Produkty wysłane wcześniej zostają w bazie DomaAI; możesz je usunąć w panelu firmy.

Licencja i zasady

Kod wtyczki jest udostępniony na licencji MIT. Copyright (c) 2026 MADD Marcin Kisieliński. Licencja nie obejmuje prawa do używania oznaczeń DomaAI i MADD ani grafik orbów poza korzystaniem z usługi DomaAI, a zmodyfikowanej wersji nie wolno rozpowszechniać pod nazwą DomaAI.