---
title: "WooCommerce integrációs útmutató | Tajo"
description: "Kösd össze a WooCommerce áruházadat a Tajóval a Tajo for WooCommerce bővítménnyel: ügyfélkapcsolati események, megbízható kézbesítés és adatvédelmi szempontból minimalizált vásárlói adatok. Fejlesztés alatt áll, végponttól végpontig még nincs ellenőrizve."
url: https://tajo.io/hu/docs/ecommerce-platforms/woocommerce/
markdown: https://tajo.io/hu/docs/ecommerce-platforms/woocommerce.md
lang: hu-HU
author: "Set Noa"
author_url: https://tajo.io/hu/set-noa/
robots: noindex
---

Kérj korai hozzáférést

Adja meg keresztnevét és munkahelyi e-mail-címét. Küldünk egy hivatkozást, amellyel megerősítheti a Tajo-hozzáférési kérelmét.

# WooCommerce integrációs útmutató

[Set Noa](https://tajo.io/hu/set-noa/)

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**: ügyfélkapcsolati eseményeket (rendelések, kosarak, visszatérítések, értékelések, űrlapbeküldések) rögzít a WordPressen belül, amint megtörténnek, és tartós, aláírt kimenő soron keresztül juttatja el őket a Tajóhoz. 2026. október 14-én a bővítményt egy helyi oldalon tesztelték; a Tajóba történő kézbesítést még nem ellenőrizték.
- **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](https://tajo.io/hu/docs/connectors/ecommerce/woocommerce/).

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

```bash
# 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/](https://tajo.io/downloads/woocommerce/tajo-woocommerce-1.0.0.zip.sha256). 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:

| Mező | Érték |
| --- | --- |
| **Tajo végpont** | A Tajóban megjelenő HTTPS webhook URL, például `https://alto.tajo.io/api/connectors/wordpress/webhooks/engagement` |
| **Binding ID** | A kapcsolat binding ID-ja a Tajóból |
| **Aláírási titok** | A megosztott titok (32–256 karakter). A bővítmény aktiváláskor erős helyi titkot generál; illeszd be a Tajóba, vagy másold ide a Tajo titká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

| Hook | Esemény |
| --- | --- |
| `woocommerce_created_customer` / `woocommerce_update_customer` | `customer.created` / `customer.updated` |
| `woocommerce_new_product` / `woocommerce_update_product` | `product.created` / `product.updated` |
| `woocommerce_add_to_cart`, tétel eltávolítása, kupon alkalmazása/eltávolítása | `cart.updated` (kosárösszegzéssel az elhagyott kosaras folyamatokhoz) |
| `woocommerce_cart_emptied` | `cart.emptied` |
| `woocommerce_new_order` / `woocommerce_update_order` | `order.placed` / `order.updated` |
| `woocommerce_order_status_changed` | `order.status_changed` (+ `order.fulfilled` teljesítéskor) |
| `woocommerce_payment_complete` | `order.paid` |
| `woocommerce_order_refunded` | `refund.created` |
| WooCommerce Subscriptions állapotfrissítések | `subscription.status_changed` |

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:

```php
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 bővítmény eseményei 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](https://tajo.io/hu/docs/connectors/ecommerce/woocommerce/).

## 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:

| Metódus | Útvonal | Cél |
| --- | --- | --- |
| `GET` | `/wp-json/tajo/v1/capabilities` | Bővítményverzió, észlelt adapterek, eseményleltár, a kimenő sor állapota |
| `GET` | `/wp-json/tajo/v1/outbox` | A kimenő sor darabszámai (az adatcsomagok soha nem jelennek meg) |
| `POST` | `/wp-json/tajo/v1/outbox/process` | Egy köteg azonnali feldolgozása |
| `POST` | `/wp-json/tajo/v1/outbox/replay` | Holt levelek újrajátszása |

## Hibaelhárítás

| Tünet | Ok és megoldás |
| --- | --- |
| Az események „Queued” állapotban maradnak | A végpont, a binding ID vagy a titok még nincs elmentve, a kézbesítés szünetel, amíg mind a három be nincs állítva |
| Az események „Retrying” állapotban maradnak | A Tajo végpont nem érhető el a tárhelyedről, vagy nem fut a WP-Cron, nézd meg a kimenő sor táblájának hibaoszlopát és a cron beállításodat |
| Halmozódnak a holt levelek | Nem újrapróbálható hiba (általában hibás binding ID vagy titok), javítsd a beállítást, majd használd a **Replay dead letters** funkciót |
| „Enter a valid HTTPS Tajo webhook endpoint” | A végpontnak HTTPS-nek kell lennie, beágyazott hitelesítő adatok nélkül |
| A teszteseményt kézbesítette, de a Tajóban nincs semmi | Ellenőrizd, hogy a binding ID-t ugyanabból a Tajo munkaterületről és kapcsolatból másoltad be, amelyhez a végpont tartozik |

## Következő lépések

- [WooCommerce konnektor referencia](https://tajo.io/hu/docs/connectors/ecommerce/woocommerce/): REST szinkronizálás, a webhook aláírásának részletei, konfigurációs kulcsok
- [Vásárlószinkronizálás](https://tajo.io/hu/docs/skills/data-sync/customer-sync/): 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