Shopify integrációs útmutató

A Tajo két ponton köti össze a Shopify-t a Brevóval. A Tajo Shopify-alkalmazás a Shopify webhookokat a beérkezésükkor Brevo-írásokká alakítja. Az ügynök által felépített és ember által jóváhagyott szinkronizálási szabályok ütemezetten visznek át rekordokat a Brevóba. Ez az oldal mindkettőt bemutatja, majd a Shopify-eszközöket, amelyeket a Tajo MCP-n keresztül szolgál ki.

Előfeltételek

Az integráció megkezdése előtt győződj meg róla, hogy megvan:

• Shopify áruház bármelyik csomaggal (Basic, Shopify, Advanced vagy Plus)
• Tajo fiók (a Tajo korai hozzáférésben érhető el)
• Brevo fiók, a szinkronizálás célja
• Adminisztrátori hozzáférés a Shopify áruházadhoz

1. lépés: kösd össze a Shopify áruházadat

A Tajo korai hozzáférésben érhető el. A Shopify-alkalmazás nem szerepel a Shopify App Store-ban, és nincs önkiszolgáló telepítési hivatkozás. A beállításhoz lépj kapcsolatba a csapattal. Amint a Tajo munkaterületed készen áll:

1. A Tajóban nyisd meg a Connections oldalt.
2. Add meg az áruházad myshopify.com domainjét, és válaszd a Connect Shopify lehetőséget. A Shopify megmutatja a Tajo által kért scope-okat, és a jóváhagyásuk után visszavisz a Tajóba.
3. Nézd meg, mire szolgál az egyes scope, és mit ír vissza a Tajo a Shopify-ba, a Shopify engedélyek magyarázata oldalon.

2. lépés: mit küld a Tajo Shopify-alkalmazás a Brevóba

Az alkalmazás minden Shopify webhookot ellenőriz, eltárol, sorba állít, és azonnal feldolgoz. A vásárlói és terméktémák előtte körülbelül négy másodpercet várnak. Nincs kötegelési időablak. A sikertelen feladatot az alkalmazás fokozatosan növekvő várakozással (backoff) újrapróbálja.

Webhooktémák

A Tajo Shopify-alkalmazás ezekre a Shopify-webhooktémákra iratkozik fel:

A Shopify kötelező adatvédelmi webhookjait (vásárlói adatkérés, vásárlói adatok törlése, áruházadatok törlése) is kezeli. Az alkalmazás nem iratkozik fel a carts/* témákra. Az elhagyott kosarak a checkouts/* témákból érkeznek.

Ami a Brevóba kerül:

Az alkalmazás nem ad „Notify me” gombot a témádhoz. Az „újra készleten” kérésnek a webáruházadból kell érkeznie, például egy általad hozzáadott gombról.

Meglévő adatok

Telepítéskor az alkalmazás Brevo-kontaktokként importálja a meglévő vásárlóidat. Teljes múltbeli szinkronizálást az alkalmazás szinkronizálási oldaláról indíthatsz. Fizetős csomagokon a termékeket, kollekciókat, cégeket és rendeléseket is importálja.

3. lépés: építs szinkronizálási szabályt az ügynökkel

A szinkronizálási szabály egy szinkronizálás deklaratív definíciója: egy forráserőforrás, egy Brevo-művelet, egy mezőleképezés és egy szűrő. Nem kézzel írod meg. Te leírod, egy ügynök felépíti, egy ember pedig jóváhagyja.

1. A Tajóban nyisd meg az Agents oldalt, és kérd a szinkronizálást hétköznapi nyelven a Brevo Integration Architect ügynöktől. Például: „Küldd át a Brevóba kontaktként azokat a Shopify-vásárlókat, akik elfogadták az e-mail-marketinget.”
2. Az ügynök megvizsgálja a Shopify-csatlakozót. A mintája mezőneveket és -típusokat ad vissza, vásárlói értékeket soha.
3. Javasol egy szabályt mezőleképezéssel és szűrővel, majd a mezőleképezést a Brevo-művelethez méri, és próbafuttatást (dry run) végez a vázlaton. Egyik lépés sem olvas vásárlói rekordokat.
4. A szabályt vázlatként menti. Sablonból is indulhatsz a Connections > Syncs and mappings > New sync from template alatt.
5. A Request publish approval előnézetet futtat az áruházadon. Legfeljebb 10 rekordot olvas be, semmit nem ír a Brevóba, és nem mozdítja el a kurzort. Csak darabszámokat rögzít: a lekért, a jogosult, a leképezett és a szűrő által elutasított rekordokét, valamint a leképezési hibákat. Ha az előnézet sikertelen, nem jön létre jóváhagyási kérés.
6. Egy ember az Approvals oldalon hagyja jóvá a kérést, írásos indoklással. A jóváhagyás a szabály SHA-256 kivonatához kötődik, és 30 perc után lejár. Ezután a szabály oldalán megjelenik a Publish approved version.

Egy közzétett szabály szerkesztése visszaállítja azt vázlattá. Mielőtt újra futna, ismét át kell mennie az előnézeten és a jóváhagyáson.

Egy valódi szabály

Ez a Shopify customers -> Brevo contacts sablon, ahogy a Tajo definiálja:

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

A szűrő a hozzájárulás-ellenőrzés. A Tajo mindkét értéket a Shopify email_marketing_consent.state mezőjéből vagy a régebbi accepts_marketing jelzőből származtatja. Kontaktokat a Brevóba író szabály nélküle nem tehető közzé. A másik Shopify-sablon, a Shopify orders → Brevo orders, azoknak a vásárlóknak a rendeléseit rögzíti a Brevóban, akik a pénztárnál elfogadták a marketinget.

Mikor fut egy szabály

• A kontaktszinkronizálási szabályok alapértelmezés szerint 15 percenként futnak. Minden futás a szabály kurzorától indul.
• Egy aktív szabály oldalán van egy Test run (1 batch) gomb.
• Egy aktív, közzétett Shopify orders → Brevo orders szabály szintén 15 percenként fut. Az első ütemezett futása néhány perccel e pillanat előtt indul, és nem küld régebbi rendeléseket. Minden további futás az előző futás óta frissült rendeléseket küldi.
• Korábbi rendelések csak akkor kerülnek a Brevóba, ha te magad futtatod a szabályt: a Test run (1 batch) gombbal, vagy ha megkéred a Sync Operator ügynököt, hogy futtassa.
• Egy rendelésszabály csak a sablon vásárlói marketing-hozzájárulási szűrőjével fut ütemezetten. Az a szabály, amelynek a szűrőjét módosították, csak akkor fut, amikor te elindítod.
• Öt egymást követő sikertelen futás után a szabály szünetelteti magát, és az oldala megmutatja az utolsó hibát. Javítsd ki az okot, majd tedd közzé újra.

Minden futás szerepel a szabály futtatási előzményeiben a beolvasott, kiírt és sikertelen rekordok számával, valamint az időtartammal.

Mit olvas és ír a Shopify-csatlakozó

A szinkronizálási szabályok csak a célba írnak, itt a Brevóba. A Shopify-ba soha nem írnak.

A Tajo Shopify-alkalmazás 12 scope-ot kér, és néhány dolgot ír a Shopify-ba, például hozzájárulás-visszavonásokat és hűségcímkéket. A Shopify engedélyek magyarázata felsorol minden scope-ot és minden írást, azzal együtt, hogy mi váltja ki.

Az ügynökök és az MCP-gazdák a Shopify-csatlakozón keresztül érik el az áruházat:

A csatlakozó egy készletmódosítást is deklarál. Ehhez a write_inventory scope kell, amelyet a Tajo Shopify-alkalmazás nem kér.

4. lépés: használd a Shopify-eszközöket MCP-n keresztül

A Tajo a Shopify-csatlakozót MCP-szerverként szolgálja ki a https://alto.tajo.io/mcp/connectors/shopify címen. Add hozzá a Claude Code-hoz:

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

A gazda felderíti a Tajo OAuth-szerverét, és megnyitja a Tajo bejelentkezést. A hozzáférés a korai hozzáférésű fiókokra korlátozódik. A szerver 12 eszközt kínál:

Hibaelhárítás

• Nem jelennek meg kontaktok a Brevóban: lásd hiányzó kontaktok a Brevóban.
• Egy szabály nem fut, vagy szüneteltette magát: lásd nem szinkronizálódnak az adatok.

Következő lépések

• Az adatszinkronizálás megértése, hogyan működnek a szinkronizálási szabályok
• Shopify engedélyek magyarázata, minden scope és minden írás
• Shopify + Brevo, az integrációs útmutató
• Lépj kapcsolatba a csapattal a beállításhoz