Wtyczka DomaAI dla WordPressa i WooCommerce

Wstawia na stronie widżet czatu z agentem SI i przesyła do bazy firmy produkty WooCommerce, wpisy, wydarzenia i wybrane strony.

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

Co robi wtyczka

  • Wstawia w stopce każdej strony przycisk czatu z asystentem SI Twojej firmy.
  • Przesyła do bazy firmy w DomaAI produkty WooCommerce, najnowsze wpisy bloga jako aktualności, nadchodzące wydarzenia z The Events Calendar i wybrane strony z informacjami, na przykład kontakt, dostawę czy zwroty.
  • Działa także bez WooCommerce, na przykład na stronie twórcy, restauracji albo organizatora wydarzeń.

Instalacja w 4 krokach

  1. Pobierz plik domaai-wordpress.zip z tej strony. W panelu WordPressa otwórz Wtyczki, Dodaj nową, Wyślij wtyczkę na serwer, wskaż plik, zainstaluj i włącz.
  2. W panelu firmy DomaAI otwórz zakładkę Integracje, utwórz klucz API i skopiuj go. Pełny klucz widać tylko raz.
  3. Otwórz Ustawienia, DomaAI, wklej klucz i zapisz. Wtyczka od razu sprawdzi połączenie i sama pobierze klucz widżetu.
  4. Zaznacz, co synchronizować, zapisz zmiany i kliknij Synchronizuj teraz.

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

Ustawienia wtyczki

Firma w DomaAI

Nazwa firmy, plan, liczba pozycji w bazie na tle limitu planu, stan widżetu i przycisk Sprawdź połączenie.

Synchronizacja

Przycisk Synchronizuj teraz z paskiem postępu i wynikiem: wysłane, dodane, zaktualizowane, wyłączone i usunięte pozycje. Gdy coś nie zmieści się w limicie planu, zobaczysz ostrzeżenie z liczbą pominiętych pozycji.

Połączenie

Pole Klucz API i opcja Usuń zapisany klucz (rozłącz).

Widżet czatu

Przełącznik Pokazuj przycisk czatu DomaAI na każdej stronie serwisu. Skrypt ładuje się asynchronicznie w stopce i nie spowalnia strony.

Co synchronizować

  • Produkty WooCommerce: opublikowane produkty, opcjonalnie tylko z wybranych kategorii (z podkategoriami).
  • Wpisy bloga jako aktualności: najnowsze wpisy, domyślnie 20, opcjonalnie z wybranych kategorii.
  • Wydarzenia: nadchodzące wydarzenia z The Events Calendar z datą, godziną i miejscem.
  • Strony jako informacje: zaznacz strony, o które pytają klienci, na przykład kontakt, dostawa, zwroty i godziny otwarcia.

Kolejność przy limicie planu

Plan ma limit pozycji w bazie: Start 15, Firma 100, Pro 300. Pozycje dodane ręcznie w panelu DomaAI też go zajmują. Gdy treści jest więcej, wtyczka wysyła je w tej kolejności:

  1. produkty WooCommerce od najlepiej sprzedających się,
  2. zaznaczone strony z informacjami,
  3. nadchodzące wydarzenia, od najbliższych,
  4. najnowsze wpisy bloga.

Przykład: plan Start ma 15 pozycji, w panelu masz 2 pozycje FAQ, a sklep ma 440 produktów. Wtyczka wyśle 13 najlepiej sprzedających się produktów, a strony i wpisy się nie zmieszczą.

Synchronizacja automatyczna

  • Po zmianie: zapis, publikacja, przeniesienie do kosza albo usunięcie treści trafia do kolejki, a wtyczka wysyła ją w tle po około 30 sekundach. Zapis w panelu nigdy nie czeka na DomaAI.
  • Codziennie: pełna synchronizacja raz na dobę przez WP-Cron.
  • Przy chwilowym błędzie: brak sieci albo przeciążenie powoduje ponowienie później, bez utraty zmian.

WP-Cron uruchamia się przy odwiedzinach strony. Na stronach z bardzo małym ruchem warto ustawić systemowy cron, który co kilka minut otwiera wp-cron.php.

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 wybrane do synchronizacji: tytuły, opisy z atrybutami, stanem magazynu i wariantami, ceny brutto, walutę, adresy stron i obrazów, kategorie i tagi, daty i miejsca wydarzeń oraz identyfikatory treści.
  • Kiedy: przy sprawdzaniu połączenia, po kliknięciu „Synchronizuj teraz”, w tle po zapisaniu albo usunięciu synchronizowanej treści i raz na dobę.
  • 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 WordPressa.

Rozwiązywanie problemów

Widżet się nie pokazuje

Sprawdź, czy przełącznik widżetu jest włączony, a połączenie sprawdzone. Dopisz domenę strony do listy domen widżetu w panelu firmy. Jeśli używasz wtyczki do pamięci podręcznej albo łączenia skryptów, wyczyść jej pamięć i wyklucz domaai.pl/api/firmy/widzet.js.

Część treści pominięto przez limit

Zobacz kolejność przy limicie planu. Zmień plan w panelu firmy albo zawęź kategorie i liczbę wpisów.

„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 ustawieniach wtyczki.

Zmiany nie trafiają do DomaAI

Synchronizacja w tle korzysta z WP-Cron albo z Action Scheduler (jeśli jest WooCommerce). Sprawdź, czy WP-Cron nie jest wyłączony stałą DISABLE_WP_CRON bez systemowego crona. W razie potrzeby kliknij „Synchronizuj teraz”.

Odinstalowanie

Wtyczka usuwa swoje ustawienia i zaplanowane zadania. Treści 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 GNU GPL w wersji 2 lub późniejszej. 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.