--- title: "BigCommerce konnektor" description: "Teljes BigCommerce integrációs útmutató ügyfelek, rendelések, termékek és áruházi adatok Brevóval való szinkronizációjához a Tajo segítségével." url: https://tajo.io/hu/docs/connectors/ecommerce/bigcommerce/ markdown: https://tajo.io/hu/docs/connectors/ecommerce/bigcommerce.md lang: hu-HU robots: noindex --- Kérj korai hozzáférést Adja meg keresztnevét és munkahelyi e-mail-címét. Küldünk egy hivatkozást, amellyel megerősítheti a Tajo-hozzáférési kérelmét. # BigCommerce konnektor Konnektor állapota: Fejlesztés alatt Készül. Még nincs ellenőrizve. | Forrásmező | Célmező | Mintaérték | | --- | --- | --- | | `record.id` | `source_id` | `record_1042` | | `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` | | `record.value` | `value` | `sample_value` | Csatlakoztasd a BigCommerce áruházadat a Brevóhoz a Tajo segítségével a teljes e-kereskedelmi adatszinkronizáláshoz. Szinkronizáld az ügyfeleket, rendeléseket, termékeket és kosár-eseményeket célzott marketingkampányok, elhagyott kosár visszaállítás és vásárlás utáni automatizálás érdekében. ## Áttekintés | Tulajdonság | Érték | | --- | --- | | **Platform** | BigCommerce | | **Kategória** | E-kereskedelem | | **Telepítés bonyolultsága** | Közepes | | **Hivatalos integráció** | Nem | | **Szinkronizált adatok** | Ügyfelek, Rendelések, Termékek, Kosarak | | **Elérhető Skillek** | 10 | ## Funkciók - **Ügyfél-szinkronizáció** – Valós idejű ügyfél-adatok szinkronizálása Brevo kapcsolatokba - **Rendelés-követés** – Rendelési életciklus-események vásárlás utáni marketing munkafolyamatokhoz - **Termékkatalógus-szinkronizáció** – Termékek szinkronizálása e-mail ajánlásokhoz és dinamikus tartalomhoz - **Kosár-elhagyás** – Elhagyott kosarak követése és visszaállítása automatizált e-mailekkel - **Több áruház támogatása** – Több BigCommerce áruház csatlakoztatása - **Webhook alapú frissítések** – Valós idejű adatfrissítések BigCommerce webhookokon keresztül - **Egyéni mezők** – BigCommerce egyéni mezők leképezése Brevo kapcsolat-attribútumokhoz - **Készletkövetés** – Készletszintek szinkronizálása visszaraksolt értesítésekhez ## Előfeltételek Mielőtt elkezdenéd, győződj meg róla, hogy rendelkezel: 1. Egy BigCommerce áruházzal Áruháztulajdonos vagy Adminisztrátor hozzáféréssel 2. Egy BigCommerce API fiókkal megfelelő OAuth hatókörökkel 3. Az áruházod hash-értékével (megtalálható az áruház URL-jében vagy az API hitelesítő adatokban) 4. Egy Brevo fiókkal API-hozzáféréssel 5. Egy Tajo fiókkal API hitelesítő adatokkal ## Hitelesítés ### API fiók hitelesítő adatok A BigCommerce OAuth alapú API fiókokat használ. Hozz létre egyet a BigCommerce vezérlőpultján a **Beállítások > API > API fiókok** menüben. A következőket kapod meg: - **Client ID** – Alkalmazásazonosítód - **Client Secret** – Alkalmazás-titkod (tárold biztonságosan) - **Access Token** – API hitelesítéshez használt - **Store Hash** – Egyedi áruház-azonosítód ```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" ``` ### Szükséges OAuth hatókörök | Hatókör | Hozzáférés | Cél | | --- | --- | --- | | `store_v2_customers` | Olvasás | Ügyféladat-szinkronizáció | | `store_v2_orders` | Olvasás | Rendelési esemény-követés | | `store_v2_products` | Olvasás | Termékkatalógus-szinkronizáció | | `store_cart` | Olvasás | Kosár-elhagyás követés | | `store_v2_information` | Olvasás | Áruház-konfiguráció | | `store_v2_content` | Olvasás | Áruházi tartalom | ## Konfiguráció ### Alapbeállítás ```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 ``` ### Ügyfél-mezőleképezés Képezd le a BigCommerce ügyfélmezőket Brevo attribútumokhoz: ```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 ``` ### Webhook konfiguráció ```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 végpontok | Módszer | Végpont | Leírás | | --- | --- | --- | | `GET` | `/v3/customers` | Ügyfelek listázása | | `POST` | `/v3/customers` | Ügyfelek létrehozása | | `PUT` | `/v3/customers` | Ügyfelek frissítése | | `GET` | `/v2/orders` | Rendelések listázása | | `GET` | `/v2/orders/{id}` | Rendelési részletek lekérése | | `GET` | `/v3/catalog/products` | Termékek listázása | | `GET` | `/v3/catalog/products/{id}` | Termék részleteinek lekérése | | `GET` | `/v3/catalog/products/{id}/variants` | Termékváltozatok listázása | | `GET` | `/v3/carts` | Kosarak listázása | | `GET` | `/v3/abandoned-carts` | Elhagyott kosarak listázása | | `POST` | `/v3/hooks` | Webhook létrehozása | | `GET` | `/v3/catalog/categories` | Kategóriák listázása | ## Kódpéldák ### A BigCommerce konnektor inicializálása ```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 }); ``` ### Ügyfelek lekérése és szinkronizálása ```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 } ``` ### Webhook események kezelése ```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'); }); ``` ### Termékkatalógus szinkronizálása ```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 // } ``` ## Ráta-korlátok | Csomag | Korlát | Részletek | | --- | --- | --- | | **Standard** | 150 kérés/30 mp | Áruházanként | | **Plus** | 300 kérés/30 mp | Áruházanként | | **Pro** | 450 kérés/30 mp | Áruházanként | | **Enterprise** | Korlátlan | Egyéni korlátok | További korlátok: | Erőforrás | Korlát | | --- | --- | | **Webhookok** | 100 áruházanként | | **Oldalanként** | Max. 250 rekord | | **Párhuzamos kérések** | Csomag-függő | Ráta-korlát fejlécek Figyeld az `X-Rate-Limit-Requests-Left` és `X-Rate-Limit-Time-Reset-Ms` fejléceket az API-használat korlátokon belül tartásához. ## Hibaelhárítás | Probléma | Ok | Megoldás | | --- | --- | --- | | `401 Unauthorized` | Érvénytelen hozzáférési token | Generáld újra az API hitelesítő adatokat a BigCommerce adminban | | `403 Forbidden` | Hiányzó OAuth hatókör | Ellenőrizd az API fiók hatóköreit és adj hozzá szükséges jogosultságokat | | Webhookok nem indulnak | Webhook korlát elérve | Ellenőrizd a webhook számát (max. 100) és távolítsd el a nem használtakat | | Hiányzó kosár-események | Áruházi szkriptek nem töltődtek be | Ellenőrizd a nyomkövetési szkriptet a BigCommerce áruházon | | Termékek nincsenek szinkronizálva | Katalógus gyorsítótár | Indíts kézi szinkronizálást vagy várj a webhook frissítésekre | | `429 Too Many Requests` | Ráta-korlát túllépve | Implementálj kérés-sorba állítást ráta-korlát fejléc figyeléssel | | Hiányzó ügyfélcsoportok | V2 vs V3 API | Az ügyfélcsoportok a V2 API-t használják; ellenőrizd a végpont verziót | ## Legjobb gyakorlatok 1. **Használd a V3 API-t ahol lehetséges** – A V3 API jobb oldalazást, szűrést és JSON válaszokat kínál 2. **Figyeld a ráta-korlát fejléceket** – Kövesd az `X-Rate-Limit-Requests-Left` értéket a korlátok elkerüléséhez 3. **Regisztrálj webhookokat valós idejű szinkronizáláshoz** – Használj webhookokat a lekérdezés helyett ügyfél- és rendelési frissítésekhez 4. **Kötegelj ügyfél-frissítéseket** – Használd a V3 tömeges ügyfél-végpontokat nagy adatszinkronizáláshoz 5. **Adj hozzá változatokat a termék-szinkronizáláshoz** – Szinkronizáld a termékváltozatokat a pontos készletkövetéshez 6. **Állíts be elhagyott kosár webhookokat** – Kritikus a kosár-visszaállítási e-mail automatizáláshoz 7. **Használj oldalazást** – Mindig lapozz a listás végpontokon; max. 250 rekord oldalanként ## Biztonság - **OAuth token hitelesítés** – Biztonságos token alapú API-hozzáférés - **Hatókörrel korlátozott jogosultságok** – Adott adathatókörökre korlátozott API fiókok - **Csak HTTPS** – Minden API kommunikáció TLS-en keresztül titkosítva - **Webhook-ellenőrzés** – Webhook forrás ellenőrzése az áruház hash segítségével - **PCI DSS megfelelőség** – A BigCommerce biztonságosan kezeli a fizetési adatokat - **SOC 2 Type II** – A BigCommerce platform SOC 2 tanúsítvánnyal rendelkezik ## Kapcsolódó források - [Shopify konnektor](https://tajo.io/hu/docs/connectors/ecommerce/shopify) - [WooCommerce konnektor](https://tajo.io/hu/docs/connectors/ecommerce/woocommerce) - [Ügyfél-szinkronizáció Skill](https://tajo.io/hu/docs/skills/data-sync/customer-sync) - [Elhagyott kosár Skill](https://tajo.io/hu/docs/skills/email-marketing/abandoned-cart)