---
title: "Průvodce integrací Shopify | Tajo"
description: "Jak Tajo propojí obchod Shopify s Brevo: synchronizace webhooků v aplikaci pro Shopify, pravidla synchronizace, která sestaví agent a schválí člověk, a nástroje Shopify přes MCP."
url: https://tajo.io/cz/docs/ecommerce-platforms/shopify/
markdown: https://tajo.io/cz/docs/ecommerce-platforms/shopify.md
lang: cs-CZ
author: "Set Noa"
author_url: https://tajo.io/cz/set-noa/
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.

# Průvodce integrací Shopify

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

Tajo propojuje Shopify s Brevo na dvou místech. Aplikace Tajo pro Shopify mění webhooky Shopify na zápisy do Brevo hned, jak dorazí. Pravidla synchronizace, která sestaví agent a schválí člověk, přesouvají záznamy do Brevo podle plánu. Tato stránka popisuje obojí a pak nástroje Shopify, které Tajo poskytuje přes MCP.

## Předpoklady

Než začnete s integrací, ujistěte se, že máte:

- **Obchod na Shopify** v libovolném tarifu (Basic, Shopify, Advanced nebo Plus)
- **Účet Tajo** (Tajo je v předběžném přístupu)
- **Účet Brevo**, cíl synchronizace
- **Administrátorský přístup** k Vašemu obchodu na Shopify

## Krok 1: Připojte svůj obchod Shopify

Tajo je v předběžném přístupu. Aplikace pro Shopify není uvedena v obchodě Shopify App Store a neexistuje žádný odkaz pro samoobslužnou instalaci. [Kontaktujte tým](https://tajo.io/cz/contact), který Vám pomůže s nastavením. Jakmile bude Váš pracovní prostor Tajo připraven:

1. V Tajo otevřete **Connections**.
2. Zadejte doménu myshopify.com svého obchodu a zvolte **Connect Shopify**. Shopify zobrazí rozsahy oprávnění, která Tajo požaduje, a po jejich schválení Vás vrátí zpět do Tajo.
3. K čemu každý rozsah slouží a co Tajo zapisuje zpět do Shopify, zjistíte ve [Vysvětlení oprávnění Shopify](https://tajo.io/cz/resources/help/integrations/shopify-permissions-explained/).

## Krok 2: Co aplikace Tajo pro Shopify posílá do Brevo

Aplikace ověří každý webhook Shopify, uloží ho, zařadí do fronty a hned zpracuje. Témata zákazníků a produktů nejprve počkají asi čtyři sekundy. Neexistuje žádné dávkové okno. Neúspěšná úloha se opakuje s postupně prodlužovaným odstupem (backoff).

### Témata webhooků

Aplikace Tajo pro Shopify odebírá tato témata webhooků Shopify:

| Témata webhooků | Účel |
| --- | --- |
| `customers/create`, `customers/update`, `customers/delete` | Udržování aktuálních kontaktů v Brevo |
| `orders/create`, `orders/updated`, `orders/fulfilled`, `orders/cancelled` | Události objednávek a metriky objednávek pro Brevo |
| `orders/paid`, `refunds/create` | Připisování a odečítání věrnostních bodů |
| `checkouts/create`, `checkouts/update` | Obnova opuštěných pokladen (checkouts) v Brevo |
| `products/create`, `products/update`, `products/delete` | Udržování aktuálního katalogu produktů v Brevo |
| `inventory_levels/update` | Udržování aktuálních skladových zásob produktů v Brevo |
| `collections/create`, `collections/update`, `collections/delete` | Udržování aktuálních kolekcí |
| `companies/*`, `company_contacts/*`, `company_locations/*` (create, update, delete) | Synchronizace B2B společností |
| `app/uninstalled`, `app/scopes_update`, `app_subscriptions/update` | Životní cyklus aplikace |

Povinné webhooky Shopify k ochraně soukromí (žádost o data zákazníka, smazání zákazníka, smazání obchodu) jsou také obslouženy. Aplikace neodebírá `carts/*`. Opuštěné košíky pocházejí z témat `checkouts/*`.

Co se objeví v Brevo:

| Událost Shopify | V Brevo |
| --- | --- |
| Zákazník vytvořen nebo aktualizován | Kontakt se vytvoří nebo aktualizuje se jménem, e-mailem a marketingovým souhlasem. V placených tarifech aplikace přidá štítky, počet objednávek, utracenou částku a poslední objednávku. |
| Zákazník smazán | Kontakt se odhlásí, nesmaže se |
| Objednávka vytvořena, aktualizována, zaplacena, vyřízena nebo zrušena | Objednávka přes API objednávek Brevo a události `order_paid`, `order_completed` a `order_cancelled` |
| Vytvořena refundace | Událost `order_refunded`. Pokud přes Tajo provozujete věrnostní program Brevo, body se poměrně odečtou. |
| Objednávka zaplacena, s věrnostním programem Brevo | Body připsané podle Vaší sazby bodů za dolar |
| Pokladna vytvořena nebo aktualizována, s e-mailem a položkami | Události `cart_updated` a `cart_abandoned`. Kdy odeslat zprávu, rozhodne Vaše automatizace v Brevo. |
| Produkt nebo kolekce vytvořeny, aktualizovány nebo smazány | Katalog produktů a kategorie v Brevo |
| Aktualizována úroveň zásob | Skladová zásoba produktu v katalogu Brevo. Když varianta přejde z 0 na více než 0, každý zákazník, který požádal o upozornění, dostane událost `back_in_stock`, jednou za každé naskladnění. |

Aplikace nepřidává do Vašeho motivu tlačítko „Notify me“. Žádost o upozornění na naskladnění musí přijít z Vašeho obchodu, například z tlačítka, které přidáte.

### Stávající data

Při instalaci aplikace naimportuje Vaše stávající zákazníky jako kontakty Brevo. Úplnou historickou synchronizaci spustíte ze stránky synchronizace v aplikaci. V placených tarifech importuje také produkty, kolekce, společnosti a objednávky.

## Krok 3: Sestavte pravidlo synchronizace s agentem

Pravidlo synchronizace je deklarativní definice jedné synchronizace: zdrojový prostředek, akce v Brevo, mapování polí a filtr. Nepíšete ho ručně. Popíšete ho, agent ho sestaví a člověk ho schválí.

1. V Tajo otevřete **Agents** a požádejte **Brevo Integration Architect** o synchronizaci běžnými slovy. Například: „Pošli zákazníky Shopify, kteří souhlasili s e-mailovým marketingem, do Brevo jako kontakty.“
2. Agent prozkoumá konektor Shopify. Jeho ukázka vrací názvy a typy polí, nikdy hodnoty zákazníků.
3. Navrhne pravidlo s mapováním polí a filtrem, pak ověří mapování polí vůči akci Brevo a provede zkušební běh (dry run) návrhu. Ani jeden krok nečte záznamy zákazníků.
4. Uloží pravidlo jako koncept. Můžete také začít ze šablony v **Connections > Syncs and mappings > New sync from template**.
5. **Request publish approval** spustí náhled nad Vaším obchodem. Přečte nejvýše 10 záznamů, do Brevo nic nezapíše a neposune kurzor. Zaznamená pouze počty: načtené záznamy, způsobilé, namapované a odmítnuté filtrem, plus chyby mapování. Pokud náhled selže, žádné schválení nevznikne.
6. Člověk žádost schválí na stránce **Approvals** s písemným zdůvodněním. Schválení je vázáno na otisk SHA-256 pravidla a vyprší po 30 minutách. Stránka pravidla pak zobrazí **Publish approved version**.

Úprava publikovaného pravidla ho vrátí do konceptu. Než znovu poběží, projde opět náhledem a schválením.

### Skutečné pravidlo

Toto je šablona **Shopify customers -> Brevo contacts** tak, jak ji Tajo definuje:

```ts
sourceSlug: "shopify",
sourceResource: "customers",
destinationSlug: "brevo",
destinationAction: "upsert_contact",
fieldMap: [
  { source: "email", destination: "email", transform: "toLowerCase" },
  { source: "first_name", destination: "attributes.FIRSTNAME" },
  { source: "last_name", destination: "attributes.LASTNAME" },
  { source: "phone", destination: "attributes.PHONE" },
  { source: "total_spent", destination: "attributes.TOTAL_SPENT", transform: "toNumber" },
  { source: "orders_count", destination: "attributes.ORDERS_COUNT", transform: "toNumber" },
  { source: "tajo_email_marketing_consent", destination: "attributes.OPT_IN", transform: "toBoolean" },
  { source: "tags", destination: "attributes.SHOPIFY_TAGS" },
  { source: "id", destination: "attributes.SHOPIFY_ID", transform: "toString" },
  { source: "created_at", destination: "attributes.SHOPIFY_CREATED_AT" },
  { source: "updated_at", destination: "attributes.SHOPIFY_UPDATED_AT" },
],
filterExpression:
  "($json.tajo_email_marketing_consent === true) && ($json.tajo_email_suppressed === false)",
```

Filtr je kontrola souhlasu. Tajo obě hodnoty odvozuje z `email_marketing_consent.state` v Shopify nebo ze staršího příznaku `accepts_marketing`. Pravidlo, které zapisuje kontakty do Brevo, nelze bez něj publikovat. Druhá šablona Shopify, **Shopify orders → Brevo orders**, zaznamenává v Brevo objednávky zákazníků, kteří při placení souhlasili s marketingem.

### Kdy pravidlo běží

- Pravidla synchronizace kontaktů běží ve výchozím nastavení každých 15 minut. Každý běh začíná od kurzoru pravidla.
- Stránka aktivního pravidla má tlačítko **Test run (1 batch)**.
- Aktivní, publikované pravidlo **Shopify orders → Brevo orders** také běží každých 15 minut. Jeho první plánovaný běh začíná několik minut před tímto okamžikem a neodešle žádné starší objednávky. Každý další běh odešle objednávky aktualizované od předchozího běhu.
- Starší objednávky se do Brevo dostanou jen tehdy, když pravidlo spustíte sami: tlačítkem **Test run (1 batch)**, nebo tak, že o spuštění požádáte agenta **Sync Operator**.
- Pravidlo pro objednávky běží podle plánu jen s filtrem marketingového souhlasu kupujícího ze šablony. Pravidlo s upraveným filtrem běží jen tehdy, když ho spustíte sami.
- Po pěti po sobě jdoucích neúspěšných bězích se pravidlo samo pozastaví a jeho stránka zobrazí poslední chybu. Odstraňte příčinu a pak pravidlo znovu publikujte.

Každý běh je uveden v historii běhů pravidla s počtem přečtených, zapsaných a neúspěšných záznamů a s dobou trvání.

## Co konektor Shopify čte a zapisuje

Pravidla synchronizace zapisují jen do cíle, zde do Brevo. Do Shopify nikdy nezapisují.

Aplikace Tajo pro Shopify požaduje 12 rozsahů oprávnění a do Shopify provádí krátký seznam zápisů, například odhlášení souhlasu a věrnostní štítky. [Vysvětlení oprávnění Shopify](https://tajo.io/cz/resources/help/integrations/shopify-permissions-explained/) uvádí každý rozsah a každý zápis i s tím, co ho spouští.

Agenti a hostitelé MCP přistupují k obchodu přes konektor Shopify:

| Čtení | Zápisy |
| --- | --- |
| Údaje o obchodu, zákazníci (seznam a vyhledávání), objednávky, produkty, metapole zákazníků, úrovně zásob, stav hromadného exportu | Metapole a štítky zákazníků a spuštění hromadného exportu. Každý zápis se připraví jako návrh a provede se až po schválení. |

Konektor deklaruje také úpravu zásob. Ta vyžaduje rozsah `write_inventory`, který aplikace Tajo pro Shopify nepožaduje.

## Krok 4: Používejte nástroje Shopify přes MCP

Tajo poskytuje konektor Shopify jako server MCP na adrese `https://alto.tajo.io/mcp/connectors/shopify`. Přidejte ho do Claude Code:

```bash
claude mcp add --transport http tajo-shopify https://alto.tajo.io/mcp/connectors/shopify
```

Hostitel najde OAuth server Tajo a otevře přihlášení do Tajo. Přístup mají jen účty v předběžném přístupu. Server nabízí 12 nástrojů:

| Nástroj | Co dělá |
| --- | --- |
| `preview_tajo_shopify_app` | Interaktivní náhled aplikace Tajo pro Shopify, vykreslený jako MCP UI |
| `get_shop` | Údaje o obchodu |
| `search_customers` | Vyhledávání zákazníků pomocí syntaxe dotazů Shopify, například `tag:tajo-vip` nebo `total_spent:>100` |
| `list_customers` | Seznam zákazníků po stránkách |
| `list_orders` | Seznam objednávek po stránkách |
| `list_products` | Seznam produktů s variantami, obrázky a zásobami |
| `get_customer_metafields` | Čtení metapolí zákazníka |
| `get_inventory_levels` | Čtení zásob varianty napříč lokacemi |
| `poll_bulk_export` | Kontrola hromadného exportu a získání odkazu ke stažení po jeho dokončení |
| `calculate_rewards_profile` | Výpočet úrovně, bodů a zůstatku odměn zákazníka ze synchronizovaných obchodních dat |
| `shopify_propose` | Připraví jeden zápis do Shopify jako návrh. Nic se neodešle. |
| `shopify_apply` | Provede schválený návrh |

## Řešení potíží

- Kontakty se v Brevo nezobrazují: viz [chybějící kontakty v Brevo](https://tajo.io/cz/resources/help/troubleshooting/contacts-missing-in-brevo/).
- Pravidlo, které neběží nebo se samo pozastavilo: viz [data se nesynchronizují](https://tajo.io/cz/resources/help/troubleshooting/data-not-syncing/).

## Další kroky

- [Pochopení synchronizace dat](https://tajo.io/cz/resources/help/getting-started/understanding-data-sync/), jak se chovají pravidla synchronizace
- [Vysvětlení oprávnění Shopify](https://tajo.io/cz/resources/help/integrations/shopify-permissions-explained/), každý rozsah a každý zápis
- [Shopify + Brevo](https://tajo.io/cz/docs/integrations/shopify-brevo), průvodce integrací
- [Kontaktujte tým](https://tajo.io/cz/contact), který Vám pomůže s nastavením