---
title: "Konektor Shopify"
description: "Kompletní průvodce integrací Shopify pro synchronizaci zákazníků, objednávek, produktů a událostí košíku s Brevo."
url: https://tajo.io/cz/docs/connectors/ecommerce/shopify/
markdown: https://tajo.io/cz/docs/connectors/ecommerce/shopify.md
lang: cs-CZ
robots: noindex
---

Požádejte o přednostní přístup

Zadejte své jméno a pracovní e-mailovou adresu. Pošleme vám odkaz pro potvrzení žádosti o přístup k Tajo.

# Konektor Shopify

Stav konektoru: Ve vývoji Vzniká. Zatím neověřeno.

| Zdrojové pole | Cílové pole | Ukázková hodnota |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Propoj svůj Shopify obchod s Brevo pro kompletní synchronizaci zákaznických dat, obnovu opuštěných košíků a automatizované marketingové kampaně.

## Přehled

| Vlastnost | Hodnota |
| --- | --- |
| **Platforma** | Shopify |
| **Kategorie** | E-commerce |
| **Složitost nastavení** | Snadná |
| **Oficiální integrace** | Ne |
| **Synchronizovaná data** | Zákazníci, Objednávky, Produkty, Košíky, Události |
| **Dostupné skilly** | 12 |

## Funkce

- **Real-time synchronizace zákazníků** - Data zákazníků se okamžitě synchronizují s kontakty Brevo
- **Sledování objednávek** - Události objednávek pro post-purchase flow
- **Synchronizace katalogu produktů** - Produkty dostupné pro doporučení
- **Opuštěné košíky** - Sleduj a obnovuj opuštěné košíky
- **Chování při prohlížení** - Sledování zhlédnutých stránek a zájmu o produkty
- **Podpora více obchodů** - Propoj více Shopify obchodů

## Předpoklady

Než začneš, ujisti se, že máš:

1. Shopify obchod s administrátorským přístupem
2. Brevo účet s API přístupem
3. Tajo účet

## Instalace

### Možnost 1: Shopify App Store (doporučeno)

1. Navštiv [Tajo aplikaci v Shopify App Store](https://apps.shopify.com/tajo)
2. Klikni na “Přidat aplikaci”
3. Udělej souhlas s požadovanými oprávněními
4. Propoj svůj Brevo účet

### Možnost 2: Manuální instalace

#### Krok 1: Vytvoř Shopify aplikaci

1. Jdi do Shopify adminu → Settings → Apps and sales channels
2. Klikni na “Develop apps” → “Create an app”
3. Pojmenuj ji “Tajo Integration”

#### Krok 2: Nakonfiguruj API rozsahy

Povol tyto rozsahy:

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

#### Krok 3: Nainstaluj aplikaci

```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 registruje tyto webhooky:

| Webhook | Účel |
| --- | --- |
| `customers/create` | Synchronizace nového zákazníka |
| `customers/update` | Změny zákaznických dat |
| `customers/delete` | Smazání zákazníka |
| `orders/create` | Události vytvořené objednávky |
| `orders/updated` | Změny statusu objednávky |
| `checkouts/create` | Vytvoření košíku |
| `checkouts/update` | Aktualizace košíku |

## Konfigurace

### Základní nastavení

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

### Mapování polí

Namapuj Shopify pole na atributy kontaktů Brevo:

#### Výchozí mapování

| Parameter | Type | Description |
| --- | --- | --- |
| `email` required | string | Email zákazníka (unikátní identifikátor) |
| `first_name` optional | string | Mapuje se na atribut FIRSTNAME |
| `last_name` optional | string | Mapuje se na atribut LASTNAME |
| `phone` optional | string | Mapuje se na atribut SMS pro WhatsApp/SMS |
| `accepts_marketing` optional | boolean | Řídí status předplatného |
| `orders_count` optional | integer | Celkový počet objednávek |
| `total_spent` optional | number | Celoživotní hodnota zákazníka |
| `tags` optional | array | Tagy zákazníka ze Shopify |

#### Mapování vlastních atributů

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

### Synchronizace produktů

Synchronizuj produkty pro doporučení v emailech:

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

### Sledování inventáře

Zapni synchronizaci stavu skladu:

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

## Události

### Události zákazníků

| Událost | Spouštěč | Použití |
| --- | --- | --- |
| `customer_created` | Registrace nového zákazníka | Welcome série |
| `customer_updated` | Změny v profilu | Synchronizace dat |
| `customer_tags_added` | Přiřazení tagů | Aktualizace segmentů |

### Události objednávek

| Událost | Spouštěč | Použití |
| --- | --- | --- |
| `order_placed` | Dokončený checkout | Potvrzení objednávky |
| `order_fulfilled` | Odeslání objednávky | Notifikace o odeslání |
| `order_cancelled` | Zrušení objednávky | Email o zrušení |
| `order_refunded` | Zpracování vrácení | Potvrzení vrácení |

### Události košíku

| Událost | Spouštěč | Použití |
| --- | --- | --- |
| `cart_created` | Přidání položek do košíku | Sledování procházení |
| `cart_updated` | Úprava košíku | Sledování hodnoty košíku |
| `cart_abandoned` | Bez checkoutu do 30 min | Emaily pro obnovu |

## Zapnuté skilly

Konektor Shopify zapíná tyto skilly:

| Skill | Popis |
| --- | --- |
| [Customer Sync](https://tajo.io/cz/docs/skills/data-sync/customer-sync) | Real-time synchronizace zákazníků |
| Order Events | Sledování životního cyklu objednávky |
| [Abandoned Cart](https://tajo.io/cz/docs/skills/email-marketing/abandoned-cart) | Emaily pro obnovu košíku |
| Welcome Series | Onboarding nových zákazníků |
| Post-Purchase | Následné emaily po objednávce |
| Win-Back | Znovuzískání neaktivních zákazníků |
| Browse Abandonment | Následný kontakt po zájmu o produkt |
| Replenishment | Připomínky opakovaných objednávek |

## Příklady kódu

### Inicializace konektoru

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

### Spuštění úvodní synchronizace

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

### Sledování událostí košíku

Přidej Tajo skript do svého Shopify tématu:

```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` výše je jen zástupná hodnota, dokud 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 dashboardu

Sleduj své Shopify připojení v dashboardu Tajo:

- **Status synchronizace**: Zdraví připojení v reálném čase
- **Synchronizovaní zákazníci**: Celkový počet kontaktů ze Shopify
- **Sledované objednávky**: Zpracované události objednávek
- **Obnova košíku**: Výkonnost opuštěných košíků
- **Míra chyb**: Neúspěšné pokusy o synchronizaci

### Logy webhooků

Zobraz status doručení webhooků:

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

### Historie synchronizace

Zkontroluj historické synchronizační operace:

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

## Řešení problémů

### Časté problémy

API Rate Limits

Shopify má API rate limity 2 requesty/sekundu. Pro rozsáhlé historické importy použij batch sync.

| Problém | Příčina | Řešení |
| --- | --- | --- |
| Webhook nepřichází | Oprávnění aplikace | Znovu nainstaluj aplikaci se správnými rozsahy |
| Zákazník nesynchronizován | Chybí email | Shopify vyžaduje email pro zákazníky |
| Chybí produkty | Status produktu | Zkontroluj, že produkt má status “active” |
| Košík se nesleduje | Skript nenahrán | Ověř skript v theme.liquid |

### Debug režim

Zapni detailní logování:

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

### Test připojení

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

## Best practices

1. **Začni s testovacím obchodem** - Nejprve použij development obchod
2. **Úvodní synchronizaci spusť mimo špičku** - Velké synchronizace mohou být pomalé
3. **Namapuj vlastní atributy** - Nespoléhej jen na výchozí mapování
4. **Zapni sledování košíku** - Klíčové pro obnovu opuštěných košíků
5. **Sleduj zdraví webhooků** - Nastav si alerty pro neúspěšná doručení
6. **Používej batch importy** - Pro historická data přes 10 000 záznamů

## Bezpečnost

- **OAuth 2.0** - Bezpečná autentizace založená na tokenech
- **Ověření webhooků** - Validace HMAC podpisu
- **Šifrované úložiště** - API přihlašovací údaje šifrovány v klidu
- **Omezený přístup** - Pouze minimum požadovaných oprávnění

## Související zdroje

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