On this page

Guida all'Integrazione BigCommerce

Questa guida ti accompagna nell’integrazione di Tajo con il tuo negozio BigCommerce per sbloccare le funzionalità di coinvolgimento dei clienti, programmi fedeltà e automazione del marketing.

Panoramica

L’integrazione Tajo-BigCommerce ti consente di:

Sincronizzare i dati dei clienti automaticamente dal tuo negozio BigCommerce
Tracciare ordini e prodotti per il marketing personalizzato
Gestire programmi fedeltà con punti, livelli e premi
Automatizzare le campagne di marketing tramite Brevo (email, SMS, WhatsApp)
Segmentare i clienti per comportamento di acquisto e coinvolgimento
Supportare operazioni multi-storefront

Prerequisiti

Prima di avviare l’integrazione, assicurati di avere:

Negozio BigCommerce su qualsiasi piano (Standard, Plus, Pro o Enterprise)
Account Tajo con un abbonamento attivo
Account Brevo (opzionale, per l’automazione del marketing)
Credenziali API del negozio (account API con gli scope appropriati)

Passo 1: Installa l’App Tajo

Da BigCommerce App Marketplace

Vai al pannello di controllo BigCommerce
Naviga su App → Marketplace
Cerca “Tajo”
Fai clic su Ottieni questa app
Esamina le autorizzazioni e fai clic su Installa
Segui la procedura guidata per connettere il tuo account Tajo

Passo 2: Configura le Credenziali API

{
  "bigcommerce": {
    "store_hash": "your_store_hash",
    "client_id": "your_client_id",
    "access_token": "your_access_token",
    "api_url": "https://api.bigcommerce.com/stores/your_store_hash/v3"
  },
  "tajo": {
    "api_key": "your_tajo_api_key"
  },
  "brevo": {
    "api_key": "your_brevo_api_key"
  }
}

Passo 3: Sincronizzazione Dati

Sincronizzazione Clienti

// Webhook per nuovi clienti BigCommerce
app.post('/webhooks/bigcommerce/customer/created', async (req, res) => {
  const customer = req.body.data;

  await syncCustomerToBrevo({
    email: customer.email,
    firstName: customer.first_name,
    lastName: customer.last_name,
    phone: customer.phone,
    loyaltyTier: 'Bronze',
    loyaltyPoints: 0
  });

  res.status(200).json({ success: true });
});

Sincronizzazione Ordini

// Webhook per ordini completati BigCommerce
app.post('/webhooks/bigcommerce/store/order/statusUpdated', async (req, res) => {
  const order = req.body.data;

  if (order.status === 'Completed') {
    await syncOrderToBrevo(order);
    await calculateAndAwardLoyaltyPoints(order);
  }

  res.status(200).json({ success: true });
});

Passo 4: Supporto Multi-Storefront

{
  "storefronts": [
    {
      "id": "store_1",
      "name": "Negozio Principale",
      "channel_id": 1,
      "brevo_list_id": 1,
      "loyalty_multiplier": 1.0
    },
    {
      "id": "store_2",
      "name": "Negozio Premium",
      "channel_id": 2,
      "brevo_list_id": 2,
      "loyalty_multiplier": 1.5
    }
  ]
}