--- title: "BigCommerce konektor" description: "Kompletný sprievodca integráciou BigCommerce na synchronizáciu zákazníkov, objednávok, produktov a dát obchodu s Brevo cez Tajo." url: https://tajo.io/sk/docs/connectors/ecommerce/bigcommerce/ markdown: https://tajo.io/sk/docs/connectors/ecommerce/bigcommerce.md lang: sk-SK robots: noindex --- Požiadajte o skorý prístup Zadajte svoje meno a pracovnú e-mailovú adresu. Pošleme vám odkaz na potvrdenie žiadosti o prístup k Tajo. # BigCommerce konektor Stav konektora: Vo vývoji Vzniká. Zatiaľ neoverené. | Zdrojové pole | Cieľové pole | Ukážková hodnota | | --- | --- | --- | | `record.id` | `source_id` | `record_1042` | | `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` | | `record.value` | `value` | `sample_value` | Prepoj svoj obchod BigCommerce s Brevo cez Tajo pre kompletnú synchronizáciu e-commerce dát. Synchronizuj zákazníkov, objednávky, produkty a udalosti košíka na poháňanie cielených marketingových kampaní, obnovy opustených košíkov a automatizácie po nákupe. ## Prehľad | Vlastnosť | Hodnota | | --- | --- | | **Platforma** | BigCommerce | | **Kategória** | E-commerce | | **Zložitosť nastavenia** | Stredná | | **Oficiálna integrácia** | Nie | | **Synchronizované dáta** | Zákazníci, Objednávky, Produkty, Košíky | | **Dostupné skilly** | 10 | ## Funkcie - **Synchronizácia zákazníkov** - Synchronizácia dát zákazníkov v reálnom čase do kontaktov Brevo - **Sledovanie objednávok** - Udalosti životného cyklu objednávky pre marketingové toky po nákupe - **Synchronizácia katalógu produktov** - Synchronizuj produkty pre e-mailové odporúčania a dynamický obsah - **Opustenie košíka** - Sleduj a obnov opustené košíky s automatizovanými e-mailmi - **Podpora viacerých obchodov** - Prepoj viacero obchodov BigCommerce - **Aktualizácie riadené webhookmi** - Aktualizácie dát v reálnom čase cez webhooky BigCommerce - **Vlastné polia** - Namapuj vlastné polia BigCommerce na atribúty kontaktov Brevo - **Sledovanie zásob** - Synchronizuj stav zásob pre notifikácie o dostupnosti produktov ## Predpoklady Predtým, než začneš, uisti sa, že máš: 1. Obchod BigCommerce s prístupom Store Owner alebo Admin 2. API účet BigCommerce s príslušnými OAuth scopy 3. Tvoj Store Hash (nájdeš v URL obchodu alebo API prihlasovacích údajoch) 4. Brevo účet s API prístupom 5. Tajo účet s API prihlasovacími údajmi ## Autentifikácia ### Prihlasovací údaje API účtu BigCommerce používa API účty na základe OAuth. Vytvor jeden v ovládacom paneli BigCommerce pod **Settings > API > API Accounts**. Obdržíš: - **Client ID** - Identifikátor tvojej aplikácie - **Client Secret** - Secret tvojej aplikácie (ulož bezpečne) - **Access Token** - Používaný pre autentifikáciu API - **Store Hash** - Tvoj unikátny identifikátor obchodu ```bash curl https://api.bigcommerce.com/stores/{store_hash}/v3/catalog/products \ -H "X-Auth-Token: YOUR_ACCESS_TOKEN" \ -H "Content-Type: application/json" \ -H "Accept: application/json" ``` ### Požadované OAuth scopy | Scope | Prístup | Účel | | --- | --- | --- | | `store_v2_customers` | Čítanie | Synchronizácia dát zákazníkov | | `store_v2_orders` | Čítanie | Sledovanie udalostí objednávok | | `store_v2_products` | Čítanie | Synchronizácia katalógu produktov | | `store_cart` | Čítanie | Sledovanie opustenia košíka | | `store_v2_information` | Čítanie | Konfigurácia obchodu | | `store_v2_content` | Čítanie | Obsah obchodu | ## Konfigurácia ### Základné nastavenie ```yaml connectors: bigcommerce: enabled: true store_hash: "your-store-hash" access_token: "your-access-token" client_id: "your-client-id" # Data sync options sync: customers: true orders: true products: true carts: true inventory: false # Brevo list assignment lists: all_customers: 40 buyers: 41 abandoned_cart: 42 ``` ### Mapovanie polí zákazníkov Namapuj polia zákazníkov BigCommerce na atribúty Brevo: ```yaml customer_mapping: email: email first_name: FIRSTNAME last_name: LASTNAME phone: SMS company: COMPANY # Address fields addresses[0].city: CITY addresses[0].state: STATE addresses[0].country: COUNTRY addresses[0].zip: ZIP # E-commerce metrics orders_count: ORDER_COUNT total_spent: TOTAL_SPENT date_created: SIGNUP_DATE # Customer group customer_group_id: CUSTOMER_GROUP ``` ### Konfigurácia webhookov ```yaml webhooks: - scope: "store/customer/created" destination: "customer_created" - scope: "store/customer/updated" destination: "customer_updated" - scope: "store/order/created" destination: "order_placed" - scope: "store/order/updated" destination: "order_updated" - scope: "store/order/statusUpdated" destination: "order_status_changed" - scope: "store/cart/created" destination: "cart_created" - scope: "store/cart/updated" destination: "cart_updated" - scope: "store/cart/abandoned" destination: "cart_abandoned" - scope: "store/inventory/updated" destination: "inventory_changed" ``` ## API endpointy | Metóda | Endpoint | Popis | | --- | --- | --- | | `GET` | `/v3/customers` | Zoznam zákazníkov | | `POST` | `/v3/customers` | Vytvorenie zákazníkov | | `PUT` | `/v3/customers` | Aktualizácia zákazníkov | | `GET` | `/v2/orders` | Zoznam objednávok | | `GET` | `/v2/orders/{id}` | Detaily objednávky | | `GET` | `/v3/catalog/products` | Zoznam produktov | | `GET` | `/v3/catalog/products/{id}` | Detaily produktu | | `GET` | `/v3/catalog/products/{id}/variants` | Zoznam variantov produktu | | `GET` | `/v3/carts` | Zoznam košíkov | | `GET` | `/v3/abandoned-carts` | Zoznam opustených košíkov | | `POST` | `/v3/hooks` | Vytvorenie webhooku | | `GET` | `/v3/catalog/categories` | Zoznam kategórií | ## Ukážky kódu ### Inicializácia BigCommerce konektora ```javascript import { TajoClient } from '@tajo/sdk'; const tajo = new TajoClient({ apiKey: process.env.TAJO_API_KEY, brevoApiKey: process.env.BREVO_API_KEY }); // Connect BigCommerce store await tajo.connectors.connect('bigcommerce', { storeHash: process.env.BC_STORE_HASH, accessToken: process.env.BC_ACCESS_TOKEN, clientId: process.env.BC_CLIENT_ID }); ``` ### Načítanie a synchronizácia zákazníkov ```javascript // Fetch customers from BigCommerce const response = await fetch( `https://api.bigcommerce.com/stores/${STORE_HASH}/v3/customers?limit=250`, { headers: { 'X-Auth-Token': ACCESS_TOKEN, 'Content-Type': 'application/json' } } ); const { data, meta } = await response.json(); // data: [{ id, email, first_name, last_name, phone, ... }] // meta.pagination: { total, count, per_page, current_page, total_pages } ``` ### Spracovanie webhookových udalostí ```javascript // BigCommerce webhook handler app.post('/webhooks/bigcommerce', async (req, res) => { const { scope, store_id, data } = req.body; // Verify the webhook is from your store if (store_id !== process.env.BC_STORE_HASH) { return res.status(401).send('Unauthorized'); } // Forward to Tajo await tajo.connectors.handleWebhook('bigcommerce', { topic: scope, payload: data }); res.status(200).send('OK'); }); ``` ### Synchronizácia katalógu produktov ```javascript // Full product catalog sync await tajo.connectors.sync('bigcommerce', { type: 'full', resources: ['products'], includeVariants: true, includeImages: true }); // Check sync status const status = await tajo.connectors.status('bigcommerce'); console.log(status); // { // connected: true, // lastSync: '2024-01-15T10:30:00Z', // customersCount: 8200, // ordersCount: 4500, // productsCount: 620 // } ``` ## Obmedzenia rýchlosti | Plán | Limit | Detaily | | --- | --- | --- | | **Standard** | 150 požiadaviek/30 sek | Na obchod | | **Plus** | 300 požiadaviek/30 sek | Na obchod | | **Pro** | 450 požiadaviek/30 sek | Na obchod | | **Enterprise** | Neobmedzene | Vlastné limity | Ďalšie limity: | Zdroj | Limit | | --- | --- | | **Webhooky** | 100 na obchod | | **Na stránku** | Max 250 záznamov | | **Súbežné požiadavky** | Závisí od plánu | Hlavičky limitov rýchlosti Monitoruj hlavičky `X-Rate-Limit-Requests-Left` a `X-Rate-Limit-Time-Reset-Ms` na správu využitia API v rámci limitov. ## Riešenie problémov | Problém | Príčina | Riešenie | | --- | --- | --- | | `401 Unauthorized` | Neplatný access token | Znovu vygeneruj API prihlasovací údaje v administrácii BigCommerce | | `403 Forbidden` | Chýbajúci OAuth scope | Skontroluj scopy API účtu a pridaj požadované oprávnenia | | Webhooky sa nespúšťajú | Dosiahnutý limit webhookov | Skontroluj počet webhookov (max 100) a odstráň nepoužívané | | Chýbajúce udalosti košíka | Skripty obchodu nie sú načítané | Overte sledovací skript na obchode BigCommerce | | Produkty nie sú synchronizované | Keš katalógu | Spusti manuálnu synchronizáciu alebo počkaj na webhookové aktualizácie | | `429 Too Many Requests` | Prekročený limit rýchlosti | Implementuj frontu požiadaviek s monitorovaním hlavičiek limitov | | Chýbajúce skupiny zákazníkov | V2 vs V3 API | Skupiny zákazníkov používajú V2 API; skontroluj verziu endpointu | ## Odporúčané postupy 1. **Kde je to možné, použi V3 API** - V3 API ponúka lepšie stránkovanie, filtrovanie a JSON odpovede 2. **Monitoruj hlavičky limitov rýchlosti** - Sleduj `X-Rate-Limit-Requests-Left` na vyhnutie sa dosiahnutiu limitov 3. **Registruj webhooky pre synchronizáciu v reálnom čase** - Použi webhooky namiesto pollovania pre aktualizácie zákazníkov a objednávok 4. **Dávkové aktualizácie zákazníkov** - Použi hromadné endpointy zákazníkov V3 pre veľké synchronizácie dát 5. **Zahrň varianty do synchronizácie produktov** - Synchronizuj varianty produktov pre presné sledovanie zásob 6. **Nastav webhooky opusteného košíka** - Kritické pre automatizáciu e-mailov na obnovu košíka 7. **Použi stránkovanie** - Vždy stránkuj endpointy zoznamu; max 250 záznamov na stránku ## Bezpečnosť - **Autentifikácia OAuth tokenmi** - Bezpečný API prístup na základe tokenov - **Scoped oprávnenia** - API účty obmedzené na konkrétne dátové scopy - **Iba HTTPS** - Všetka API komunikácia šifrovaná cez TLS - **Overenie webhookov** - Overuj zdroj webhookov pomocou store hash - **PCI DSS súlad** - BigCommerce bezpečne spravuje platobné dáta - **SOC 2 Type II** - Platforma BigCommerce je SOC 2 certifikovaná ## Súvisiace zdroje - [Shopify konektor](https://tajo.io/sk/docs/connectors/ecommerce/shopify) - [WooCommerce konektor](https://tajo.io/sk/docs/connectors/ecommerce/woocommerce) - [Customer Sync skill](https://tajo.io/sk/docs/skills/data-sync/customer-sync) - [Abandoned Cart skill](https://tajo.io/sk/docs/skills/email-marketing/abandoned-cart)