---
title: "Vodnik po integraciji s Shopifyjem | Tajo"
description: "Kako Tajo poveže trgovino Shopify z Brevom: sinhronizacija aplikacije Shopify prek webhookov, pravila sinhronizacije, ki jih sestavi agent in odobri človek, ter orodja Shopify prek MCP."
url: https://tajo.io/sl/docs/ecommerce-platforms/shopify/
markdown: https://tajo.io/sl/docs/ecommerce-platforms/shopify.md
lang: sl-SI
author: "Set Noa"
author_url: https://tajo.io/sl/set-noa/
robots: noindex
---

Zaprosite za zgodnji dostop

Vnesite svoje ime in službeni e-poštni naslov. Poslali vam bomo povezavo za potrditev zahteve za dostop do Taja.

# Vodnik po integraciji s Shopifyjem

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

Tajo poveže Shopify z Brevom na dveh mestih. Aplikacija Tajo za Shopify spremeni webhooke Shopify v zapise v Brevo takoj, ko prispejo. Pravila sinhronizacije, ki jih sestavi agent in odobri človek, po urniku prenašajo zapise v Brevo. Ta stran opisuje oboje, nato pa še orodja Shopify, ki jih Tajo ponuja prek MCP.

## Predpogoji

Pred začetkom integracije poskrbite, da imate:

- **Trgovino Shopify** na katerem koli paketu (Basic, Shopify, Advanced ali Plus)
- **Račun Tajo** (Tajo je v zgodnjem dostopu)
- **Račun Brevo**, cilj sinhronizacije
- **Skrbniški dostop** do vaše trgovine Shopify

## 1. korak: povežite svojo trgovino Shopify

Tajo je v zgodnjem dostopu. Aplikacija za Shopify ni navedena v trgovini Shopify App Store in samostojne povezave za namestitev ni. [Obrnite se na ekipo](https://tajo.io/sl/contact), da vam pomaga z nastavitvijo. Ko je vaš delovni prostor Tajo pripravljen:

1. V Tajo odprite **Connections**.
2. Vnesite domeno myshopify.com svoje trgovine in izberite **Connect Shopify**. Shopify prikaže obsege dovoljenj, ki jih Tajo zahteva, in vas po odobritvi vrne v Tajo.
3. Čemu je namenjen vsak obseg in kaj Tajo zapisuje nazaj v Shopify, preverite v [razlagi dovoljenj za Shopify](https://tajo.io/sl/resources/help/integrations/shopify-permissions-explained/).

## 2. korak: kaj aplikacija Tajo za Shopify pošilja v Brevo

Aplikacija preveri vsak webhook Shopify, ga shrani, uvrsti v čakalno vrsto in takoj obdela. Teme strank in izdelkov najprej počakajo približno štiri sekunde. Paketnega okna ni. Neuspelo opravilo se ponovi s postopno daljšim zamikom (backoff).

### Teme webhookov

Aplikacija Tajo za Shopify je naročena na te teme webhookov Shopify:

| Teme webhookov | Namen |
| --- | --- |
| `customers/create`, `customers/update`, `customers/delete` | Ohranjanje aktualnih stikov v Brevo |
| `orders/create`, `orders/updated`, `orders/fulfilled`, `orders/cancelled` | Dogodki naročil in metrike naročil za Brevo |
| `orders/paid`, `refunds/create` | Dodeljevanje in odštevanje točk zvestobe |
| `checkouts/create`, `checkouts/update` | Obnova opuščenih blagajn (checkouts) v Brevo |
| `products/create`, `products/update`, `products/delete` | Ohranjanje aktualnega kataloga izdelkov v Brevo |
| `inventory_levels/update` | Ohranjanje aktualnih zalog izdelkov v Brevo |
| `collections/create`, `collections/update`, `collections/delete` | Ohranjanje aktualnih zbirk |
| `companies/*`, `company_contacts/*`, `company_locations/*` (create, update, delete) | Sinhronizacija B2B podjetij |
| `app/uninstalled`, `app/scopes_update`, `app_subscriptions/update` | Življenjski cikel aplikacije |

Obvezni zasebnostni webhooki platforme Shopify (zahteva za podatke stranke, izbris stranke, izbris trgovine) so prav tako obdelani. Aplikacija ni naročena na `carts/*`. Opuščene košarice izvirajo iz tem `checkouts/*`.

Kaj pride v Brevo:

| Dogodek v Shopifyju | V Brevo |
| --- | --- |
| Stranka ustvarjena ali posodobljena | Stik se ustvari ali posodobi z imenom, e-poštnim naslovom in soglasjem za trženje. Na plačljivih paketih aplikacija doda oznake, število naročil, porabljeni znesek in zadnje naročilo. |
| Stranka izbrisana | Stik se odjavi, ne izbriše |
| Naročilo ustvarjeno, posodobljeno, plačano, izpolnjeno ali preklicano | Naročilo prek API-ja za naročila platforme Brevo ter dogodki `order_paid`, `order_completed` in `order_cancelled` |
| Vračilo ustvarjeno | Dogodek `order_refunded`. Če prek Taja vodite program zvestobe Brevo, se točke sorazmerno odštejejo. |
| Naročilo plačano, s programom zvestobe Brevo | Točke dodeljene po vaši stopnji točk na dolar |
| Blagajna ustvarjena ali posodobljena, z e-poštnim naslovom in artikli | Dogodka `cart_updated` in `cart_abandoned`. Kdaj se sporočilo pošlje, odloča vaša avtomatizacija v Brevo. |
| Izdelek ali zbirka ustvarjena, posodobljena ali izbrisana | Katalog izdelkov in kategorije v Brevo |
| Raven zaloge posodobljena | Zaloga izdelka v katalogu Brevo. Ko varianta preide z 0 na več kot 0, vsak kupec, ki je zahteval obvestilo, prejme dogodek `back_in_stock`, enkrat ob vsaki ponovni zalogi. |

Aplikacija v vašo temo ne doda gumba „Obvesti me“. Zahteva za obvestilo o ponovni zalogi mora priti iz vaše spletne trgovine, na primer iz gumba, ki ga dodate.

### Obstoječi podatki

Ob namestitvi aplikacija uvozi vaše obstoječe stranke kot stike Brevo. Celotno sinhronizacijo zgodovinskih podatkov zaženete s strani za sinhronizacijo v aplikaciji. Na plačljivih paketih uvozi tudi izdelke, zbirke, podjetja in naročila.

## 3. korak: sestavite pravilo sinhronizacije z agentom

Pravilo sinhronizacije je deklarativna definicija ene sinhronizacije: izvorni vir, dejanje v Brevo, preslikava polj in filter. Ne pišete ga ročno. Opišete ga, agent ga sestavi, človek pa ga odobri.

1. V Tajo odprite **Agents** in **Brevo Integration Architect** v navadnem jeziku prosite za sinhronizacijo. Na primer: „Pošiljaj stranke Shopify, ki so sprejele trženje po e-pošti, v Brevo kot stike.“
2. Agent pregleda konektor Shopify. Njegov vzorec vrne imena in vrste polj, nikoli vrednosti strank.
3. Predlaga pravilo s preslikavo polj in filtrom, nato preslikavo polj preveri glede na dejanje Brevo in osnutek poskusno zažene (dry run). Noben od teh korakov ne bere zapisov strank.
4. Pravilo shrani kot osnutek. Začnete lahko tudi s predlogo v **Connections > Syncs and mappings > New sync from template**.
5. **Request publish approval** zažene predogled nad vašo trgovino. Prebere največ 10 zapisov, v Brevo ne zapiše ničesar in ne premakne kazalca. Beleži le števila: prebrane zapise, ustrezne, preslikane in zapise, ki jih je filter zavrnil, ter napake preslikave. Če predogled ne uspe, odobritev ni ustvarjena.
6. Človek zahtevo odobri na strani **Approvals** s pisno utemeljitvijo. Odobritev je vezana na izvleček SHA-256 pravila in poteče po 30 minutah. Stran pravila nato prikaže **Publish approved version**.

Urejanje objavljenega pravila ga vrne v osnutek. Pred naslednjim izvajanjem znova gre skozi predogled in odobritev.

### Resnično pravilo

To je predloga **Shopify customers -> Brevo contacts**, kot jo definira Tajo:

```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)",
```

Filter je preverjanje soglasja. Tajo obe vrednosti izpelje iz polja `email_marketing_consent.state` v Shopifyju ali iz starejše zastavice `accepts_marketing`. Pravila, ki zapisuje stike v Brevo, brez njega ni mogoče objaviti. Druga predloga Shopify, **Shopify orders → Brevo orders**, v Brevo beleži naročila kupcev, ki so ob nakupu sprejeli trženje.

### Kdaj se pravilo izvaja

- Pravila sinhronizacije stikov se privzeto izvajajo vsakih 15 minut. Vsako izvajanje se začne pri kazalcu pravila.
- Stran aktivnega pravila ima gumb **Test run (1 batch)**.
- Aktivno objavljeno pravilo **Shopify orders → Brevo orders** se prav tako izvaja vsakih 15 minut. Prvo načrtovano izvajanje se začne nekaj minut pred tem trenutkom in ne pošlje starejših naročil. Vsako naslednje izvajanje pošlje naročila, posodobljena od prejšnjega.
- Pretekla naročila pridejo v Brevo le, ko pravilo zaženete sami: z gumbom **Test run (1 batch)** ali tako, da za to prosite agenta **Sync Operator**.
- Pravilo za naročila se po urniku izvaja le s filtrom privolitve kupca v trženje iz predloge. Pravilo z urejenim filtrom se izvede le, ko ga zaženete sami.
- Po petih zaporednih neuspelih izvajanjih se pravilo samo zaustavi, njegova stran pa prikaže zadnjo napako. Odpravite vzrok in ga nato znova objavite.

Vsako izvajanje je navedeno v zgodovini izvajanj pravila s prebranimi, zapisanimi in neuspelimi zapisi ter s trajanjem.

## Kaj konektor Shopify bere in zapisuje

Pravila sinhronizacije zapisujejo le v cilj, tukaj v Brevo. V Shopify nikoli ne zapisujejo.

Aplikacija Tajo za Shopify zahteva 12 obsegov dovoljenj in v Shopify izvede kratek seznam zapisov, na primer odjave soglasja in oznake zvestobe. [Razlaga dovoljenj za Shopify](https://tajo.io/sl/resources/help/integrations/shopify-permissions-explained/) navaja vsak obseg in vsak zapis ter kaj ga sproži.

Agenti in gostitelji MCP do trgovine dostopajo prek konektorja Shopify:

| Branje | Zapisovanje |
| --- | --- |
| Podatki trgovine, stranke (seznam in iskanje), naročila, izdelki, metapolja strank, ravni zalog, stanje množičnega izvoza | Metapolja in oznake strank ter zagon množičnega izvoza. Vsak zapis se pripravi kot predlog in se izvede šele po odobritvi. |

Konektor deklarira tudi prilagoditev zaloge. Ta zahteva obseg `write_inventory`, ki ga aplikacija Tajo za Shopify ne zahteva.

## 4. korak: uporabljajte orodja Shopify prek MCP

Tajo ponuja konektor Shopify kot strežnik MCP na naslovu `https://alto.tajo.io/mcp/connectors/shopify`. Dodajte ga v Claude Code:

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

Gostitelj odkrije strežnik OAuth platforme Tajo in odpre prijavo v Tajo. Dostop imajo le računi v zgodnjem dostopu. Strežnik ponuja 12 orodij:

| Orodje | Kaj naredi |
| --- | --- |
| `preview_tajo_shopify_app` | Interaktivni predogled aplikacije Tajo za Shopify, izrisan kot MCP UI |
| `get_shop` | Podatki trgovine |
| `search_customers` | Iskanje strank s sintakso poizvedb Shopify, na primer `tag:tajo-vip` ali `total_spent:>100` |
| `list_customers` | Seznam strank po straneh |
| `list_orders` | Seznam naročil po straneh |
| `list_products` | Seznam izdelkov z variantami, slikami in zalogo |
| `get_customer_metafields` | Branje metapolj stranke |
| `get_inventory_levels` | Branje zaloge variante po lokacijah |
| `poll_bulk_export` | Preverjanje množičnega izvoza in pridobitev povezave za prenos, ko se konča |
| `calculate_rewards_profile` | Izračun ravni, točk in stanja nagrad stranke iz sinhroniziranih podatkov o nakupih |
| `shopify_propose` | Pripravi en zapis v Shopify kot predlog. Nič se ne pošlje. |
| `shopify_apply` | Izvede odobren predlog |

## Odpravljanje težav

- Stiki se ne prikažejo v Brevo: glejte [manjkajoči stiki v Brevo](https://tajo.io/sl/resources/help/troubleshooting/contacts-missing-in-brevo/).
- Pravilo, ki se ne izvaja ali se je samo zaustavilo: glejte [podatki se ne sinhronizirajo](https://tajo.io/sl/resources/help/troubleshooting/data-not-syncing/).

## Naslednji koraki

- [Razumevanje sinhronizacije podatkov](https://tajo.io/sl/resources/help/getting-started/understanding-data-sync/), kako se obnašajo pravila sinhronizacije
- [Razlaga dovoljenj za Shopify](https://tajo.io/sl/resources/help/integrations/shopify-permissions-explained/), vsak obseg in vsak zapis
- [Shopify + Brevo](https://tajo.io/sl/docs/integrations/shopify-brevo), vodnik po integraciji
- [Obrnite se na ekipo](https://tajo.io/sl/contact), da vam pomaga z nastavitvijo