Συνδετήρας Shopify

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

Επισκόπηση

Λειτουργίες

• Συγχρονισμός πελατών σε πραγματικό χρόνο - Τα δεδομένα πελατών συγχρονίζονται άμεσα με τις επαφές Brevo
• Παρακολούθηση παραγγελιών - Συμβάντα παραγγελιών για post-purchase flows
• Συγχρονισμός καταλόγου προϊόντων - Τα προϊόντα διαθέσιμα για recommendations
• Εγκατάλειψη καλαθιού - Παρακολούθηση και ανάκτηση εγκαταλειμμένων καλαθιών
• Συμπεριφορά περιήγησης - Παρακολούθηση page views και ενδιαφέροντος προϊόντων
• Υποστήριξη πολλαπλών καταστημάτων - Σύνδεση πολλαπλών καταστημάτων Shopify

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

Πριν ξεκινήσεις, βεβαιώσου ότι έχεις:

1. Ένα κατάστημα Shopify με admin πρόσβαση
2. Έναν λογαριασμό Brevo με πρόσβαση API
3. Έναν λογαριασμό Tajo

Εγκατάσταση

Επιλογή 1: Shopify App Store (Συνιστώμενη)

1. Επισκέψου το Tajo app στο Shopify App Store
2. Κάνε κλικ στο “Add app”
3. Παραχώρησε τα ζητούμενα δικαιώματα
4. Σύνδεσε τον λογαριασμό Brevo σου

Επιλογή 2: Χειροκίνητη Εγκατάσταση

Βήμα 1: Δημιουργία Shopify App

1. Πήγαινε στον admin του Shopify → Settings → Apps and sales channels
2. Κάνε κλικ στο “Develop apps” → “Create an app”
3. Ονόμασέ το “Tajo Integration”

Βήμα 2: Παραμετροποίηση API Scopes

Ενεργοποίησε αυτά τα scopes:

read_customers
write_customers
read_orders
read_products
read_checkouts
write_script_tags

Βήμα 3: Εγκατάσταση της Εφαρμογής

# Using Tajo CLI
tajo connectors install shopify \
  --shop-url your-store.myshopify.com \
  --api-key $SHOPIFY_API_KEY \
  --api-secret $SHOPIFY_API_SECRET

Βήμα 4: Παραμετροποίηση Webhooks

Το Tajo καταχωρεί αυτόματα αυτά τα webhooks:

Παραμετροποίηση

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

connectors:
  shopify:
    enabled: true
    shop_url: "your-store.myshopify.com"
    api_version: "2024-01"

    # Data sync options
    sync:
      customers: true
      orders: true
      products: true
      carts: true
      inventory: false  # Optional

    # List assignment
    lists:
      all_customers: 5
      buyers: 6
      abandoned_cart: 7

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

Αντιστοίχισε τα πεδία Shopify σε ιδιότητες επαφών Brevo:

Προσαρμοσμένη Αντιστοίχιση Ιδιοτήτων

field_mapping:
  # Standard fields
  email: email
  first_name: FIRSTNAME
  last_name: LASTNAME
  phone: SMS

  # E-commerce metrics
  orders_count: ORDER_COUNT
  total_spent: TOTAL_SPENT
  last_order_date: LAST_ORDER_DATE

  # Custom fields
  customer_type: CUSTOMER_TYPE
  preferred_language: LANGUAGE
  loyalty_tier: VIP_TIER

  # Computed fields
  average_order_value: AOV
  days_since_last_order: RECENCY

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

Συγχρόνισε προϊόντα για email recommendations:

sync:
  products:
    enabled: true
    include_variants: true
    include_images: true
    categories_as_tags: true

    # Filter products
    filter:
      status: active
      exclude_tags: ["hidden", "wholesale-only"]

Παρακολούθηση Αποθεμάτων

Ενεργοποίησε τον συγχρονισμό επιπέδων αποθέματος:

sync:
  inventory:
    enabled: true
    low_stock_threshold: 10
    out_of_stock_events: true

Συμβάντα

Συμβάντα Πελατών

Συμβάντα Παραγγελιών

Συμβάντα Καλαθιού

Ενεργοποιημένα Skills

Ο συνδετήρας Shopify ενεργοποιεί αυτά τα skills:

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

Αρχικοποίηση Συνδετήρα

import { TajoClient } from '@tajo/sdk';

const tajo = new TajoClient({
  apiKey: process.env.TAJO_API_KEY,
  brevoApiKey: process.env.BREVO_API_KEY
});

// Connect Shopify store
await tajo.connectors.connect('shopify', {
  shopUrl: 'your-store.myshopify.com',
  apiKey: process.env.SHOPIFY_API_KEY,
  apiSecret: process.env.SHOPIFY_API_SECRET
});

Εκτέλεση Αρχικού Συγχρονισμού

// Full historical sync
await tajo.connectors.sync('shopify', {
  type: 'full',
  resources: ['customers', 'orders', 'products'],
  since: '2023-01-01'
});

// Check sync status
const status = await tajo.connectors.status('shopify');
console.log(status);
// {
//   connected: true,
//   lastSync: '2024-01-15T10:30:00Z',
//   customersCount: 15420,
//   ordersCount: 8234,
//   productsCount: 342
// }

Παρακολούθηση Συμβάντων Καλαθιού

Πρόσθεσε το script Tajo στο theme Shopify σου:

<!-- Add to theme.liquid before </head> -->
{% if customer %}
<script>
  window.tajoConfig = {
    customerId: "{{ customer.id }}",
    customerEmail: "{{ customer.email }}",
    customerName: "{{ customer.first_name }}"
  };
</script>
{% endif %}
<script src="https://cdn.example.com/shopify.js"></script>

Προσαρμοσμένος Webhook Handler

// Handle Shopify webhooks manually
app.post('/webhooks/shopify', async (req, res) => {
  const hmac = req.get('X-Shopify-Hmac-SHA256');

  // Verify webhook signature
  if (!verifyShopifyWebhook(req.body, hmac)) {
    return res.status(401).send('Unauthorized');
  }

  const topic = req.get('X-Shopify-Topic');

  // Forward to Tajo
  await tajo.connectors.handleWebhook('shopify', {
    topic,
    payload: req.body
  });

  res.status(200).send('OK');
});

Παρακολούθηση

Μετρικές Dashboard

Παρακολούθησε τη σύνδεση Shopify στο dashboard Tajo:

• Κατάσταση Συγχρονισμού: Υγεία σύνδεσης πραγματικού χρόνου
• Συγχρονισμένοι Πελάτες: Συνολικές επαφές από το Shopify
• Παρακολουθούμενες Παραγγελίες: Επεξεργασμένα συμβάντα παραγγελιών
• Ανάκτηση Καλαθιού: Απόδοση εγκαταλειμμένου καλαθιού
• Ρυθμός Σφαλμάτων: Αποτυχημένες προσπάθειες συγχρονισμού

Logs Webhook

Δες την κατάσταση παράδοσης webhook:

tajo connectors logs shopify --type webhook --last 24h

Ιστορικό Συγχρονισμού

Έλεγξε ιστορικές λειτουργίες συγχρονισμού:

tajo connectors history shopify --limit 10

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

Συνήθη Προβλήματα

Λειτουργία Debug

Ενεργοποίησε verbose logging:

connectors:
  shopify:
    debug: true
    log_level: verbose
    log_webhooks: true

Έλεγχος Σύνδεσης

tajo connectors test shopify
# ✓ API connection successful
# ✓ Webhooks registered
# ✓ Products accessible
# ✓ Customers readable
# ✓ Orders readable

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

1. Ξεκίνα με δοκιμαστικό κατάστημα - Χρησιμοποίησε πρώτα ένα development store
2. Εκτέλεσε αρχικό συγχρονισμό εκτός ωρών αιχμής - Οι μεγάλοι συγχρονισμοί μπορεί να είναι αργοί
3. Αντιστοίχισε custom attributes - Μην βασίζεσαι μόνο στις default αντιστοιχίσεις
4. Ενεργοποίησε cart tracking - Κρίσιμο για την ανάκτηση εγκαταλειμμένου καλαθιού
5. Παρακολούθησε την υγεία webhook - Ρύθμισε alerts για αποτυχημένες παραδόσεις
6. Χρησιμοποίησε batch imports - Για ιστορικά δεδομένα άνω των 10.000 εγγραφών

Ασφάλεια

• OAuth 2.0 - Ασφαλής έλεγχος ταυτότητας βάσει token
• Επαλήθευση webhook - Επικύρωση υπογραφής HMAC
• Κρυπτογραφημένη αποθήκευση - Διαπιστευτήρια API κρυπτογραφημένα σε ηρεμία
• Περιορισμένη πρόσβαση - Μόνο τα ελάχιστα απαιτούμενα δικαιώματα

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

• Συνδετήρας WooCommerce
• Customer Sync Skill
• Abandoned Cart Skill
• Brevo Contacts API