---
title: "Shopify konnektor"
description: "Teljes Shopify integrációs útmutató az ügyfelek, rendelések, termékek és kosáresemények Brevóval való szinkronizációjához."
url: https://tajo.io/hu/docs/connectors/ecommerce/shopify/
markdown: https://tajo.io/hu/docs/connectors/ecommerce/shopify.md
lang: hu-HU
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.

# Shopify konnektor

Konnektor állapota: Fejlesztés alatt Készül. Még nincs ellenőrizve.

| Forrásmező | Célmező | Mintaérték |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Csatlakoztasd a Shopify áruházadat a Brevóhoz a teljes ügyféladat-szinkronizációhoz, elhagyott kosár visszaszerzéséhez és automatizált marketingkampányokhoz.

## Áttekintés

| Tulajdonság | Érték |
| --- | --- |
| **Platform** | Shopify |
| **Kategória** | E-kereskedelem |
| **Telepítés bonyolultsága** | Könnyű |
| **Hivatalos integráció** | Nem |
| **Szinkronizált adatok** | Ügyfelek, rendelések, termékek, kosarak, események |
| **Elérhető Skillek** | 12 |

## Funkciók

- **Valós idejű ügyfél-szinkronizáció** – Az ügyféladatok azonnal szinkronizálódnak a Brevo kapcsolatokba
- **Rendeléskövetés** – Rendelési események vásárlás utáni folyamatokhoz
- **Termékkatalógus-szinkronizáció** – Termékek ajánlásokhoz elérhetők
- **Kosárelhagyás** – Elhagyott kosarak követése és visszaszerzése
- **Böngészési viselkedés** – Oldalnézet- és termékérdeklődés-követés
- **Több áruház támogatása** – Több Shopify áruház csatlakoztatása

## Előfeltételek

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

1. Egy Shopify áruházzal adminisztrátori hozzáféréssel
2. Egy Brevo fiókkal API-hozzáféréssel
3. Egy Tajo fiókkal

## Telepítés

### 1. lehetőség: Shopify App Store (ajánlott)

1. Látogass el a [Tajo alkalmazásra a Shopify App Store-ban](https://apps.shopify.com/tajo)
2. Kattints az „Add app” gombra
3. Add meg a kért jogosultságokat
4. Csatlakoztasd a Brevo fiókodat

### 2. lehetőség: Kézi telepítés

#### 1. lépés: Shopify alkalmazás létrehozása

1. Menj a Shopify admin → Beállítások → Alkalmazások és értékesítési csatornák menüpontra
2. Kattints a „Develop apps” → „Create an app” gombra
3. Nevezd el „Tajo Integration”-nek

#### 2. lépés: API hatókörök konfigurálása

Engedélyezd ezeket a hatóköröket:

```
read_customers
write_customers
read_orders
read_products
read_checkouts
write_script_tags
```

#### 3. lépés: Az alkalmazás telepítése

```bash
# Using Tajo CLI
tajo connectors install shopify \
  --shop-url your-store.myshopify.com \
  --api-key $SHOPIFY_API_KEY \
  --api-secret $SHOPIFY_API_SECRET
```

#### 4. lépés: Webhookok konfigurálása

A Tajo automatikusan regisztrálja ezeket a webhookokat:

| Webhook | Cél |
| --- | --- |
| `customers/create` | Új ügyfél szinkronizációja |
| `customers/update` | Ügyféladat-változások |
| `customers/delete` | Ügyfél eltávolítása |
| `orders/create` | Rendelés leadva események |
| `orders/updated` | Rendelési állapot változásai |
| `checkouts/create` | Kosár létrehozva |
| `checkouts/update` | Kosár frissítve |

## Konfiguráció

### Alapbeállítás

```yaml
connectors:
  shopify:
    enabled: true
    shop_url: "your-store.myshopify.com"
    api_version: "2024-01"

    # Data sync options
    sync:
      customers: true
      orders: true
      products: true
      carts: true
      inventory: false  # Optional

    # List assignment
    lists:
      all_customers: 5
      buyers: 6
      abandoned_cart: 7
```

### Mezőleképezés

Képezd le a Shopify mezőket a Brevo kapcsolat-attribútumokhoz:

#### Alapértelmezett leképezések

| Parameter | Type | Description |
| --- | --- | --- |
| `email` required | string | Ügyfél e-mail (egyedi azonosító) |
| `first_name` optional | string | Leképezve a FIRSTNAME attribútumra |
| `last_name` optional | string | Leképezve a LASTNAME attribútumra |
| `phone` optional | string | Leképezve az SMS attribútumra WhatsApphoz/SMS-hez |
| `accepts_marketing` optional | boolean | Vezérli a feliratkozási státuszt |
| `orders_count` optional | integer | Rendelések teljes száma |
| `total_spent` optional | number | Ügyfél élettartam-értéke |
| `tags` optional | array | Ügyfélcímkék a Shopify-ból |

#### Egyedi attribútum-leképezés

```yaml
field_mapping:
  # Standard fields
  email: email
  first_name: FIRSTNAME
  last_name: LASTNAME
  phone: SMS

  # E-commerce metrics
  orders_count: ORDER_COUNT
  total_spent: TOTAL_SPENT
  last_order_date: LAST_ORDER_DATE

  # Custom fields
  customer_type: CUSTOMER_TYPE
  preferred_language: LANGUAGE
  loyalty_tier: VIP_TIER

  # Computed fields
  average_order_value: AOV
  days_since_last_order: RECENCY
```

### Termékszinkronizáció

Szinkronizáld a termékeket az e-mailes ajánlásokhoz:

```yaml
sync:
  products:
    enabled: true
    include_variants: true
    include_images: true
    categories_as_tags: true

    # Filter products
    filter:
      status: active
      exclude_tags: ["hidden", "wholesale-only"]
```

### Készletkövetés

Engedélyezd a készletszint-szinkronizációt:

```yaml
sync:
  inventory:
    enabled: true
    low_stock_threshold: 10
    out_of_stock_events: true
```

## Események

### Ügyfélesemények

| Esemény | Trigger | Használati eset |
| --- | --- | --- |
| `customer_created` | Új ügyfél regisztráció | Üdvözlő sorozat |
| `customer_updated` | Profilváltozások | Adatszinkronizáció |
| `customer_tags_added` | Címkék hozzárendelve | Szegmens-frissítések |

### Rendelési események

| Esemény | Trigger | Használati eset |
| --- | --- | --- |
| `order_placed` | Fizetés befejezve | Rendelési visszaigazolás |
| `order_fulfilled` | Rendelés kiszállítva | Szállítási értesítés |
| `order_cancelled` | Rendelés lemondva | Lemondási e-mail |
| `order_refunded` | Visszatérítés feldolgozva | Visszatérítési visszaigazolás |

### Kosáresemények

| Esemény | Trigger | Használati eset |
| --- | --- | --- |
| `cart_created` | Tételek hozzáadva a kosárhoz | Böngészéskövetés |
| `cart_updated` | Kosár módosítva | Kosárérték-követés |
| `cart_abandoned` | Nincs fizetés 30 percig | Visszaszerzési e-mailek |

## Engedélyezett Skillek

A Shopify konnektor ezeket a Skilleket engedélyezi:

| Skill | Leírás |
| --- | --- |
| [Ügyfél-szinkronizáció](https://tajo.io/hu/docs/skills/data-sync/customer-sync) | Valós idejű ügyfél-szinkronizáció |
| Rendelési események | Rendelési életciklus-követés |
| [Elhagyott kosár](https://tajo.io/hu/docs/skills/email-marketing/abandoned-cart) | Kosár-visszaszerzési e-mailek |
| Üdvözlő sorozat | Új ügyfelek onboardingja |
| Vásárlás utáni | Rendelés utáni követés |
| Visszahódító | Inaktív ügyfelek visszaszerzése |
| Böngészés-elhagyás | Termékérdeklődés-követés |
| Utánrendelés | Újrarendelési emlékeztetők |

## Kódpéldák

### A konnektor inicializálása

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

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

// Connect Shopify store
await tajo.connectors.connect('shopify', {
  shopUrl: 'your-store.myshopify.com',
  apiKey: process.env.SHOPIFY_API_KEY,
  apiSecret: process.env.SHOPIFY_API_SECRET
});
```

### Kezdeti szinkronizáció futtatása

```javascript
// Full historical sync
await tajo.connectors.sync('shopify', {
  type: 'full',
  resources: ['customers', 'orders', 'products'],
  since: '2023-01-01'
});

// Check sync status
const status = await tajo.connectors.status('shopify');
console.log(status);
// {
//   connected: true,
//   lastSync: '2024-01-15T10:30:00Z',
//   customersCount: 15420,
//   ordersCount: 8234,
//   productsCount: 342
// }
```

### Kosáresemények követése

Add hozzá a Tajo scriptet a Shopify témádhoz:

```liquid
<!-- Add to theme.liquid before </head> -->
{% if customer %}
<script>
  window.tajoConfig = {
    customerId: "{{ customer.id }}",
    customerEmail: "{{ customer.email }}",
    customerName: "{{ customer.first_name }}"
  };
</script>
{% endif %}
<script src="https://cdn.example.com/shopify.js"></script>
```

Caution

A fenti `example.com` cím csak helyőrző, amíg a Tajo végpont elérhetővé nem válik.

### Egyedi webhook-kezelő

```javascript
// Handle Shopify webhooks manually
app.post('/webhooks/shopify', async (req, res) => {
  const hmac = req.get('X-Shopify-Hmac-SHA256');

  // Verify webhook signature
  if (!verifyShopifyWebhook(req.body, hmac)) {
    return res.status(401).send('Unauthorized');
  }

  const topic = req.get('X-Shopify-Topic');

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

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

## Monitorozás

### Dashboard mérőszámok

Kövesd a Shopify kapcsolatodat a Tajo dashboardon:

- **Szinkronizációs állapot**: Valós idejű kapcsolat állapota
- **Szinkronizált ügyfelek**: Összes kapcsolat a Shopify-ból
- **Követett rendelések**: Feldolgozott rendelési események
- **Kosár-visszaszerzés**: Elhagyott kosár teljesítménye
- **Hibaarány**: Sikertelen szinkronizációs kísérletek

### Webhook naplók

Tekintsd meg a webhook-kézbesítési állapotot:

```bash
tajo connectors logs shopify --type webhook --last 24h
```

### Szinkronizációs előzmények

Ellenőrizd a korábbi szinkronizációs műveleteket:

```bash
tajo connectors history shopify --limit 10
```

## Hibaelhárítás

### Gyakori problémák

API ráta-korlátok

A Shopify API ráta-korlátja 2 kérés/másodperc. Nagy történeti importokhoz használj kötegelt szinkronizációt.

| Probléma | Ok | Megoldás |
| --- | --- | --- |
| Nem érkezik webhook | Alkalmazás-jogosultságok | Telepítsd újra az alkalmazást megfelelő hatókörökkel |
| Ügyfél nem szinkronizált | Hiányzó e-mail | A Shopify e-mailt igényel az ügyfelekhez |
| Termékek hiányoznak | Termékstátusz | Ellenőrizd, hogy a termék „active” státuszú |
| Kosár nincs követve | Script nincs betöltve | Ellenőrizd a scriptet a theme.liquid fájlban |

### Hibakeresési mód

Engedélyezd a részletes naplózást:

```yaml
connectors:
  shopify:
    debug: true
    log_level: verbose
    log_webhooks: true
```

### Kapcsolat tesztelése

```bash
tajo connectors test shopify
# ✓ API connection successful
# ✓ Webhooks registered
# ✓ Products accessible
# ✓ Customers readable
# ✓ Orders readable
```

## Legjobb gyakorlatok

1. **Kezdd tesztáruházzal** – Először használj fejlesztői áruházat
2. **Futtasd a kezdeti szinkronizációt munkaidőn kívül** – A nagy szinkronizációk lassúak lehetnek
3. **Képezz le egyedi attribútumokat** – Ne támaszkodj csak az alapértelmezett leképezésekre
4. **Engedélyezd a kosárkövetést** – Kritikus az elhagyott kosár visszaszerzéséhez
5. **Figyeld a webhookok állapotát** – Állíts be riasztásokat a sikertelen kézbesítésekhez
6. **Használj kötegelt importokat** – 10 000 rekord feletti történeti adatokhoz

## Biztonság

- **OAuth 2.0** – Biztonságos token alapú hitelesítés
- **Webhook-ellenőrzés** – HMAC aláírás-validáció
- **Titkosított tárolás** – Az API hitelesítő adatok nyugalmi állapotban titkosítva
- **Hatókör-alapú hozzáférés** – Csak a minimálisan szükséges jogosultságok

## Kapcsolódó források

- [WooCommerce konnektor](https://tajo.io/hu/docs/connectors/ecommerce/woocommerce)
- [Ügyfél-szinkronizáció Skill](https://tajo.io/hu/docs/skills/data-sync/customer-sync)
- [Elhagyott kosár Skill](https://tajo.io/hu/docs/skills/email-marketing/abandoned-cart)
- [Brevo Contacts API](https://tajo.io/hu/docs/contact-management)