--- title: "Konektor BigCommerce" description: "Kompletní průvodce integrací BigCommerce pro synchronizaci zákazníků, objednávek, produktů a dat storefrontu s Brevo přes Tajo." url: https://tajo.io/cz/docs/connectors/ecommerce/bigcommerce/ markdown: https://tajo.io/cz/docs/connectors/ecommerce/bigcommerce.md lang: cs-CZ 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. # Konektor BigCommerce Stav konektoru: Ve vývoji Vzniká. Zatím neověřeno. | Zdrojové pole | Cílové pole | Ukázková hodnota | | --- | --- | --- | | `record.id` | `source_id` | `record_1042` | | `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` | | `record.value` | `value` | `sample_value` | Propoj svůj BigCommerce obchod s Brevo přes Tajo pro kompletní synchronizaci e-commerce dat. Synchronizuj zákazníky, objednávky, produkty a události košíku pro cílené marketingové kampaně, obnovu opuštěných košíků a post-purchase automatizaci. ## Přehled | Vlastnost | Hodnota | | --- | --- | | **Platforma** | BigCommerce | | **Kategorie** | E-commerce | | **Složitost nastavení** | Střední | | **Oficiální integrace** | Ne | | **Synchronizovaná data** | Zákazníci, Objednávky, Produkty, Košíky | | **Dostupné skilly** | 10 | ## Funkce - **Synchronizace zákazníků** - Real-time synchronizace zákaznických dat do kontaktů Brevo - **Sledování objednávek** - Události životního cyklu objednávky pro post-purchase marketing flow - **Synchronizace katalogu produktů** - Synchronizace produktů pro doporučení v emailech a dynamický obsah - **Opuštěné košíky** - Sledování a obnova opuštěných košíků automatizovanými emaily - **Podpora multi-storefrontu** - Připojení více BigCommerce storefrontů - **Aktualizace přes webhooky** - Real-time aktualizace dat přes BigCommerce webhooky - **Vlastní pole** - Mapování vlastních BigCommerce polí na atributy kontaktů Brevo - **Sledování inventáře** - Synchronizace stavu skladu pro notifikace o naskladnění ## Předpoklady Než začneš, ujisti se, že máš: 1. BigCommerce obchod s přístupem Store Owner nebo Admin 2. BigCommerce API účet s odpovídajícími OAuth rozsahy 3. Svůj Store Hash (najdeš ho v URL obchodu nebo v API přihlašovacích údajích) 4. Brevo účet s API přístupem 5. Tajo účet s API přihlašovacími údaji ## Autentizace ### Přihlašovací údaje API účtu BigCommerce používá OAuth API účty. Vytvoř jej v ovládacím panelu BigCommerce pod **Settings > API > API Accounts**. Dostaneš: - **Client ID** - Identifikátor tvé aplikace - **Client Secret** - Secret tvé aplikace (ulož bezpečně) - **Access Token** - Slouží k API autentizaci - **Store Hash** - Unikátní identifikátor tvého 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" ``` ### Vyžadované OAuth rozsahy | Rozsah | Přístup | Účel | | --- | --- | --- | | `store_v2_customers` | Read | Synchronizace dat zákazníků | | `store_v2_orders` | Read | Sledování událostí objednávek | | `store_v2_products` | Read | Synchronizace katalogu produktů | | `store_cart` | Read | Sledování opuštěných košíků | | `store_v2_information` | Read | Konfigurace obchodu | | `store_v2_content` | Read | Obsah storefrontu | ## Konfigurace ### Základní nastavení ```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 ``` ### Mapování polí zákazníků Namapuj BigCommerce pole zákazníků na atributy 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 ``` ### Konfigurace webhooků ```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 | Metoda | Endpoint | Popis | | --- | --- | --- | | `GET` | `/v3/customers` | Seznam zákazníků | | `POST` | `/v3/customers` | Vytvoření zákazníků | | `PUT` | `/v3/customers` | Aktualizace zákazníků | | `GET` | `/v2/orders` | Seznam objednávek | | `GET` | `/v2/orders/{id}` | Detail objednávky | | `GET` | `/v3/catalog/products` | Seznam produktů | | `GET` | `/v3/catalog/products/{id}` | Detail produktu | | `GET` | `/v3/catalog/products/{id}/variants` | Seznam variant produktu | | `GET` | `/v3/carts` | Seznam košíků | | `GET` | `/v3/abandoned-carts` | Seznam opuštěných košíků | | `POST` | `/v3/hooks` | Vytvoření webhooku | | `GET` | `/v3/catalog/categories` | Seznam kategorií | ## Příklady kódu ### Inicializace konektoru BigCommerce ```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čtení a synchronizace zákazníků ```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 } ``` ### Zpracování událostí webhooku ```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'); }); ``` ### Synchronizace katalogu produktů ```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 // } ``` ## Rate limity | Plán | Limit | Detaily | | --- | --- | --- | | **Standard** | 150 requestů/30 s | Na obchod | | **Plus** | 300 requestů/30 s | Na obchod | | **Pro** | 450 requestů/30 s | Na obchod | | **Enterprise** | Neomezeno | Vlastní limity | Další limity: | Prostředek | Limit | | --- | --- | | **Webhooky** | 100 na obchod | | **Na stránku** | Max 250 záznamů | | **Souběžné requesty** | Závisí na plánu | Hlavičky rate limitu Sleduj hlavičky `X-Rate-Limit-Requests-Left` a `X-Rate-Limit-Time-Reset-Ms` pro správu využití API v rámci limitů. ## Řešení problémů | Problém | Příčina | Řešení | | --- | --- | --- | | `401 Unauthorized` | Neplatný access token | Znovu vygeneruj API přihlašovací údaje v BigCommerce adminu | | `403 Forbidden` | Chybí OAuth rozsah | Zkontroluj rozsahy API účtu a přidej vyžadovaná oprávnění | | Webhooky nestřílí | Limit webhooků dosažen | Zkontroluj počet webhooků (max 100) a odeber nepoužívané | | Chybí události košíku | Storefront skripty nenahrány | Ověř sledovací skript na BigCommerce storefrontu | | Produkty nesynchronizované | Cache katalogu | Spusť manuální synchronizaci nebo počkej na aktualizace webhooku | | `429 Too Many Requests` | Překročen rate limit | Implementuj frontu requestů se sledováním hlaviček rate limitu | | Chybí zákaznické skupiny | V2 vs V3 API | Zákaznické skupiny používají V2 API; zkontroluj verzi endpointu | ## Best practices 1. **Kde je to možné, používej V3 API** - V3 API nabízí lepší stránkování, filtrování a JSON odpovědi 2. **Sleduj hlavičky rate limitu** - Sleduj `X-Rate-Limit-Requests-Left`, abys se vyhnul limitům 3. **Registruj webhooky pro real-time synchronizaci** - Pro aktualizace zákazníků a objednávek použij webhooky místo pollování 4. **Dávkové aktualizace zákazníků** - Pro velké synchronizace dat použij V3 bulk customer endpointy 5. **Zahrň varianty do synchronizace produktů** - Synchronizuj varianty produktů pro přesné sledování inventáře 6. **Nastav webhooky pro opuštěné košíky** - Klíčové pro automatizaci emailů na obnovu košíku 7. **Používej stránkování** - Vždy stránkuj list endpointy; max 250 záznamů na stránku ## Bezpečnost - **OAuth token autentizace** - Bezpečný API přístup přes tokeny - **Rozsahová oprávnění** - API účty omezené na konkrétní datové rozsahy - **Pouze HTTPS** - Veškerá API komunikace šifrovaná přes TLS - **Ověření webhooků** - Ověření zdroje webhooku pomocí store hash - **PCI DSS compliant** - BigCommerce bezpečně zpracovává platební data - **SOC 2 Type II** - BigCommerce platforma je SOC 2 certifikovaná ## Související zdroje - [Konektor Shopify](https://tajo.io/cz/docs/connectors/ecommerce/shopify) - [Konektor WooCommerce](https://tajo.io/cz/docs/connectors/ecommerce/woocommerce) - [Skill Customer Sync](https://tajo.io/cz/docs/skills/data-sync/customer-sync) - [Skill Abandoned Cart](https://tajo.io/cz/docs/skills/email-marketing/abandoned-cart)