---
title: "Συνδετήρας Shopify"
description: "Πλήρης οδηγός ενσωμάτωσης Shopify για συγχρονισμό πελατών, παραγγελιών, προϊόντων και συμβάντων καλαθιού με το Brevo."
url: https://tajo.io/gr/docs/connectors/ecommerce/shopify/
markdown: https://tajo.io/gr/docs/connectors/ecommerce/shopify.md
lang: el-GR
robots: noindex
---

Ζητήστε πρώιμη πρόσβαση

Συμπληρώστε το μικρό σας όνομα και την επαγγελματική διεύθυνση email. Θα σας στείλουμε σύνδεσμο για να επιβεβαιώσετε το αίτημα πρόσβασης στο Tajo.

# Συνδετήρας Shopify

Κατάσταση συνδέσμου: Σε εξέλιξη Υπό κατασκευή. Δεν έχει επαληθευτεί ακόμη.

| Πεδίο πηγής | Πεδίο προορισμού | Ενδεικτική τιμή |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

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

## Επισκόπηση

| Ιδιότητα | Τιμή |
| --- | --- |
| **Πλατφόρμα** | Shopify |
| **Κατηγορία** | E-commerce |
| **Πολυπλοκότητα Εγκατάστασης** | Εύκολη |
| **Επίσημη Ενσωμάτωση** | Όχι |
| **Συγχρονισμένα Δεδομένα** | Πελάτες, Παραγγελίες, Προϊόντα, Καλάθια, Συμβάντα |
| **Διαθέσιμα Skills** | 12 |

## Λειτουργίες

- **Συγχρονισμός πελατών σε πραγματικό χρόνο** - Τα δεδομένα πελατών συγχρονίζονται άμεσα με τις επαφές 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](https://apps.shopify.com/tajo)
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: Εγκατάσταση της Εφαρμογής

```bash
# 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:

| Webhook | Σκοπός |
| --- | --- |
| `customers/create` | Συγχρονισμός νέου πελάτη |
| `customers/update` | Αλλαγές δεδομένων πελάτη |
| `customers/delete` | Αφαίρεση πελάτη |
| `orders/create` | Συμβάντα τοποθέτησης παραγγελίας |
| `orders/updated` | Αλλαγές κατάστασης παραγγελίας |
| `checkouts/create` | Δημιουργία καλαθιού |
| `checkouts/update` | Ενημέρωση καλαθιού |

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

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

```yaml
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:

#### Default Mappings

| Parameter | Type | Description |
| --- | --- | --- |
| `email` required | string | Email πελάτη (μοναδικό αναγνωριστικό) |
| `first_name` optional | string | Αντιστοιχεί στην ιδιότητα FIRSTNAME |
| `last_name` optional | string | Αντιστοιχεί στην ιδιότητα LASTNAME |
| `phone` optional | string | Αντιστοιχεί στην ιδιότητα SMS για WhatsApp/SMS |
| `accepts_marketing` optional | boolean | Ελέγχει την κατάσταση εγγραφής |
| `orders_count` optional | integer | Συνολικός αριθμός παραγγελιών |
| `total_spent` optional | number | Αξία πελάτη σε όλη τη διάρκεια ζωής |
| `tags` optional | array | Tags πελάτη από το Shopify |

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

```yaml
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:

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

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

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

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

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

## Συμβάντα

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

| Συμβάν | Έναυσμα | Περίπτωση Χρήσης |
| --- | --- | --- |
| `customer_created` | Εγγραφή νέου πελάτη | Welcome series |
| `customer_updated` | Αλλαγές προφίλ | Συγχρονισμός δεδομένων |
| `customer_tags_added` | Ανάθεση tags | Ενημερώσεις segment |

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

| Συμβάν | Έναυσμα | Περίπτωση Χρήσης |
| --- | --- | --- |
| `order_placed` | Ολοκλήρωση checkout | Επιβεβαίωση παραγγελίας |
| `order_fulfilled` | Αποστολή παραγγελίας | Ειδοποίηση αποστολής |
| `order_cancelled` | Ακύρωση παραγγελίας | Email ακύρωσης |
| `order_refunded` | Επεξεργασία επιστροφής χρημάτων | Επιβεβαίωση επιστροφής |

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

| Συμβάν | Έναυσμα | Περίπτωση Χρήσης |
| --- | --- | --- |
| `cart_created` | Προσθήκη items στο καλάθι | Browse tracking |
| `cart_updated` | Τροποποίηση καλαθιού | Παρακολούθηση αξίας καλαθιού |
| `cart_abandoned` | Κανένα checkout σε 30 λεπτά | Emails ανάκτησης |

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

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

| Skill | Περιγραφή |
| --- | --- |
| [Customer Sync](https://tajo.io/gr/docs/skills/data-sync/customer-sync) | Συγχρονισμός πελατών σε πραγματικό χρόνο |
| Order Events | Παρακολούθηση κύκλου ζωής παραγγελίας |
| [Abandoned Cart](https://tajo.io/gr/docs/skills/email-marketing/abandoned-cart) | Emails ανάκτησης καλαθιού |
| Welcome Series | Onboarding νέου πελάτη |
| Post-Purchase | Follow-up παραγγελίας |
| Win-Back | Επανεμπλοκή ανενεργών πελατών |
| Browse Abandonment | Follow-up ενδιαφέροντος προϊόντος |
| Replenishment | Υπενθυμίσεις επαναπαραγγελίας |

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

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

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

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

```javascript
// 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 σου:

```liquid
<!-- 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>
```

Caution

Η διεύθυνση `example.com` παραπάνω είναι ενδεικτική έως ότου το endpoint του Tajo γίνει διαθέσιμο.

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

```javascript
// 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:

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

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

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

```bash
tajo connectors history shopify --limit 10
```

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

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

Όρια API Rate

Το Shopify έχει όρια API rate 2 αιτημάτων/δευτερόλεπτο. Χρησιμοποίησε batch sync για μεγάλες ιστορικές εισαγωγές.

| Πρόβλημα | Αιτία | Λύση |
| --- | --- | --- |
| Δεν λήφθηκε webhook | Δικαιώματα εφαρμογής | Επανεγκατέστησε την εφαρμογή με σωστά scopes |
| Ο πελάτης δεν συγχρονίστηκε | Λείπει email | Το Shopify απαιτεί email για πελάτες |
| Λείπουν προϊόντα | Κατάσταση προϊόντος | Έλεγξε ότι το προϊόν είναι σε κατάσταση “active” |
| Το καλάθι δεν παρακολουθείται | Το script δεν φορτώθηκε | Επαλήθευσε το script στο theme.liquid |

### Λειτουργία Debug

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

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

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

```bash
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](https://tajo.io/gr/docs/connectors/ecommerce/woocommerce)
- [Customer Sync Skill](https://tajo.io/gr/docs/skills/data-sync/customer-sync)
- [Abandoned Cart Skill](https://tajo.io/gr/docs/skills/email-marketing/abandoned-cart)
- [Brevo Contacts API](https://tajo.io/gr/docs/contact-management)