--- title: "BigCommerce-kobling" description: "Fullstendig BigCommerce-integrasjonsveiledning for synkronisering av kunder, ordrer, produkter og butikkdata med Brevo via Tajo." url: https://tajo.io/no/docs/connectors/ecommerce/bigcommerce/ markdown: https://tajo.io/no/docs/connectors/ecommerce/bigcommerce.md lang: no-NO robots: noindex --- Be om tidlig tilgang Skriv inn fornavn og e-postadresse på jobb. Vi sender deg en lenke for å bekrefte forespørselen om tilgang til Tajo. # BigCommerce-kobling Koblingsstatus: Under utvikling Under bygging. Ikke verifisert ennå. | Kildefelt | Målfelt | Eksempelverdi | | --- | --- | --- | | `record.id` | `source_id` | `record_1042` | | `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` | | `record.value` | `value` | `sample_value` | Koble BigCommerce-butikken din til Brevo via Tajo for fullstendig synkronisering av e-handelsdata. Synkroniser kunder, ordrer, produkter og handlekurvhendelser for å drive målrettede markedsføringskampanjer, gjenoppretting av forlatte handlekurver og automatisering etter kjøp. ## Oversikt | Egenskap | Verdi | | --- | --- | | **Plattform** | BigCommerce | | **Kategori** | E-handel | | **Oppsettskompleksitet** | Middels | | **Offisiell integrasjon** | Nei | | **Synkroniserte data** | Kunder, ordrer, produkter, handlekurver | | **Tilgjengelige ferdigheter** | 10 | ## Funksjoner - **Kundesynkronisering** - Sanntidssynkronisering av kundedata til Brevo-kontakter - **Ordresporing** - Hendelser i ordrelivssyklus for markedsføringsflyter etter kjøp - **Produktkatalogsynkronisering** - Synkroniser produkter for e-postanbefalinger og dynamisk innhold - **Forlatt handlekurv** - Spor og gjenopprett forlatte handlekurver med automatiserte e-poster - **Støtte for flere butikker** - Koble til flere BigCommerce-butikker - **Webhook-drevne oppdateringer** - Sanntidsoppdatering av data via BigCommerce webhooks - **Egendefinerte felt** - Mapp BigCommerce egendefinerte felt til Brevo-kontaktattributter - **Lagersporing** - Synkroniser lagernivåer for varsler om ny tilgjengelighet ## Forutsetninger Før du begynner, sørg for at du har: 1. En BigCommerce-butikk med Store Owner- eller Admin-tilgang 2. En BigCommerce API-konto med passende OAuth-scopes 3. Butikk-hashen din (finnes i butikk-URL-en eller API-legitimasjonen) 4. En Brevo-konto med API-tilgang 5. En Tajo-konto med API-legitimasjon ## Autentisering ### API-kontolegitimasjon BigCommerce bruker OAuth-baserte API-kontoer. Opprett en i BigCommerce-kontrollpanelet under **Settings > API > API Accounts**. Du vil motta: - **Client ID** - App-identifikatoren din - **Client Secret** - App-hemmeligheten din (lagres sikkert) - **Access Token** - Brukes til API-autentisering - **Store Hash** - Din unike butikkidentifikator ```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" ``` ### Påkrevde OAuth-scopes | Scope | Tilgang | Formål | | --- | --- | --- | | `store_v2_customers` | Les | Synkronisering av kundedata | | `store_v2_orders` | Les | Sporing av ordrehendelser | | `store_v2_products` | Les | Synkronisering av produktkatalog | | `store_cart` | Les | Sporing av forlatte handlekurver | | `store_v2_information` | Les | Butikkonfigurasjon | | `store_v2_content` | Les | Butikkinnhold | ## Konfigurasjon ### Grunnleggende oppsett ```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 ``` ### Mapping av kundefelt Mapp BigCommerce-kundefelt til Brevo-attributter: ```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-konfigurasjon ```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-endepunkter | Metode | Endepunkt | Beskrivelse | | --- | --- | --- | | `GET` | `/v3/customers` | List kunder | | `POST` | `/v3/customers` | Opprett kunder | | `PUT` | `/v3/customers` | Oppdater kunder | | `GET` | `/v2/orders` | List ordrer | | `GET` | `/v2/orders/{id}` | Hent ordredetaljer | | `GET` | `/v3/catalog/products` | List produkter | | `GET` | `/v3/catalog/products/{id}` | Hent produktdetaljer | | `GET` | `/v3/catalog/products/{id}/variants` | List produktvarianter | | `GET` | `/v3/carts` | List handlekurver | | `GET` | `/v3/abandoned-carts` | List forlatte handlekurver | | `POST` | `/v3/hooks` | Opprett en webhook | | `GET` | `/v3/catalog/categories` | List kategorier | ## Kodeeksempler ### Initialiser BigCommerce-kobling ```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 }); ``` ### Hent og synkroniser kunder ```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 } ``` ### Håndter webhook-hendelser ```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'); }); ``` ### Synkroniser produktkatalog ```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 // } ``` ## Hastighetsgrenser | Plan | Grense | Detaljer | | --- | --- | --- | | **Standard** | 150 forespørsler/30 sek | Per butikk | | **Plus** | 300 forespørsler/30 sek | Per butikk | | **Pro** | 450 forespørsler/30 sek | Per butikk | | **Enterprise** | Ubegrenset | Tilpassede grenser | Ytterligere grenser: | Ressurs | Grense | | --- | --- | | **Webhooks** | 100 per butikk | | **Per side** | Maks 250 poster | | **Samtidige forespørsler** | Avhenger av plan | Hoder for hastighetsgrenser Overvåk `X-Rate-Limit-Requests-Left` og `X-Rate-Limit-Time-Reset-Ms` headere for å holde API-bruken innenfor grensene. ## Feilsøking | Problem | Årsak | Løsning | | --- | --- | --- | | `401 Unauthorized` | Ugyldig access token | Generer API-legitimasjon på nytt i BigCommerce-admin | | `403 Forbidden` | Manglende OAuth-scope | Sjekk API-kontoens scopes og legg til påkrevde tillatelser | | Webhooks ikke utløst | Webhook-grense nådd | Sjekk antall webhooks (maks 100) og fjern ubrukte | | Handlekurvhendelser mangler | Butikkskript ikke lastet | Bekreft sporingsskriptet på BigCommerce-butikken | | Produkter ute av synk | Katalogcache | Utløs en manuell synkronisering eller vent på webhook-oppdateringer | | `429 Too Many Requests` | Hastighetsgrense overskredet | Implementer kø for forespørsler med overvåking av hastighetsgrensehoder | | Kundegrupper mangler | V2 vs V3 API | Kundegrupper bruker V2 API; sjekk endepunktets versjon | ## Beste praksis 1. **Bruk V3 API der det er mulig** - V3 API tilbyr bedre paginering, filtrering og JSON-svar 2. **Overvåk hoder for hastighetsgrenser** - Spor `X-Rate-Limit-Requests-Left` for å unngå å nå grenser 3. **Registrer webhooks for sanntidssynkronisering** - Bruk webhooks i stedet for polling for kunde- og ordreoppdateringer 4. **Batch-oppdater kunder** - Bruk V3 bulk customer-endepunkter for store datasynkroniseringer 5. **Inkluder varianter i produktsynkronisering** - Synkroniser produktvarianter for nøyaktig lagersporing 6. **Sett opp webhooks for forlatt handlekurv** - Kritisk for automatisering av gjenopprettingse-poster 7. **Bruk paginering** - Paginer alltid liste-endepunkter; maks 250 poster per side ## Sikkerhet - **OAuth-tokenautentisering** - Sikker tokenbasert API-tilgang - **Scopede tillatelser** - API-kontoer begrenset til spesifikke data-scopes - **Kun HTTPS** - All API-kommunikasjon kryptert via TLS - **Webhook-verifisering** - Verifiser webhook-kilde med butikk-hash - **PCI DSS-kompatibel** - BigCommerce håndterer betalingsdata sikkert - **SOC 2 Type II** - BigCommerce-plattformen er SOC 2-sertifisert ## Relaterte ressurser - [Shopify-kobling](https://tajo.io/no/docs/connectors/ecommerce/shopify) - [WooCommerce-kobling](https://tajo.io/no/docs/connectors/ecommerce/woocommerce) - [Kundesynkronisering-ferdighet](https://tajo.io/no/docs/skills/data-sync/customer-sync) - [Forlatt handlekurv-ferdighet](https://tajo.io/no/docs/skills/email-marketing/abandoned-cart)