Zatražite rani pristup

Unesite ime i poslovnu adresu e-pošte. Poslaćemo vam vezu za potvrdu zahteva za pristup Taju.

Na ovoj stranici

Vodič za integraciju sa Shopify platformom

Tajo povezuje Shopify sa Brevom na dva mesta. Tajo Shopify aplikacija pretvara Shopify webhook-ove u upise u Brevo čim stignu. Pravila sinhronizacije, koja agent pravi a osoba odobrava, po rasporedu prenose zapise u Brevo. Ova stranica opisuje oba načina, a zatim Shopify alate koje Tajo nudi preko MCP-a.

Preduslovi

Pre nego što započnete integraciju, uverite se da imate:

Shopify prodavnicu na bilo kom planu (Basic, Shopify, Advanced ili Plus)
Tajo nalog (Tajo je u ranom pristupu)
Brevo nalog, odredište sinhronizacije
Administratorski pristup svojoj Shopify prodavnici

Korak 1: Povežite svoju Shopify prodavnicu

Tajo je u ranom pristupu. Shopify aplikacija nije navedena u prodavnici Shopify App Store i ne postoji link za samostalnu instalaciju. Obratite se timu da vam pomogne sa podešavanjem. Kada je vaš Tajo radni prostor spreman:

U Taju otvorite Connections.
Unesite myshopify.com domen svoje prodavnice i izaberite Connect Shopify. Shopify prikazuje opsege dozvola koje Tajo traži i nakon vašeg odobrenja vas vraća u Tajo.
Za šta služi svaki opseg i šta Tajo upisuje nazad u Shopify, proverite u objašnjenju Shopify dozvola.

Korak 2: Šta Tajo Shopify aplikacija šalje u Brevo

Aplikacija proverava svaki Shopify webhook, čuva ga, stavlja u red i odmah obrađuje. Teme kupaca i proizvoda prvo čekaju oko četiri sekunde. Nema prozora za grupnu obradu. Neuspeo posao se ponavlja sa sve dužim razmakom (backoff).

Teme webhook-ova

Tajo Shopify aplikacija pretplaćena je na ove teme Shopify webhook-ova:

Teme webhook-ova	Namena
`customers/create`, `customers/update`, `customers/delete`	Održavanje ažurnih kontakata u Brevo
`orders/create`, `orders/updated`, `orders/fulfilled`, `orders/cancelled`	Događaji porudžbina i metrike porudžbina za Brevo
`orders/paid`, `refunds/create`	Dodela i oduzimanje poena lojalnosti
`checkouts/create`, `checkouts/update`	Povraćaj napuštenih naplata (checkouts) u Brevo
`products/create`, `products/update`, `products/delete`	Održavanje ažurnog kataloga proizvoda u Brevo
`inventory_levels/update`	Održavanje ažurnih zaliha proizvoda u Brevo
`collections/create`, `collections/update`, `collections/delete`	Održavanje ažurnih kolekcija
`companies/`, `company_contacts/`, `company_locations/*` (create, update, delete)	Sinhronizacija B2B kompanija
`app/uninstalled`, `app/scopes_update`, `app_subscriptions/update`	Životni ciklus aplikacije

Obavezni Shopify webhook-ovi za privatnost (zahtev za podatke kupca, brisanje kupca, brisanje prodavnice) takođe su obrađeni. Aplikacija nije pretplaćena na carts/*. Napuštene korpe dolaze iz tema checkouts/*.

Šta stiže u Brevo:

Shopify događaj	U Brevo
Kupac kreiran ili ažuriran	Kontakt se kreira ili ažurira sa imenom, imejlom i marketinškom saglasnošću. Na plaćenim planovima aplikacija dodaje oznake, broj porudžbina, potrošeni iznos i poslednju porudžbinu.
Kupac obrisan	Kontakt se odjavljuje, ne briše se
Porudžbina kreirana, ažurirana, plaćena, ispunjena ili otkazana	Porudžbina preko Brevo API-ja za porudžbine i događaji `order_paid`, `order_completed` i `order_cancelled`
Povraćaj novca kreiran	Događaj `order_refunded`. Ako preko Taja vodite Brevo program lojalnosti, poeni se srazmerno oduzimaju.
Porudžbina plaćena, uz Brevo program lojalnosti	Poeni se dodeljuju po vašoj stopi poena po dolaru
Naplata kreirana ili ažurirana, sa imejlom i stavkama	Događaji `cart_updated` i `cart_abandoned`. Vaša Brevo automatizacija odlučuje kada se šalje.
Proizvod ili kolekcija kreirani, ažurirani ili obrisani	Brevo katalog proizvoda i kategorije
Nivo zaliha ažuriran	Zalihe proizvoda u Brevo katalogu. Kada varijanta pređe sa 0 na više od 0, svaki kupac koji je tražio obaveštenje dobija događaj `back_in_stock`, jednom po popunjavanju zaliha.

Aplikacija ne dodaje dugme „Obavesti me“ u vašu temu. Zahtev za obaveštenje o ponovnoj dostupnosti mora da dođe iz vaše prodavnice, na primer preko dugmeta koje sami dodate.

Postojeći podaci

Pri instalaciji aplikacija uvozi vaše postojeće kupce kao Brevo kontakte. Potpuna istorijska sinhronizacija pokreće se sa stranice za sinhronizaciju u aplikaciji. Na plaćenim planovima ona uvozi i proizvode, kolekcije, kompanije i porudžbine.

Korak 3: Napravite pravilo sinhronizacije uz pomoć agenta

Pravilo sinhronizacije je deklarativna definicija jedne sinhronizacije: izvorni resurs, Brevo akcija, mapa polja i filter. Ne pišete ga ručno. Vi ga opišete, agent ga napravi, a osoba ga odobri.

U Taju otvorite Agents i običnim jezikom zatražite sinhronizaciju od agenta Brevo Integration Architect. Na primer: „Pošalji Shopify kupce koji su prihvatili imejl marketing u Brevo kao kontakte.“
Agent pregleda Shopify konektor. Njegov uzorak vraća nazive i tipove polja, nikada vrednosti kupaca.
Predlaže pravilo sa mapom polja i filterom, zatim validira mapu polja prema Brevo akciji i probno pokreće nacrt (dry run). Nijedan od ovih koraka ne čita zapise kupaca.
Čuva pravilo kao nacrt. Možete početi i od šablona u Connections > Syncs and mappings > New sync from template.
Request publish approval pokreće pregled nad vašom prodavnicom. Čita najviše 10 zapisa, ništa ne upisuje u Brevo i ne pomera kursor. Beleži samo brojeve: preuzete zapise, podobne, mapirane i one koje je filter odbio, kao i greške mapiranja. Ako pregled ne uspe, odobrenje se ne kreira.
Osoba odobrava zahtev na stranici Approvals, uz pisano obrazloženje. Odobrenje je vezano za SHA-256 sažetak pravila i ističe posle 30 minuta. Stranica pravila tada prikazuje Publish approved version.

Izmena objavljenog pravila vraća ga u nacrt. Pre ponovnog pokretanja ono ponovo prolazi kroz pregled i odobrenje.

Stvarno pravilo

Ovo je šablon Shopify customers -> Brevo contacts onako kako ga Tajo definiše:

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 provera saglasnosti. Tajo izvodi obe vrednosti iz Shopify polja email_marketing_consent.state ili iz starije oznake accepts_marketing. Pravilo koje upisuje kontakte u Brevo ne može da se objavi bez njega. Drugi Shopify šablon, Shopify orders → Brevo orders, beleži porudžbine u Brevo za kupce koji su pri naplati prihvatili marketing.

Kada se pravilo pokreće

Pravila sinhronizacije kontakata podrazumevano se pokreću na svakih 15 minuta. Svako pokretanje kreće od kursora pravila.
Stranica aktivnog pravila ima dugme Test run (1 batch).
Aktivno, objavljeno pravilo Shopify orders → Brevo orders takođe se pokreće na svakih 15 minuta. Njegovo prvo zakazano pokretanje kreće nekoliko minuta pre tog trenutka i ne šalje starije porudžbine. Svako sledeće pokretanje šalje porudžbine ažurirane od prethodnog pokretanja.
Ranije porudžbine stižu u Brevo samo kada sami pokrenete pravilo: dugmetom Test run (1 batch) ili tako što zatražite od agenta Sync Operator da ga pokrene.
Pravilo za porudžbine pokreće se po rasporedu samo sa filterom šablona za marketinšku saglasnost kupca. Pravilo čiji je filter izmenjen pokreće se samo kada ga vi pokrenete.
Posle pet uzastopnih neuspelih pokretanja pravilo se samo pauzira, a njegova stranica prikazuje poslednju grešku. Otklonite uzrok, pa ga ponovo objavite.

Svako pokretanje je navedeno u istoriji pokretanja pravila, sa pročitanim, upisanim i neuspelim zapisima i trajanjem.

Šta Shopify konektor čita i upisuje

Pravila sinhronizacije upisuju samo u odredište, ovde Brevo. Nikada ne upisuju u Shopify.

Tajo Shopify aplikacija traži 12 opsega dozvola i obavlja kratak spisak upisa u Shopify, kao što su odjave od saglasnosti i oznake lojalnosti. Objašnjenje Shopify dozvola navodi svaki opseg i svaki upis, uz ono što ga pokreće.

Agenti i MCP hostovi pristupaju prodavnici preko Shopify konektora:

Čita	Upisuje
Podatke o prodavnici, kupce (spisak i pretraga), porudžbine, proizvode, metapolja kupaca, nivoe zaliha, status grupnog izvoza	Metapolja kupaca i oznake kupaca, kao i pokretanje grupnog izvoza. Svaki upis se priprema kao predlog i izvršava tek nakon odobrenja.

Konektor deklariše i usklađivanje zaliha. Za njega je potreban opseg write_inventory, koji Tajo Shopify aplikacija ne traži.

Korak 4: Koristite Shopify alate preko MCP-a

Tajo nudi Shopify konektor kao MCP server na adresi https://alto.tajo.io/mcp/connectors/shopify. Dodajte ga u Claude Code:

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

Host pronalazi Tajo OAuth server i otvara Tajo prijavu. Pristup je ograničen na naloge u ranom pristupu. Server nudi 12 alata:

Alat	Šta radi
`preview_tajo_shopify_app`	Interaktivni pregled Tajo Shopify aplikacije, prikazan kao MCP UI
`get_shop`	Podaci o prodavnici
`search_customers`	Pretraga kupaca Shopify sintaksom upita, na primer `tag:tajo-vip` ili `total_spent:>100`
`list_customers`	Spisak kupaca, po stranicama
`list_orders`	Spisak porudžbina, po stranicama
`list_products`	Spisak proizvoda sa varijantama, slikama i zalihama
`get_customer_metafields`	Čitanje metapolja kupca
`get_inventory_levels`	Čitanje zaliha varijante na svim lokacijama
`poll_bulk_export`	Provera grupnog izvoza i preuzimanje linka za preuzimanje kada se završi
`calculate_rewards_profile`	Izračunavanje nivoa, poena i stanja nagrada kupca iz sinhronizovanih podataka o kupovini
`shopify_propose`	Priprema jednog upisa u Shopify kao predloga. Ništa se ne šalje.
`shopify_apply`	Izvršavanje odobrenog predloga

Rešavanje problema

Kontakti se ne pojavljuju u Brevo: pogledajte kontakti nedostaju u Brevo.
Pravilo koje se ne pokreće ili se samo pauziralo: pogledajte podaci se ne sinhronizuju.

Sledeći koraci

Razumevanje sinhronizacije podataka, kako se ponašaju pravila sinhronizacije
Objašnjenje Shopify dozvola, svaki opseg i svaki upis
Shopify + Brevo, vodič za integraciju
Obratite se timu da vam pomogne sa podešavanjem