WooCommerce integrációs útmutató

Ez az útmutató egy WooCommerce áruházat köt össze a Tajóval. Az integráció két, egymással együttműködő félből áll:

• Tajo for WooCommerce bővítmény: valós idejű ügyfélkapcsolati eseményeket (rendelések, kosarak, visszatérítések, értékelések, űrlapbeküldések) rögzít a WordPressen belül, és tartós, aláírt kimenő soron keresztül juttatja el őket a Tajóhoz.
• WooCommerce REST kapcsolat: a Tajo beolvassa az áruházad vásárlóit, rendeléseit, termékeit, kuponjait, visszatérítéseit és értékeléseit a történeti importhoz és a folyamatos szinkronizáláshoz. A csak REST alapú beállításhoz lásd a WooCommerce konnektor referenciát.

Magát a marketingautomatizálást (e-mail, SMS, WhatsApp a Brevón és más szolgáltatókon keresztül) a Tajóban állítod be, nem a bővítményben. A bővítmény dolga az, hogy megbízható eseményeket juttasson ki a WordPressből.

Előfeltételek

• WordPress 6.3+ admin hozzáféréssel
• PHP 7.4+
• WooCommerce 7.0+ (a bővítmény WooCommerce nélküli WordPress-oldalakon is működik, ilyenkor a kereskedelmi adapterek egyszerűen inaktívak maradnak)
• Tajo fiók létrehozott WordPress kapcsolattal
• HTTPS a Tajo végponton (a felhőben futó Tajónál ez mindig teljesül)

1. lépés: telepítsd a Tajo for WooCommerce bővítményt

Kézi telepítés

# 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

Ezután aktiváld a WordPress adminban:

1. Nyisd meg a Plugins → Installed Plugins oldalt
2. Keresd meg a „Tajo for WooCommerce” bővítményt
3. Kattints az Activate gombra

A zipet közvetlenül is feltöltheted a Plugins → Add New → Upload Plugin menüponton keresztül. Minden kiadás mellett SHA-256 ellenőrzőösszeg is megjelenik itt: tajo.io/downloads/woocommerce/. A bővítmény még nem szerepel a WordPress.org katalógusában; ma a kézi telepítés a támogatott út.

2. lépés: állítsd be a kapcsolatot

Nyisd meg a WooCommerce → Tajo oldalt (WooCommerce nélküli oldalakon: Settings → Tajo), és add meg a Tajo WordPress kapcsolatod három értékét:

A wp-config.php fájlba nem kell API-kulcs konstansokat felvenned. Az események biztonságosan a helyi kimenő sorban várakoznak, amíg mind a három érték el nincs mentve.

Ezután ellenőrizd a teljes csővezetéket:

1. Kattints a Queue test event, majd a Process now gombra.
2. A kézbesítési kimenő sor táblájában az eseménynek kézbesítettként kell megjelennie.
3. A Tajóban ellenőrizd, hogy a connection.test esemény megérkezett a WordPress kapcsolatra.

Mit küld a bővítmény

Minden esemény tömör, adatvédelmi szempontból minimalizált, HMAC-SHA256 aláírással ellátott boríték. A WordPressből csak az ügyfélkapcsolati azonosító mezők (e-mail, telefonszám, helyi azonosítók) és a korlátozott eseménymetaadatok lépnek ki, nevek, postai címek, IP-címek, user agentek, hozzászólásszövegek, tetszőleges űrlapmezők, rendelési jegyzetek vagy fizetési adatok soha.

WooCommerce események

A rendelési események tartalmazzák a rendelés számát, státuszát, pénznemét, végösszegeit, tételsorait és a készen használható értékelési, illetve újrarendelési URL-eket, ami elég a vásárlás utáni és a visszaszerző automatizálásokhoz további API-hívás nélkül.

WordPress események

• contact.created / contact.updated / contact.deleted a felhasználói fiókokhoz
• content.published / content.updated / content.unpublished a nyilvános tartalmakhoz
• comment.created / comment.status_changed a látogatói hozzászólásokhoz és a termékértékelésekhez (a belső WooCommerce rendelési jegyzetek, a pingbackek és a trackbackek soha nem kerülnek ki)
• form.submitted a sikeres Contact Form 7, WPForms, Gravity Forms és Fluent Forms beküldésekhez; a rendszer csak a típusos e-mail- és telefonazonosító mezőket és az űrlap metaadatait emeli ki, a tetszőleges beküldött mezőket eldobja

Megbízhatóság: a kézbesítési kimenő sor

A bővítmény soha nem küld eseményt közvetlenül a Tajóhoz oldalbetöltés közben. Minden esemény először egy helyi kimenő sor táblába kerül, majd a WP-Cron kézbesíti a következőkkel:

• Korlátozott exponenciális visszalépés (legfeljebb 8 próbálkozás, a Retry-After fejlécet tiszteletben tartva)
• Holt levelek egykattintásos Replay dead letters funkcióval az adminban
• Megőrzési korlátok, hogy egy elérhetetlen végpont soha ne halmozhasson fel személyes adatokat (kézbesítve: 7 nap; sorban: 30 nap; holt levelek: 30 nap az utolsó frissítés után)
• Idempotens eseményazonosítók, így az újrapróbálkozások és az újrajátszások soha nem duplikálnak a fogadó oldalon

Ha a tárhelyed letiltja a WP-Cront (DISABLE_WP_CRON), hívd meg a wp-cron.php fájlt valódi ütemezőből legalább percenként egyszer.

A hozzájárulást soha nem következtetjük ki

A fiókregisztráció, a pénztár, a vásárlás és az általános űrlapbeküldés nem minősül marketinghozzájárulásnak. A beépített események üres hozzájárulási listát hordoznak. Kifejezett hozzájárulás rögzítéséhez (például egy bejelölt hírlevél-jelölőnégyzetből) használd a bővítmény hookját:

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

Ugyanez a hook bármely bővítménynek vagy sablonnak lehetővé teszi egyedi események kibocsátását; minden ugyanazon a tisztítón, kimenő soron és aláíráson megy keresztül.

3. lépés: történeti import

A valós idejű események a telepítéstől kezdve mindent lefednek. A bővítményt megelőző előzményekhez a Tajo WooCommerce REST kapcsolata importálja a meglévő vásárlókat, rendeléseket, termékeket, kuponokat, visszatérítéseket és értékeléseket, teljes egészében a Tajo oldalán beállítva, egy WooCommerce REST API-kulccsal (WooCommerce → Settings → Advanced → REST API, olvasási jog). A részletekért lásd a WooCommerce konnektor referenciát.

Adatvédelem és GDPR

• A bővítmény regisztrálja magát a WordPress Tools → Export Personal Data és Tools → Erase Personal Data eszközeinél; az egyező e-mail-címhez megőrzött kimenő sor eseményeit helyben exportálja vagy törli.
• A törlés és a kézbesítés közös, hibára záró mutexen osztozik, így a törlés soha nem jelenthet befejezést, miközben egy adatcsomag épp úton van.
• A helyi törlés csak a WordPress kimenő sorára terjed ki, a fogadó oldali adatokhoz add be a megfelelő kérést a Tajóban.
• A deaktiválás szünetelteti a kézbesítést, de megőrzi a beállításokat és a sorban álló eseményeket; a bővítmény törlése véglegesen eltávolítja a kimenő sort, a beállításokat, a titkot és az ütemezéseket.

Kompatibilitás

• HPOS: a bővítmény deklarálja a WooCommerce High-Performance Order Storage kompatibilitást, és kizárólag CRUD objektumokat és nyilvános hookokat használ.
• WooCommerce Subscriptions: az előfizetési állapotváltozásokat a rendszer rögzíti, ha a bővítmény aktív.
• Multisite: az eltávolítás a hálózat minden oldalán takarít.

Üzemeltetési referencia

A szerverek közötti felderítés és a kimenő sor vezérlése az adminisztrátorok számára Application Password hitelesítéssel érhető el:

Hibaelhárítás

Következő lépések

• WooCommerce konnektor referencia: REST szinkronizálás, a webhook aláírásának részletei, konfigurációs kulcsok
• Vásárlószinkronizálás: a WooCommerce vásárlóinak leképezése a rendszernyilvántartásodba
• Állíts be elhagyott kosaras, vásárlás utáni és visszaszerző automatizálásokat a Tajóban a cart.updated, az order.placed és az order.fulfilled események alapján