Przewodnik po integracji z WooCommerce

Ten przewodnik łączy sklep WooCommerce z Tajo. Integracja składa się z dwóch części, które działają razem:

• Wtyczka Tajo for WooCommerce: przechwytuje zdarzenia zaangażowania w czasie rzeczywistym (zamówienia, koszyki, zwroty, opinie, zgłoszenia formularzy) wewnątrz WordPressa i dostarcza je do Tajo przez trwałą, podpisaną skrzynkę nadawczą.
• Połączenie REST z WooCommerce: Tajo odczytuje klientów, zamówienia, produkty, kupony, zwroty i opinie z Twojego sklepu na potrzeby importu historycznego i bieżącej synchronizacji. Konfigurację opartą wyłącznie na REST opisuje dokumentacja konektora WooCommerce.

Samą automatyzację marketingu (email, SMS, WhatsApp przez Brevo i innych dostawców) konfigurujesz w Tajo, a nie we wtyczce. Zadaniem wtyczki jest wyprowadzenie wiarygodnych zdarzeń z WordPressa.

Wymagania wstępne

• WordPress 6.3+ z dostępem administratora
• PHP 7.4+
• WooCommerce 7.0+ (wtyczka działa też na witrynach WordPress bez WooCommerce; adaptery sklepowe pozostają wtedy po prostu nieaktywne)
• Konto Tajo z utworzonym połączeniem WordPress
• HTTPS na endpoincie Tajo (zawsze spełnione w Tajo hostowanym przez nas)

Krok 1: zainstaluj wtyczkę Tajo for WooCommerce

Instalacja ręczna

# Download the plugin
cd wp-content/plugins
wget https://tajo.io/downloads/woocommerce/tajo-woocommerce-latest.zip

# Verify and unzip
unzip tajo-woocommerce-latest.zip

Następnie aktywuj wtyczkę w panelu WordPressa:

1. Przejdź do Plugins → Installed Plugins
2. Znajdź „Tajo for WooCommerce”
3. Kliknij Activate

Możesz też wgrać plik zip bezpośrednio przez Plugins → Add New → Upload Plugin. Suma kontrolna SHA-256 jest publikowana razem z każdym wydaniem pod adresem tajo.io/downloads/woocommerce/. Wtyczka nie jest jeszcze wpisana do katalogu WordPress.org; instalacja ręczna to dziś jedyna wspierana droga.

Krok 2: skonfiguruj połączenie

Przejdź do WooCommerce → Tajo (na witrynach bez WooCommerce: Settings → Tajo) i wpisz trzy wartości ze swojego połączenia WordPress w Tajo:

Nie ma żadnych stałych z kluczem API, które trzeba dodawać do wp-config.php. Zdarzenia czekają bezpiecznie w lokalnej skrzynce nadawczej, dopóki wszystkie trzy wartości nie zostaną zapisane.

Następnie sprawdź całą ścieżkę od początku do końca:

1. Kliknij Queue test event, a potem Process now.
2. Tabela skrzynki nadawczej powinna pokazać zdarzenie jako dostarczone.
3. W Tajo potwierdź, że zdarzenie connection.test dotarło na połączenie WordPress.

Co wysyła wtyczka

Każde zdarzenie to zwięzła koperta ograniczona do minimum danych osobowych i podpisana algorytmem HMAC-SHA256. WordPressa opuszczają wyłącznie pola tożsamości potrzebne do zaangażowania (email, telefon, lokalne identyfikatory) oraz ograniczone metadane zdarzenia, nigdy imiona i nazwiska, adresy pocztowe, adresy IP, user agenty, treści komentarzy, dowolne pola formularzy, notatki do zamówień ani dane płatności.

Zdarzenia WooCommerce

Zdarzenia zamówień niosą numer zamówienia, status, walutę, kwoty, pozycje oraz gotowe adresy do opinii i ponownego zamówienia, czyli dość, aby zbudować automatyzacje pozakupowe i win-back bez dodatkowego zapytania do API.

Zdarzenia WordPress

• contact.created / contact.updated / contact.deleted dla kont użytkowników
• content.published / content.updated / content.unpublished dla treści publicznych
• comment.created / comment.status_changed dla komentarzy odwiedzających i opinii o produktach (wewnętrzne notatki do zamówień WooCommerce, pingbacki i trackbacki nigdy nie są wysyłane)
• form.submitted dla udanych zgłoszeń z Contact Form 7, WPForms, Gravity Forms i Fluent Forms: pobierane są wyłącznie typowane pola tożsamości email i telefon oraz metadane formularza; dowolne przesłane pola są odrzucane

Niezawodność: skrzynka nadawcza

Wtyczka nigdy nie wysyła zdarzeń do Tajo bezpośrednio przy wczytywaniu strony. Każde zdarzenie trafia najpierw do lokalnej tabeli skrzynki nadawczej, a potem dostarcza je WP-Cron z następującymi zabezpieczeniami:

• Ograniczony wykładniczy backoff (do 8 prób, z poszanowaniem Retry-After)
• Dead letters z przyciskiem Replay dead letters w panelu
• Limity przechowywania, dzięki którym nieosiągalny endpoint nigdy nie gromadzi danych osobowych (dostarczone: 7 dni; w kolejce: 30 dni; dead letters: 30 dni od ostatniej aktualizacji)
• Idempotentne identyfikatory zdarzeń, więc ponowne próby i powtórki nigdy nie duplikują danych w dalszych systemach

Jeśli Twój hosting wyłącza WP-Cron (DISABLE_WP_CRON), wywołuj wp-cron.php z prawdziwego harmonogramu co najmniej raz na minutę.

Zgoda nigdy nie jest wnioskowana

Założenie konta, checkout, zakup i zwykłe zgłoszenia formularzy nie są traktowane jako zgoda marketingowa. Wbudowane zdarzenia niosą pustą listę zgód. Aby zapisać wyraźną zgodę (na przykład z zaznaczonego pola zapisu do newslettera), wyślij ją przez hook rozszerzenia:

do_action(
    'tajo_engagement_emit',
    'consent.updated',
    array( 'email' => $email ),
    array( 'policyVersion' => '2026-07' ),
    array(
        array(
            'channel'  => 'email',
            'status'   => 'opt_in',        // or 'opt_out'
            'purpose'  => 'marketing',
            'source'   => 'newsletter_checkbox',
            'evidence' => array( 'formId' => 'newsletter-footer', 'field' => 'marketing_email' ),
        ),
    ),
    gmdate( 'c' )
);

Ten sam hook pozwala dowolnej wtyczce lub motywowi wysyłać własne zdarzenia; wszystko przechodzi przez ten sam sanitizer, tę samą skrzynkę nadawczą i ten sam podpis.

Krok 3: import historyczny

Zdarzenia w czasie rzeczywistym obejmują wszystko od momentu instalacji. Historię sprzed wtyczki importuje połączenie REST z WooCommerce po stronie Tajo: istniejących klientów, zamówienia, produkty, kupony, zwroty i opinie, konfigurowane w całości w Tajo przy użyciu klucza REST API WooCommerce (WooCommerce → Settings → Advanced → REST API, uprawnienie odczytu). Szczegóły znajdziesz w dokumentacji konektora WooCommerce.

Prywatność i RODO

• Wtyczka rejestruje się w WordPressie w Tools → Export Personal Data oraz Tools → Erase Personal Data; zachowane zdarzenia skrzynki nadawczej dla pasującego adresu email są lokalnie eksportowane lub usuwane.
• Usuwanie danych i dostarczanie zdarzeń dzielą muteks działający w trybie fail-closed, więc usunięcie nigdy nie zgłosi zakończenia, gdy ładunek jest w trakcie wysyłki.
• Lokalne usunięcie obejmuje wyłącznie skrzynkę nadawczą WordPressa: dla danych w dalszych systemach złóż odpowiednie żądanie w Tajo.
• Dezaktywacja wstrzymuje dostarczanie, ale zachowuje konfigurację i zdarzenia w kolejce; usunięcie wtyczki trwale kasuje skrzynkę nadawczą, ustawienia, sekret i harmonogramy.

Zgodność

• HPOS: wtyczka deklaruje zgodność z WooCommerce High-Performance Order Storage i korzysta wyłącznie z obiektów CRUD oraz publicznych hooków.
• WooCommerce Subscriptions: zmiany statusu subskrypcji są przechwytywane, gdy rozszerzenie jest aktywne.
• Multisite: odinstalowanie sprząta każdą witrynę w sieci.

Dokumentacja operacyjna

Wykrywanie po stronie serwera i sterowanie skrzynką nadawczą są dostępne dla administratorów przez uwierzytelnianie Application Password:

Rozwiązywanie problemów

Kolejne kroki

• Dokumentacja konektora WooCommerce: synchronizacja REST, szczegóły podpisu webhooka, klucze konfiguracji
• Synchronizacja klientów: mapowanie klientów WooCommerce do Twojego systemu źródła prawdy
• Skonfiguruj w Tajo automatyzacje porzuconych koszyków, pozakupowe i win-back w oparciu o zdarzenia cart.updated, order.placed i order.fulfilled