Vodič za integraciju sa WooCommerce platformom

Ovaj vodič povezuje WooCommerce prodavnicu sa Tajom. Integracija ima dve polovine koje rade zajedno:

• Plugin Tajo for WooCommerce: hvata događaje angažovanja u realnom vremenu (porudžbine, korpe, povraćaji sredstava, recenzije, poslati formulari) unutar WordPress-a i isporučuje ih Tajou kroz trajan, potpisan outbox red.
• WooCommerce REST veza: Tajo čita kupce, porudžbine, proizvode, kupone, povraćaje sredstava i recenzije iz vaše prodavnice radi istorijskog uvoza i stalne sinhronizacije. Za podešavanje samo preko REST-a pogledajte referencu za WooCommerce konektor.

Sama marketinška automatizacija (imejl, SMS, WhatsApp preko Brevo platforme i drugih provajdera) podešava se u platformi Tajo, ne u pluginu. Posao plugina je da iz WordPress-a izvuče događaje kojima se može verovati.

Preduslovi

• WordPress 6.3+ sa administratorskim pristupom
• PHP 7.4+
• WooCommerce 7.0+ (plugin radi i na WordPress sajtovima bez WooCommerce platforme, pri čemu adapteri za prodaju jednostavno ostaju neaktivni)
• Tajo nalog sa kreiranom WordPress vezom
• HTTPS na Tajo krajnjoj tački (uvek je tako kod hostovanog Taja)

Korak 1: Instalirajte plugin Tajo for WooCommerce

Ručna instalacija

# 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

Zatim ga aktivirajte iz WordPress administracije:

1. Idite na Plugins → Installed Plugins
2. Pronađite „Tajo for WooCommerce”
3. Kliknite na Activate

Zip možete otpremiti i direktno preko Plugins → Add New → Upload Plugin. Uz svako izdanje objavljuje se SHA-256 kontrolni zbir na adresi tajo.io/downloads/woocommerce/. Plugin još nije naveden u WordPress.org direktorijumu, pa je ručna instalacija danas podržani put.

Korak 2: Podesite vezu

Idite na WooCommerce → Tajo (na sajtovima bez WooCommerce platforme: Settings → Tajo) i unesite tri vrednosti iz svoje Tajo WordPress veze:

Nema API ključeva koje treba dodavati kao konstante u wp-config.php. Događaji bezbedno čekaju u lokalnom outbox redu dok sve tri vrednosti ne budu sačuvane.

Zatim proverite ceo put od kraja do kraja:

1. Kliknite na Queue test event, pa na Process now.
2. Tabela outbox reda za isporuku treba da prikaže događaj kao isporučen.
3. U platformi Tajo potvrdite da je događaj connection.test stigao na WordPress vezu.

Šta plugin šalje

Svaki događaj je kompaktna koverta sa minimumom ličnih podataka, potpisana pomoću HMAC-SHA256. WordPress napuštaju samo polja identiteta za angažovanje (imejl, telefon, lokalni ID-jevi) i ograničeni metapodaci o događaju, nikada imena, poštanske adrese, IP adrese, korisnički agenti, tekstovi komentara, proizvoljna polja formulara, napomene uz porudžbinu ili podaci o plaćanju.

WooCommerce događaji

Događaji o porudžbinama nose broj porudžbine, status, valutu, iznose, stavke i gotove adrese za recenziju i ponovnu porudžbinu, dovoljno za automatizacije posle kupovine i za vraćanje kupaca bez dodatnog API poziva.

WordPress događaji

• contact.created / contact.updated / contact.deleted za korisničke naloge
• content.published / content.updated / content.unpublished za javni sadržaj
• comment.created / comment.status_changed za komentare posetilaca i recenzije proizvoda (interne WooCommerce napomene uz porudžbinu, pingback-ovi i trackback-ovi se nikada ne šalju)
• form.submitted za uspešno poslate formulare Contact Form 7, WPForms, Gravity Forms i Fluent Forms, pri čemu se izdvajaju samo tipizovana polja identiteta sa imejlom i telefonom i metapodaci formulara; proizvoljno poslata polja se odbacuju

Pouzdanost: outbox red za isporuku

Plugin nikada ne šalje događaje Tajou direktno iz učitavanja stranice. Svaki događaj se prvo upisuje u lokalnu outbox tabelu, a zatim ga isporučuje WP-Cron uz:

• Ograničeno eksponencijalno odlaganje (do 8 pokušaja, uz poštovanje zaglavlja Retry-After)
• Neisporučene poruke sa opcijom Replay dead letters na jedan klik u administraciji
• Ograničenja čuvanja, tako da nedostupna krajnja tačka nikada ne može da gomila lične podatke (isporučeno: 7 dana; u redu: 30 dana; neisporučeno: 30 dana od poslednje izmene)
• Idempotentne ID-jeve događaja, pa ponovni pokušaji i ponovna slanja nikada ne prave duplikate nizvodno

Ako vaš host onemogući WP-Cron (DISABLE_WP_CRON), pozivajte wp-cron.php iz pravog rasporeda poslova bar jednom u minutu.

Saglasnost se nikada ne pretpostavlja

Kreiranje naloga, naplata, kupovina i slanje običnih formulara ne smatraju se marketinškom saglasnošću. Ugrađeni događaji nose praznu listu saglasnosti. Da biste zabeležili izričitu saglasnost (na primer iz čekiranog polja za newsletter), pošaljite je kroz hook za proširenje:

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' )
);

Isti hook omogućava bilo kom pluginu ili temi da šalje sopstvene događaje; sve prolazi kroz isti mehanizam za čišćenje, isti outbox red i isti potpis.

Korak 3: Istorijski uvoz

Događaji u realnom vremenu pokrivaju sve od instalacije nadalje. Za istoriju koja prethodi pluginu, Tajo WooCommerce REST veza uvozi postojeće kupce, porudžbine, proizvode, kupone, povraćaje sredstava i recenzije, a podešava se u potpunosti na strani Taja pomoću WooCommerce REST API ključa (WooCommerce → Settings → Advanced → REST API, dozvola za čitanje). Detalje pogledajte u referenci za WooCommerce konektor.

Privatnost i GDPR

• Plugin se registruje u WordPress alatima Tools → Export Personal Data i Tools → Erase Personal Data; sačuvani događaji u outbox redu za odgovarajuću imejl adresu izvoze se ili brišu lokalno.
• Brisanje i isporuka dele isti mehanizam zaključavanja koji se zatvara u slučaju greške, pa brisanje nikada ne može da prijavi uspeh dok je paket u toku slanja.
• Lokalno brisanje pokriva samo WordPress outbox red, pa za podatke nizvodno pošaljite odgovarajući zahtev u platformi Tajo.
• Deaktivacija pauzira isporuku, ali čuva konfiguraciju i događaje u redu; brisanje plugina trajno uklanja outbox red, podešavanja, tajni ključ i rasporede poslova.

Kompatibilnost

• HPOS: plugin prijavljuje kompatibilnost sa WooCommerce High-Performance Order Storage i koristi isključivo CRUD objekte i javne hook-ove.
• WooCommerce Subscriptions: promene statusa pretplate se hvataju kada je ekstenzija aktivna.
• Multisite: deinstalacija čisti svaki sajt u mreži.

Referenca za rad sa sistemom

Otkrivanje mogućnosti sa servera na server i upravljanje outbox redom dostupni su administratorima uz autentifikaciju preko Application Password:

Rešavanje problema

Sledeći koraci

• Referenca za WooCommerce konektor: REST sinhronizacija, detalji o potpisu webhook-a, ključevi konfiguracije
• Sinhronizacija kupaca: mapiranje WooCommerce kupaca u vaš sistem evidencije
• Podesite automatizacije za napuštene korpe, poruke posle kupovine i vraćanje kupaca u platformi Tajo pomoću događaja cart.updated, order.placed i order.fulfilled