---
title: "Σύνδεσμος Klaviyo"
description: "Πλήρης οδηγός ενσωμάτωσης Klaviyo για συγχρονισμό προφίλ, εκδηλώσεων, λιστών, τμημάτων και δεδομένων καμπάνιας με το Brevo μέσω Tajo."
url: https://tajo.io/gr/docs/connectors/marketing/klaviyo/
markdown: https://tajo.io/gr/docs/connectors/marketing/klaviyo.md
lang: el-GR
robots: noindex
---

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

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

# Σύνδεσμος Klaviyo

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

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

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

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

| Ιδιότητα | Τιμή |
| --- | --- |
| **Πλατφόρμα** | Klaviyo |
| **Κατηγορία** | Marketing |
| **Πολυπλοκότητα Ρύθμισης** | Μέτρια |
| **Επίσημη Ενσωμάτωση** | Όχι |
| **Δεδομένα που Συγχρονίζονται** | Προφίλ, Εκδηλώσεις, Λίστες, Τμήματα, Καμπάνιες |
| **Διαθέσιμες Δεξιότητες** | 10 |
| **Πρότυπο API** | JSON:API |

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

- **Συγχρονισμός προφίλ** - Αμφίδρομος συγχρονισμός προφίλ πελατών μεταξύ Klaviyo και Brevo
- **Προώθηση εκδηλώσεων** - Προώθηση παρακολουθούμενων εκδηλώσεων Klaviyo στο Brevo για triggers αυτοματισμού
- **Μετεγκατάσταση λιστών** - Συγχρονισμός λιστών Klaviyo σε λίστες επαφών Brevo
- **Συγχρονισμός τμήματος** - Εξαγωγή τμημάτων Klaviyo ως λίστες ή τμήματα Brevo
- **Εξαγωγή δεδομένων ροής** - Ανάκτηση δεδομένων απόδοσης ροής για διαπλατφορμικά αναλυτικά
- **Συγχρονισμός καμπάνιας** - Συντονισμός καμπανιών σε κανάλια Klaviyo και Brevo
- **Συγχρονισμός καταλόγου** - Αντικατοπτρισμός καταλόγων προϊόντων μεταξύ πλατφόρμων
- **Διαχείριση κουπονιών** - Συγχρονισμός κωδικών κουπονιών και δεδομένων χρήσης

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

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

1. Λογαριασμό Klaviyo με ενεργοποιημένη πρόσβαση API
2. Ιδιωτικό κλειδί API με κατάλληλα εύρη
3. Το δημόσιο κλειδί API Klaviyo σας (6-χαρακτήρες company ID)
4. Λογαριασμό Brevo με πρόσβαση API
5. Λογαριασμό Tajo με διαπιστευτήρια API

## Πιστοποίηση

### Ιδιωτικό Κλειδί API

Το Klaviyo χρησιμοποιεί ιδιωτικά κλειδιά API με εύρος πρόσβασης για πιστοποίηση πλευράς server. Ορίστε το κλειδί στην κεφαλίδα `Authorization`:

```bash
curl https://a.klaviyo.com/api/profiles/ \
  -H "Authorization: Klaviyo-API-Key your-private-api-key" \
  -H "revision: 2026-01-15"
```

### Εύρη Κλειδιού API

Ρυθμίστε εύρη κατά τη δημιουργία του ιδιωτικού κλειδιού σας:

| Εύρος | Πρόσβαση | Περιγραφή |
| --- | --- | --- |
| `profiles` | Read/Full | Πρόσβαση σε προφίλ επαφών |
| `events` | Read/Full | Πρόσβαση σε παρακολουθούμενες εκδηλώσεις |
| `lists` | Read/Full | Πρόσβαση σε λίστες επαφών |
| `segments` | Read | Πρόσβαση σε τμήματα |
| `campaigns` | Read | Πρόσβαση σε δεδομένα καμπάνιας |
| `metrics` | Read | Πρόσβαση σε ορισμούς μετρικών |
| `flows` | Read | Πρόσβαση σε διαμορφώσεις ροής |
| `catalogs` | Read | Πρόσβαση σε καταλόγους προϊόντων |

### Δημόσιο Κλειδί API

Για παρακολούθηση πλευράς client, χρησιμοποιήστε το 6-χαρακτήρα company ID:

```bash
curl -X POST "https://a.klaviyo.com/client/events/?company_id=COMPANY_ID" \
  -H "Content-Type: application/json" \
  -d '{"data": {...}}'
```

### OAuth (Ενσωματώσεις Συνεργατών)

Το Klaviyo υποστηρίζει OAuth για τεχνολογικούς συνεργάτες, προσφέροντας βελτιωμένη ασφάλεια και υψηλότερα όρια ρυθμού:

```bash
curl https://a.klaviyo.com/api/profiles/ \
  -H "Authorization: Bearer YOUR_OAUTH_TOKEN" \
  -H "revision: 2026-01-15"
```

## Διαμόρφωση

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

```yaml
connectors:
  klaviyo:
    enabled: true
    private_api_key: "your-klaviyo-private-key"
    public_api_key: "XXXXXX"
    api_revision: "2026-01-15"

    # Data sync options
    sync:
      profiles: true
      events: true
      lists: true
      segments: true
      catalogs: false

    # Brevo list assignment
    lists:
      all_contacts: 20
      subscribers: 21
      high_value: 22
```

### Αντιστοίχιση Προφίλ

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

```yaml
profile_mapping:
  email: email
  first_name: FIRSTNAME
  last_name: LASTNAME
  phone_number: SMS
  city: CITY
  region: REGION
  country: COUNTRY
  zip: ZIP
  organization: COMPANY
  title: JOB_TITLE

  # Custom properties
  lifetime_value: LTV
  total_orders: ORDER_COUNT
  last_order_date: LAST_ORDER_DATE
  preferred_channel: CHANNEL_PREF
```

### Αντιστοίχιση Εκδηλώσεων

Αντιστοίχηση μετρικών Klaviyo σε εκδηλώσεις Brevo:

```yaml
event_mapping:
  "Placed Order": "order_completed"
  "Ordered Product": "product_purchased"
  "Started Checkout": "checkout_started"
  "Added to Cart": "cart_updated"
  "Viewed Product": "product_viewed"
  "Subscribed to List": "customer_subscribed"
  "Received Email": "email_received"
  "Opened Email": "email_opened"
  "Clicked Email": "email_clicked"
```

## Endpoints API

| Μέθοδος | Endpoint | Περιγραφή |
| --- | --- | --- |
| `GET` | `/api/profiles/` | Λίστα προφίλ |
| `POST` | `/api/profiles/` | Δημιουργία προφίλ |
| `PATCH` | `/api/profiles/{id}/` | Ενημέρωση προφίλ |
| `POST` | `/api/profile-merge/` | Συγχώνευση διπλοτύπων προφίλ |
| `GET` | `/api/events/` | Λίστα εκδηλώσεων |
| `POST` | `/api/events/` | Δημιουργία εκδήλωσης |
| `GET` | `/api/lists/` | Λίστα όλων των λιστών |
| `POST` | `/api/lists/{id}/relationships/profiles/` | Προσθήκη προφίλ σε λίστα |
| `GET` | `/api/segments/` | Λίστα τμημάτων |
| `GET` | `/api/campaigns/` | Λίστα καμπανιών |
| `GET` | `/api/flows/` | Λίστα ροών |
| `GET` | `/api/metrics/` | Λίστα μετρικών |
| `POST` | `/api/metric-aggregates/` | Ερώτημα συναθροισμάτων μετρικών |
| `GET` | `/api/catalog-items/` | Λίστα στοιχείων καταλόγου |

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

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

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

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

// Connect Klaviyo account
await tajo.connectors.connect('klaviyo', {
  privateApiKey: process.env.KLAVIYO_PRIVATE_KEY,
  publicApiKey: process.env.KLAVIYO_PUBLIC_KEY
});
```

### Συγχρονισμός Προφίλ στο Brevo

```javascript
// Fetch Klaviyo profiles and sync to Brevo
const response = await fetch('https://a.klaviyo.com/api/profiles/', {
  headers: {
    'Authorization': `Klaviyo-API-Key ${PRIVATE_KEY}`,
    'revision': '2026-01-15',
    'Accept': 'application/vnd.api+json'
  }
});

const { data } = await response.json();

// Each profile follows JSON:API format
// {
//   "type": "profile",
//   "id": "01ABCDEF",
//   "attributes": {
//     "email": "jane@example.com",
//     "first_name": "Jane",
//     "last_name": "Kim",
//     "phone_number": "+15551234567",
//     "properties": { "lifetime_value": 450.00 }
//   }
// }
```

### Δημιουργία Εκδήλωσης

```javascript
// Track an event in Klaviyo (forwarded to Brevo via Tajo)
await fetch('https://a.klaviyo.com/api/events/', {
  method: 'POST',
  headers: {
    'Authorization': `Klaviyo-API-Key ${PRIVATE_KEY}`,
    'revision': '2026-01-15',
    'Content-Type': 'application/vnd.api+json',
    'Accept': 'application/vnd.api+json'
  },
  body: JSON.stringify({
    data: {
      type: 'event',
      attributes: {
        metric: {
          data: { type: 'metric', attributes: { name: 'Placed Order' } }
        },
        profile: {
          data: { type: 'profile', attributes: { email: 'jane@example.com' } }
        },
        properties: {
          OrderId: 'ORD-1234',
          Value: 89.99,
          Items: [
            { ProductName: 'Widget Pro', Price: 89.99, Quantity: 1 }
          ]
        },
        value: 89.99
      }
    }
  })
});
```

### Ερώτημα Συναθροισμάτων Μετρικών

```javascript
// Get aggregate metric data for reporting
await fetch('https://a.klaviyo.com/api/metric-aggregates/', {
  method: 'POST',
  headers: {
    'Authorization': `Klaviyo-API-Key ${PRIVATE_KEY}`,
    'revision': '2026-01-15',
    'Content-Type': 'application/vnd.api+json'
  },
  body: JSON.stringify({
    data: {
      type: 'metric-aggregate',
      attributes: {
        metric_id: 'METRIC_ID',
        measurements: ['count', 'sum_value'],
        interval: 'day',
        filter: ['greater-or-equal(datetime,2024-01-01)',
                 'less-than(datetime,2024-02-01)']
      }
    }
  })
});
```

## Όρια Ρυθμού

| Πιστοποίηση | Όριο Burst | Σταθερό Όριο |
| --- | --- | --- |
| **Ιδιωτικό Κλειδί API** | 75 αιτήματα/δευτ. | 700 αιτήματα/λεπτό |
| **OAuth** | 150 αιτήματα/δευτ. | 1.500 αιτήματα/λεπτό |
| **Client API** | 100 αιτήματα/δευτ. | Δ/Ε |
| **Μαζικές λειτουργίες** | 10 αιτήματα/δευτ. | 100 αιτήματα/λεπτό |

Απαιτείται Αναθεώρηση API

Όλα τα αιτήματα Klaviyo API απαιτούν κεφαλίδα `revision` ορισμένη σε έγκυρη ημερομηνία έκδοσης API (π.χ. `2026-01-15`). Αιτήματα χωρίς αυτή την κεφαλίδα θα απορριφθούν.

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

| Πρόβλημα | Αιτία | Λύση |
| --- | --- | --- |
| `400 Bad Request` | Μη έγκυρο ή λείπει κλειδί API | Επαληθεύστε ότι το ιδιωτικό κλειδί API είναι σωστό |
| `403 Forbidden` | Ανεπαρκές εύρος | Ελέγξτε τα εύρη κλειδιού API έναντι των απαιτούμενων δικαιωμάτων |
| Λείπει κεφαλίδα `revision` | Δεν έχει οριστεί κεφαλίδα | Προσθέστε `revision: 2026-01-15` σε όλα τα αιτήματα |
| Δεν βρέθηκε προφίλ | Λάθος αναγνωριστικό | Χρησιμοποιήστε ID προφίλ Klaviyo, όχι email, για αναζητήσεις |
| Οι εκδηλώσεις δεν συγχρονίζονται | Λάθος όνομα μετρικού | Ταιριάξτε ακριβώς τα ονόματα μετρικών όπως ορίζονται στο Klaviyo |
| `429 Too Many Requests` | Υπέρβαση ορίου ρυθμού | Υλοποιήστε εκθετική καθυστέρηση, σκεφτείτε OAuth για υψηλότερα όρια |
| Σφάλματα μορφής JSON:API | Λάθος τύπος περιεχομένου | Χρησιμοποιήστε `application/vnd.api+json` για κεφαλίδες Content-Type και Accept |

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

1. **Χρησιμοποιήστε μορφή JSON:API** - Ακολουθήστε προδιαγραφή JSON:API για όλα τα payloads αιτημάτων και αποκρίσεων
2. **Ορίστε την κεφαλίδα revision** - Πάντα να συμπεριλαμβάνετε κεφαλίδα `revision` με την τελευταία ημερομηνία έκδοσης API
3. **Χρησιμοποιήστε sparse fieldsets** - Ζητήστε μόνο τα απαιτούμενα πεδία με `?fields[profile]=email,first_name` για μείωση μεγέθους payload
4. **Αξιοποιήστε σχέσεις** - Χρησιμοποιήστε παράμετρο JSON:API `include` για ανάκτηση σχετικών πόρων σε ένα αίτημα
5. **Χρησιμοποιήστε σελιδοποίηση cursor** - Πλοηγηθείτε σε μεγάλα σύνολα αποτελεσμάτων με παράμετρο `page[cursor]`
6. **Υλοποιήστε μαζικές λειτουργίες** - Χρησιμοποιήστε bulk endpoints για μαζικές εισαγωγές προφίλ και δημιουργία εκδηλώσεων
7. **Χρησιμοποιήστε OAuth για υψηλότερα όρια** - Η πιστοποίηση OAuth παρέχει 2x υψηλότερα όρια ρυθμού από ιδιωτικά κλειδιά

## Ασφάλεια

- **Εύρη ιδιωτικού κλειδιού API** - Λεπτομερής έλεγχος πρόσβασης Read/Full ανά τύπο πόρου
- **Υποστήριξη OAuth** - Ασφαλής πιστοποίηση βάσει token για ενσωματώσεις συνεργατών
- **Απομόνωση δημόσιου κλειδιού** - Κλειδιά πλευράς client περιορισμένα σε λειτουργίες μόνο δημιουργίας
- **TLS 1.2+** - Όλη η επικοινωνία API κρυπτογραφείται κατά τη μεταφορά
- **SOC 2 Type II** - Το Klaviyo είναι πιστοποιημένο SOC 2 Type II
- **Συμμόρφωση GDPR** - Data Privacy API για αιτήματα διαγραφής προφίλ

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

- [Σύνδεσμος Brevo](https://tajo.io/gr/docs/connectors/marketing/brevo)
- [Σύνδεσμος Google Ads](https://tajo.io/gr/docs/connectors/marketing/google-ads)
- [Σύνδεσμος Meta Ads](https://tajo.io/gr/docs/connectors/marketing/meta-ads)
- [Δεξιότητα Συγχρονισμού Πελατών](https://tajo.io/gr/docs/skills/data-sync/customer-sync)