WooCommerce konnektor

WooCommerce konnektor

Csatlakoztasd a WooCommerce áruházadat a Brevóhoz a Tajón keresztül a teljes e-kereskedelmi adatszinkronizációhoz. Használd a WooCommerce REST API-t az ügyfelek, rendelések, termékek és kupon-adatok szinkronizálásához célzott marketingkampányokhoz és automatizált munkafolyamatokhoz.

Áttekintés

Funkciók

• Ügyfél-szinkronizáció – Valós idejű ügyféladat-szinkronizáció a Brevo kapcsolatokba
• Rendeléskövetés – Teljes rendelési életciklus eseménykövetése vásárlás utáni folyamatokhoz
• Termékkatalógus-szinkronizáció – Termékek és variációk szinkronizálása e-mailes ajánlásokhoz
• Kuponkezelés – Kuponkódok szinkronizálása promóciós kampányokhoz
• Webhook támogatás – Valós idejű frissítések WooCommerce webhookokon keresztül
• Kosárelhagyás – Elhagyott kosarak követése és visszaszerzése
• Multisite támogatás – WordPress multisite WooCommerce telepítések csatlakoztatása
• Egyedi meta mezők – WooCommerce egyedi meta-adatok leképezése Brevo attribútumokra

Előfeltételek

Mielőtt elkezdenéd, győződj meg róla, hogy rendelkezel:

1. Egy WordPress oldallal, amelyre telepítve és aktiválva van a WooCommerce plugin
2. Engedélyezett WooCommerce REST API-val (Beállítások > Haladó > REST API)
3. Generált API Consumer Key-jel és Consumer Secret-tel
4. Az oldaladnak HTTPS-t kell használnia az API-hitelesítéshez
5. Egy Brevo fiókkal API-hozzáféréssel
6. Egy Tajo fiókkal API hitelesítő adatokkal

Hitelesítés

REST API kulcsok

A WooCommerce Consumer Key és Consumer Secret párokat használ a hitelesítéshez. Generáld le ezeket a WooCommerce > Beállítások > Haladó > REST API menüben.

OAuth 1.0a (HTTPS oldalak)

curl https://yourstore.com/wp-json/wc/v3/orders \
  -u "consumer_key:consumer_secret"

Query string hitelesítés (HTTPS)

curl "https://yourstore.com/wp-json/wc/v3/orders?consumer_key=ck_xxx&consumer_secret=cs_xxx"

Jogosultsági szintek

Konfiguráció

Alapbeállítás

connectors:
  woocommerce:
    enabled: true
    store_url: "https://yourstore.com"
    consumer_key: "ck_your_consumer_key"
    consumer_secret: "cs_your_consumer_secret"
    api_version: "wc/v3"
    verify_ssl: true

    # Data sync options
    sync:
      customers: true
      orders: true
      products: true
      coupons: true

    # Brevo list assignment
    lists:
      all_customers: 50
      buyers: 51
      abandoned_cart: 52

Ügyfél-mezőleképezés

Képezd le a WooCommerce ügyfélmezőket a Brevo attribútumokhoz:

customer_mapping:
  email: email
  first_name: FIRSTNAME
  last_name: LASTNAME
  billing.phone: SMS
  billing.company: COMPANY
  billing.city: CITY
  billing.state: STATE
  billing.country: COUNTRY
  billing.postcode: ZIP

  # E-commerce metrics (computed)
  orders_count: ORDER_COUNT
  total_spent: TOTAL_SPENT
  date_created: SIGNUP_DATE

  # Meta fields
  meta_data.loyalty_points: LOYALTY_POINTS
  meta_data.preferred_category: PREF_CATEGORY

Webhook-konfiguráció

Regisztráld a webhookokat a WooCommerce > Beállítások > Haladó > Webhookok menüben:

webhooks:
  - topic: "customer.created"
    event: "customer_created"
  - topic: "customer.updated"
    event: "customer_updated"
  - topic: "order.created"
    event: "order_placed"
  - topic: "order.updated"
    event: "order_updated"
  - topic: "order.completed"
    event: "order_fulfilled"
  - topic: "order.refunded"
    event: "order_refunded"
  - topic: "coupon.created"
    event: "coupon_created"
  - topic: "product.created"
    event: "product_added"
  - topic: "product.updated"
    event: "product_updated"

API végpontok

Kódpéldák

WooCommerce konnektor inicializálása

import { TajoClient } from '@tajo/sdk';

const tajo = new TajoClient({
  apiKey: process.env.TAJO_API_KEY,
  brevoApiKey: process.env.BREVO_API_KEY
});

// Connect WooCommerce store
await tajo.connectors.connect('woocommerce', {
  storeUrl: 'https://yourstore.com',
  consumerKey: process.env.WC_CONSUMER_KEY,
  consumerSecret: process.env.WC_CONSUMER_SECRET
});

Ügyfelek lekérése és szinkronizálása

// Fetch customers using WooCommerce REST API
const WooCommerce = require('@woocommerce/woocommerce-rest-api').default;

const api = new WooCommerce({
  url: 'https://yourstore.com',
  consumerKey: process.env.WC_CONSUMER_KEY,
  consumerSecret: process.env.WC_CONSUMER_SECRET,
  version: 'wc/v3'
});

// List customers with pagination
const response = await api.get('customers', {
  per_page: 100,
  page: 1,
  orderby: 'registered_date',
  order: 'desc'
});

const customers = response.data;
// [{ id, email, first_name, last_name, billing, shipping, ... }]

// Pagination info from headers
const totalPages = response.headers['x-wp-totalpages'];
const totalItems = response.headers['x-wp-total'];

Webhook események kezelése

// WooCommerce webhook handler
app.post('/webhooks/woocommerce', async (req, res) => {
  const topic = req.headers['x-wc-webhook-topic'];
  const signature = req.headers['x-wc-webhook-signature'];

  // Verify webhook signature
  const expectedSignature = crypto
    .createHmac('sha256', WEBHOOK_SECRET)
    .update(JSON.stringify(req.body))
    .digest('base64');

  if (signature !== expectedSignature) {
    return res.status(401).send('Invalid signature');
  }

  // Forward to Tajo
  await tajo.connectors.handleWebhook('woocommerce', {
    topic,
    payload: req.body
  });

  res.status(200).send('OK');
});

Kötegelt műveletek

// Batch create, update, and delete products
const batchResponse = await api.post('products/batch', {
  create: [
    { name: 'New Product', type: 'simple', regular_price: '19.99' }
  ],
  update: [
    { id: 123, regular_price: '24.99' }
  ],
  delete: [456]
});

Ráta-korlátok

A WooCommerce maga nem érvényesít API ráta-korlátokat, de a mögöttes WordPress szerver és a tárhelyszolgáltató szabhat korlátokat:

Hibaelhárítás

Legjobb gyakorlatok

1. Használj webhookokat a valós idejű szinkronizációhoz – Konfigurálj WooCommerce webhookokat az API lekérdezése helyett
2. Ellenőrizd a webhook-aláírásokat – Mindig validáld az X-WC-Webhook-Signature fejlécet
3. Lapozz minden lista-kérésnél – Használd a page és per_page paramétereket; ellenőrizd az X-WP-TotalPages fejlécet
4. Használd a _fields paramétert – Kérj csak szükséges mezőket a válaszméret csökkentéséhez és a teljesítmény javításához
5. Kötegelt műveletek – Használj kötegelt végpontokat tömeges létrehozáshoz/frissítéshez/törléshez (max. 100 tétel)
6. Nagy szinkronizációk ütemezése – Futtasd a kezdeti teljes szinkronizációkat csúcsidőn kívül a szerverterhelés elkerülése érdekében
7. Engedélyezd a HTTPS-t – A WooCommerce API HTTPS-t igényel az OAuth hitelesítéshez

Biztonság

• OAuth 1.0a – Biztonságos hitelesítés Consumer Key/Secret párokkal
• HMAC webhook-aláírások – SHA-256 aláírás-ellenőrzés a bejövő webhookokhoz
• HTTPS kötelező – Az API TLS titkosítást igényel a hitelesítéshez
• Jogosultság-hatókörök – Az API kulcsok beállíthatók Read, Write vagy Read/Write módra
• WordPress biztonság – A WordPress core biztonsági frissítéseinek előnyeit élvezi
• PCI megfontolások – A fizetési adatokat a WooCommerce fizetési átjárók kezelik, nem kerülnek ki az API-n keresztül

Kapcsolódó források

• Shopify konnektor
• BigCommerce konnektor
• Ügyfél-szinkronizáció Skill
• Elhagyott kosár Skill