---
title: "Shopify konektor"
description: "Kompletný sprievodca integráciou Shopify na synchronizáciu zákazníkov, objednávok, produktov a udalostí košíka s Brevo."
url: https://tajo.io/sk/docs/connectors/ecommerce/shopify/
markdown: https://tajo.io/sk/docs/connectors/ecommerce/shopify.md
lang: sk-SK
robots: noindex
---

Požiadajte o skorý prístup

Zadajte svoje meno a pracovnú e-mailovú adresu. Pošleme vám odkaz na potvrdenie žiadosti o prístup k Tajo.

# Shopify konektor

Stav konektora: Vo vývoji Vzniká. Zatiaľ neoverené.

| Zdrojové pole | Cieľové pole | Ukážková hodnota |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Prepoj svoj Shopify obchod s Brevo pre kompletnú synchronizáciu zákazníckych dát, obnovu opustených košíkov a automatizované marketingové kampane.

## Prehľad

| Vlastnosť | Hodnota |
| --- | --- |
| **Platforma** | Shopify |
| **Kategória** | E-commerce |
| **Zložitosť nastavenia** | Ľahké |
| **Oficiálna integrácia** | Nie |
| **Synchronizované dáta** | Zákazníci, objednávky, produkty, košíky, udalosti |
| **Dostupné skilly** | 12 |

## Funkcie

- **Synchronizácia zákazníkov v reálnom čase** - Dáta zákazníkov synchronizované okamžite s kontaktmi v Brevo
- **Sledovanie objednávok** - Udalosti objednávok pre post-purchase flow
- **Synchronizácia produktového katalógu** - Produkty dostupné pre odporúčania
- **Opustenie košíka** - Sleduj a obnov opustené košíky
- **Správanie pri prezeraní** - Sledovanie zobrazení stránok a záujmu o produkty
- **Podpora viacerých obchodov** - Prepoj viacero Shopify obchodov

## Predpoklady

Predtým, než začneš, uisti sa, že máš:

1. Shopify obchod s admin prístupom
2. Brevo účet s API prístupom
3. Tajo účet

## Inštalácia

### Možnosť 1: Shopify App Store (odporúčané)

1. Navštív [Tajo aplikáciu v Shopify App Store](https://apps.shopify.com/tajo)
2. Klikni na “Add app”
3. Udeľ požadované oprávnenia
4. Prepoj svoj Brevo účet

### Možnosť 2: Manuálna inštalácia

#### Krok 1: Vytvor Shopify aplikáciu

1. Choď do Shopify adminu → Settings → Apps and sales channels
2. Klikni na “Develop apps” → “Create an app”
3. Pomenuj ju “Tajo Integration”

#### Krok 2: Nakonfiguruj API scopes

Zapni tieto scopes:

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

#### Krok 3: Nainštaluj aplikáciu

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

#### Krok 4: Nakonfiguruj webhooky

Tajo automaticky zaregistruje tieto webhooky:

| Webhook | Účel |
| --- | --- |
| `customers/create` | Synchronizácia nového zákazníka |
| `customers/update` | Zmeny zákazníckych dát |
| `customers/delete` | Odstránenie zákazníka |
| `orders/create` | Udalosti zadania objednávky |
| `orders/updated` | Zmeny stavu objednávky |
| `checkouts/create` | Vytvorený košík |
| `checkouts/update` | Aktualizovaný košík |

## Konfigurácia

### Základné nastavenie

```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
```

### Mapovanie polí

Namapuj polia Shopify na atribúty kontaktov v Brevo:

#### Predvolené mapovania

| Parameter | Type | Description |
| --- | --- | --- |
| `email` required | string | E-mail zákazníka (unikátny identifikátor) |
| `first_name` optional | string | Mapuje sa na atribút FIRSTNAME |
| `last_name` optional | string | Mapuje sa na atribút LASTNAME |
| `phone` optional | string | Mapuje sa na atribút SMS pre WhatsApp/SMS |
| `accepts_marketing` optional | boolean | Riadi stav odberu |
| `orders_count` optional | integer | Celkový počet objednávok |
| `total_spent` optional | number | Celoživotná hodnota zákazníka |
| `tags` optional | array | Zákaznícke tagy zo Shopify |

#### Mapovanie vlastných atribútov

```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
```

### Synchronizácia produktov

Synchronizuj produkty pre odporúčania v e-mailoch:

```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"]
```

### Sledovanie skladu

Zapni synchronizáciu úrovní skladu:

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

## Udalosti

### Udalosti zákazníkov

| Udalosť | Trigger | Prípad použitia |
| --- | --- | --- |
| `customer_created` | Registrácia nového zákazníka | Welcome séria |
| `customer_updated` | Zmeny profilu | Synchronizácia dát |
| `customer_tags_added` | Priradené tagy | Aktualizácie segmentov |

### Udalosti objednávok

| Udalosť | Trigger | Prípad použitia |
| --- | --- | --- |
| `order_placed` | Dokončené checkout | Potvrdenie objednávky |
| `order_fulfilled` | Objednávka odoslaná | Notifikácia o odoslaní |
| `order_cancelled` | Objednávka zrušená | E-mail o zrušení |
| `order_refunded` | Spracované vrátenie peňazí | Potvrdenie refundácie |

### Udalosti košíka

| Udalosť | Trigger | Prípad použitia |
| --- | --- | --- |
| `cart_created` | Položky pridané do košíka | Sledovanie prezerania |
| `cart_updated` | Košík upravený | Sledovanie hodnoty košíka |
| `cart_abandoned` | Žiadne checkout za 30 min | Recovery e-maily |

## Dostupné skilly

Shopify konektor umožňuje tieto skilly:

| Skill | Popis |
| --- | --- |
| [Customer Sync](https://tajo.io/sk/docs/skills/data-sync/customer-sync) | Synchronizácia zákazníkov v reálnom čase |
| Order Events | Sledovanie životného cyklu objednávky |
| [Abandoned Cart](https://tajo.io/sk/docs/skills/email-marketing/abandoned-cart) | E-maily na obnovu košíka |
| Welcome Series | Onboarding nových zákazníkov |
| Post-Purchase | Follow-up po objednávke |
| Win-Back | Reaktivácia neaktívnych zákazníkov |
| Browse Abandonment | Follow-up na záujem o produkty |
| Replenishment | Pripomienky na doobjednanie |

## Ukážky kódu

### Inicializácia konektora

```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
});
```

### Spustenie prvej synchronizácie

```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
// }
```

### Sledovanie udalostí košíka

Pridaj Tajo skript do svojej Shopify témy:

```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

Adresa `example.com` vyššie je len zástupná hodnota, kým nebude endpoint Tajo dostupný.

### Vlastný webhook handler

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

## Monitoring

### Metriky na dashboarde

Sleduj svoje Shopify pripojenie v Tajo dashboarde:

- **Stav synchronizácie**: Zdravie pripojenia v reálnom čase
- **Synchronizovaní zákazníci**: Celkový počet kontaktov zo Shopify
- **Sledované objednávky**: Spracované udalosti objednávok
- **Obnova košíkov**: Výkon obnovy opustených košíkov
- **Miera chýb**: Neúspešné pokusy o synchronizáciu

### Logy webhookov

Zobraz stav doručenia webhookov:

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

### História synchronizácií

Skontroluj historické synchronizačné operácie:

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

## Riešenie problémov

### Bežné problémy

API rate limity

Shopify má API rate limity 2 požiadavky/sekundu. Pre veľké historické importy použi dávkovú synchronizáciu.

| Problém | Príčina | Riešenie |
| --- | --- | --- |
| Webhook neprichádza | Oprávnenia aplikácie | Preinštaluj aplikáciu so správnymi scopes |
| Zákazník nie je synchronizovaný | Chýbajúci e-mail | Shopify vyžaduje e-mail pre zákazníkov |
| Produkty chýbajú | Stav produktu | Skontroluj, či má produkt stav “active” |
| Košík nie je sledovaný | Skript sa nenačítal | Overte skript v theme.liquid |

### Debug režim

Zapni verbose logovanie:

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

### Test pripojenia

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

## Odporúčané postupy

1. **Začni s testovacím obchodom** - Najprv použi vývojársky obchod
2. **Prvú synchronizáciu spusti mimo špičky** - Veľké synchronizácie môžu byť pomalé
3. **Mapuj vlastné atribúty** - Nespoliehaj sa len na predvolené mapovania
4. **Zapni sledovanie košíka** - Kritické pre obnovu opustených košíkov
5. **Sleduj zdravie webhookov** - Nastav upozornenia pre neúspešné doručenia
6. **Používaj dávkové importy** - Pre historické dáta nad 10 000 záznamov

## Bezpečnosť

- **OAuth 2.0** - Bezpečná autentifikácia založená na tokenoch
- **Overenie webhookov** - Validácia HMAC podpisu
- **Šifrované úložisko** - API credentials šifrované v pokoji
- **Scoped prístup** - Iba minimálne požadované oprávnenia

## Súvisiace zdroje

- [WooCommerce konektor](https://tajo.io/sk/docs/connectors/ecommerce/woocommerce)
- [Customer Sync skill](https://tajo.io/sk/docs/skills/data-sync/customer-sync)
- [Abandoned Cart skill](https://tajo.io/sk/docs/skills/email-marketing/abandoned-cart)
- [Brevo Contacts API](https://tajo.io/sk/docs/contact-management)