Σύνδεσμος BigCommerce

Σύνδεσμος BigCommerce

Συνδέστε το κατάστημα BigCommerce με το Brevo μέσω Tajo για πλήρη συγχρονισμό δεδομένων ηλεκτρονικού εμπορίου. Συγχρονίστε πελάτες, παραγγελίες, προϊόντα και εκδηλώσεις καλαθιού για τροφοδότηση στοχευμένων καμπανιών marketing, ανάκτησης εγκαταλελειμμένου καλαθιού και αυτοματοποίησης μετά-αγοράς.

Επισκόπηση

Χαρακτηριστικά

• Συγχρονισμός πελατών - Συγχρονισμός δεδομένων πελάτη σε πραγματικό χρόνο στις επαφές Brevo
• Παρακολούθηση παραγγελιών - Εκδηλώσεις κύκλου ζωής παραγγελίας για ροές marketing μετά-αγοράς
• Συγχρονισμός καταλόγου προϊόντων - Συγχρονισμός προϊόντων για συστάσεις email και δυναμικό περιεχόμενο
• Εγκατάλειψη καλαθιού - Παρακολούθηση και ανάκτηση εγκαταλελειμμένων καλαθιών με αυτοματοποιημένα emails
• Υποστήριξη πολλαπλών καταστημάτων - Σύνδεση πολλαπλών καταστημάτων BigCommerce
• Ενημερώσεις βάσει webhook - Ενημερώσεις δεδομένων σε πραγματικό χρόνο μέσω webhooks BigCommerce
• Προσαρμοσμένα πεδία - Αντιστοίχηση προσαρμοσμένων πεδίων BigCommerce σε χαρακτηριστικά επαφών Brevo
• Παρακολούθηση αποθέματος - Συγχρονισμός επιπέδων αποθέματος για ειδοποιήσεις επαναφοράς σε απόθεμα

Προαπαιτούμενα

Πριν ξεκινήσετε, βεβαιωθείτε ότι διαθέτετε:

1. Κατάστημα BigCommerce με πρόσβαση Ιδιοκτήτη Καταστήματος ή Διαχειριστή
2. Λογαριασμό API BigCommerce με κατάλληλα OAuth scopes
3. Το Store Hash σας (βρίσκεται στο URL καταστήματος ή διαπιστευτήρια API)
4. Λογαριασμό Brevo με πρόσβαση API
5. Λογαριασμό Tajo με διαπιστευτήρια API

Πιστοποίηση

Διαπιστευτήρια Λογαριασμού API

Το BigCommerce χρησιμοποιεί λογαριασμούς API βάσει OAuth. Δημιουργήστε έναν στον πίνακα ελέγχου BigCommerce στις Ρυθμίσεις > API > API Accounts.

Θα λάβετε:

• Client ID - Το αναγνωριστικό εφαρμογής σας
• Client Secret - Το μυστικό εφαρμογής σας (αποθηκεύστε με ασφάλεια)
• Access Token - Χρησιμοποιείται για πιστοποίηση API
• Store Hash - Το μοναδικό αναγνωριστικό καταστήματός σας

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"

Απαιτούμενα OAuth Scopes

Διαμόρφωση

Βασική Ρύθμιση

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

Αντιστοίχιση Πεδίων Πελάτη

Αντιστοίχηση πεδίων πελάτη BigCommerce σε χαρακτηριστικά Brevo:

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

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"

Endpoints API

Παραδείγματα Κώδικα

Αρχικοποίηση Συνδέσμου BigCommerce

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
});

Λήψη και Συγχρονισμός Πελατών

// 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

// 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');
});

Συγχρονισμός Καταλόγου Προϊόντων

// 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
// }

Όρια Ρυθμού

Πρόσθετα όρια:

Αντιμετώπιση Προβλημάτων

Βέλτιστες Πρακτικές

1. Χρησιμοποιήστε V3 API όπου είναι δυνατόν - Το V3 API προσφέρει καλύτερη σελιδοποίηση, φιλτράρισμα και αποκρίσεις JSON
2. Παρακολουθήστε headers ορίου ρυθμού - Παρακολουθήστε X-Rate-Limit-Requests-Left για αποφυγή επίτευξης ορίων
3. Εγγράψτε webhooks για συγχρονισμό σε πραγματικό χρόνο - Χρησιμοποιήστε webhooks αντί polling για ενημερώσεις πελάτη και παραγγελίας
4. Ομαδοποιήστε ενημερώσεις πελάτη - Χρησιμοποιήστε τα V3 bulk endpoints πελάτη για μεγάλους συγχρονισμούς δεδομένων
5. Συμπεριλάβετε παραλλαγές στον συγχρονισμό προϊόντων - Συγχρονίστε παραλλαγές προϊόντων για ακριβή παρακολούθηση αποθέματος
6. Ρυθμίστε webhooks εγκαταλελειμμένου καλαθιού - Κρίσιμο για αυτοματοποίηση email ανάκτησης καλαθιού
7. Χρησιμοποιήστε σελιδοποίηση - Να σελιδοποιείτε πάντα τα list endpoints· μέγ. 250 εγγραφές ανά σελίδα

Ασφάλεια

• Πιστοποίηση OAuth token - Ασφαλής πρόσβαση API βάσει token
• Δικαιώματα με εύρος - Λογαριασμοί API περιορισμένοι σε συγκεκριμένα εύρη δεδομένων
• Μόνο HTTPS - Όλη η επικοινωνία API κρυπτογραφείται μέσω TLS
• Επικύρωση webhook - Επαλήθευση πηγής webhook χρησιμοποιώντας store hash
• Συμβατό με PCI DSS - Το BigCommerce διαχειρίζεται δεδομένα πληρωμής με ασφάλεια
• SOC 2 Type II - Η πλατφόρμα BigCommerce είναι πιστοποιημένη SOC 2

Σχετικοί Πόροι

• Σύνδεσμος Shopify
• Σύνδεσμος WooCommerce
• Δεξιότητα Συγχρονισμού Πελατών
• Δεξιότητα Εγκαταλελειμμένου Καλαθιού