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

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

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

# Σύνδεσμος Brevo

Κατάσταση συνδέσμου: Ενεργό Επαληθευμένο. Το Tajo εκτελεί σήμερα αυτόν τον σύνδεσμο.

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

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

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

| Ιδιότητα | Τιμή |
| --- | --- |
| **Πλατφόρμα** | Brevo |
| **Κατηγορία** | Marketing |
| **Πολυπλοκότητα Ρύθμισης** | Εύκολη |
| **Επίσημη Ενσωμάτωση** | Ναι |
| **Δεδομένα που Συγχρονίζονται** | Επαφές, Καμπάνιες, Συναλλακτικά Μηνύματα, Εκδηλώσεις, eCommerce |
| **Βασικό URL API** | `https://api.brevo.com/v3` |

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

- **Αποστολή μηνυμάτων πολλαπλών καναλιών** - Αποστολή συναλλακτικού email, SMS και WhatsApp από ενοποιημένο API
- **Διαχείριση επαφών** - Δημιουργία, ενημέρωση και τμηματοποίηση επαφών με προσαρμοσμένα χαρακτηριστικά
- **Καμπάνιες marketing** - Προγραμματιστική δημιουργία και αποστολή καμπανιών email
- **Παρακολούθηση εκδηλώσεων** - Παρακολούθηση προσαρμοσμένων εκδηλώσεων και δραστηριότητας ιστότοπου μέσω Brevo Tracker
- **Συγχρονισμός eCommerce** - Συγχρονισμός προϊόντων, παραγγελιών και δεδομένων καλαθιού για εξατομικευμένες καμπάνιες
- **Προγράμματα πιστότητας** - Διαχείριση συνδρομών πιστότητας, πόντων και δεδομένων μελών
- **Υποστήριξη webhook** - Ειδοποιήσεις εκδηλώσεων σε πραγματικό χρόνο για συναλλακτικές, marketing και CRM εκδηλώσεις
- **Συνομιλίες** - Ενσωμάτωση widget live chat και προγραμματιστική διαχείριση μηνυμάτων

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

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

1. Λογαριασμό Brevo (πλάνο Free, Starter, Business ή Enterprise)
2. Κλειδί API δημιουργημένο από Ρυθμίσεις Brevo > API Keys
3. Λογαριασμό Tajo με πρόσβαση API
4. Επαληθευμένο domain αποστολέα για αποστολή email

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

Το Brevo υποστηρίζει δύο μεθόδους πιστοποίησης:

### Πιστοποίηση με API Key (Συνιστάται)

Συμπεριλάβετε το κλειδί API στο header `api-key` σε κάθε αίτημα. Κατάλληλο για άμεσες ενσωματώσεις και επικοινωνία server-to-server.

```bash
curl -X GET "https://api.brevo.com/v3/account" \
  -H "api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json"
```

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

Χρησιμοποιήστε OAuth 2.0 για ιδιωτικές ενσωματώσεις εντός οργανισμού που απαιτούν ανατεθειμένη πρόσβαση και δικαιώματα συγκεκριμένα για χρήστη. Το OAuth παρέχει σύστημα βάσει token με καθορισμένες περιόδους ισχύος.

Διαθεσιμότητα OAuth

Το OAuth είναι διαθέσιμο αυτήν τη στιγμή μόνο για ιδιωτικές ενσωματώσεις εντός οργανισμού. Οι ενσωματώσεις OAuth δεν προορίζονται για δημόσια διανομή ή καταχώριση σε marketplace.

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

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

```yaml
connectors:
  brevo:
    enabled: true
    api_key: "${BREVO_API_KEY}"
    api_version: "v3"

    # Data sync options
    sync:
      contacts: true
      campaigns: true
      transactional: true
      events: true
      ecommerce: true

    # List assignment
    lists:
      all_customers: 5
      newsletter: 6
      buyers: 7
```

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

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

#### Προεπιλεγμένες Αντιστοιχίσεις

| Parameter | Type | Description |
| --- | --- | --- |
| `email` required | string | Διεύθυνση email επαφής (μοναδικό αναγνωριστικό) |
| `FIRSTNAME` optional | string | Χαρακτηριστικό όνοματος επαφής |
| `LASTNAME` optional | string | Χαρακτηριστικό επωνύμου επαφής |
| `SMS` optional | string | Αριθμός τηλεφώνου για αποστολή SMS και WhatsApp |
| `OPT_IN` optional | boolean | Κατάσταση συγκατάθεσης εγγραφής marketing |
| `ORDER_COUNT` optional | integer | Συνολικός αριθμός τοποθετημένων παραγγελιών |
| `TOTAL_REVENUE` optional | number | Έσοδα διάρκειας ζωής από την επαφή |
| `LOYALTY_POINTS` optional | integer | Τρέχον υπόλοιπο πόντων προγράμματος πιστότητας |

#### Αντιστοίχιση Προσαρμοσμένων Χαρακτηριστικών

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

  # Marketing fields
  opt_in: OPT_IN
  signup_source: SIGNUP_SOURCE
  preferred_language: LANGUAGE

  # eCommerce metrics
  orders_count: ORDER_COUNT
  total_spent: TOTAL_REVENUE
  last_order_date: LAST_ORDER_DATE

  # Loyalty fields
  loyalty_tier: VIP_TIER
  loyalty_points: LOYALTY_POINTS
```

## Endpoints API

### Βασικά Endpoints

| Μέθοδος | Endpoint | Περιγραφή |
| --- | --- | --- |
| `POST` | `/v3/smtp/email` | Αποστολή συναλλακτικού email |
| `POST` | `/v3/transactionalSMS/send` | Αποστολή συναλλακτικού SMS |
| `POST` | `/v3/whatsapp/sendMessage` | Αποστολή συναλλακτικού WhatsApp |
| `POST` | `/v3/contacts` | Δημιουργία επαφής |
| `PUT` | `/v3/contacts/{email}` | Ενημέρωση επαφής |
| `GET` | `/v3/contacts/{identifier}` | Λήψη λεπτομερειών επαφής |
| `POST` | `/v3/contacts/import` | Μαζική εισαγωγή επαφών |

### Endpoints eCommerce

| Μέθοδος | Endpoint | Περιγραφή |
| --- | --- | --- |
| `POST` | `/v3/orders/status` | Δημιουργία ή ενημέρωση κατάστασης παραγγελίας |
| `POST` | `/v3/products` | Δημιουργία ή ενημέρωση προϊόντων |
| `POST` | `/v3/categories` | Δημιουργία ή ενημέρωση κατηγοριών προϊόντων |
| `POST` | `/v3/events` | Παρακολούθηση προσαρμοσμένων εκδηλώσεων |

### Endpoints Καμπάνιας

| Μέθοδος | Endpoint | Περιγραφή |
| --- | --- | --- |
| `POST` | `/v3/emailCampaigns` | Δημιουργία καμπάνιας email |
| `POST` | `/v3/emailCampaigns/{id}/sendNow` | Άμεση αποστολή καμπάνιας |
| `GET` | `/v3/emailCampaigns` | Λίστα όλων των καμπανιών email |
| `GET` | `/v3/smtp/statistics/events` | Λήψη στατιστικών εκδηλώσεων email |

## Εκδηλώσεις

### Συναλλακτικές Εκδηλώσεις

| Εκδήλωση | Ενεργοποιητής | Περίπτωση Χρήσης |
| --- | --- | --- |
| `delivered` | Email παραδόθηκε στα εισερχόμενα | Επιβεβαίωση παράδοσης |
| `opened` | Email ανοίχτηκε από παραλήπτη | Παρακολούθηση αφοσίωσης |
| `clicked` | Κλίκ σε σύνδεσμο στο email | Παρακολούθηση click-through |
| `bounced` | Αναπόδοτο email | Υγιεινή λίστας |
| `spam` | Επισήμανση ως spam | Παρακολούθηση συμμόρφωσης |
| `unsubscribed` | Κατάργηση εγγραφής επαφής | Διαχείριση προτιμήσεων |

### Εκδηλώσεις eCommerce

| Εκδήλωση | Ενεργοποιητής | Περίπτωση Χρήσης |
| --- | --- | --- |
| `order_completed` | Επιτυχής τοποθέτηση παραγγελίας | Ροές μετά-αγοράς |
| `cart_updated` | Αλλαγή περιεχομένων καλαθιού | Παρακολούθηση εγκαταλελειμμένου καλαθιού |
| `cart_deleted` | Εκκαθάριση ή λήξη καλαθιού | Ανάκτηση καλαθιού |
| `product_viewed` | Επίσκεψη σελίδας προϊόντος | Εγκατάλειψη περιήγησης |

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

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

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

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

// Connect Brevo account
await tajo.connectors.connect('brevo', {
  apiKey: process.env.BREVO_API_KEY
});
```

### Αποστολή Συναλλακτικού Email

```javascript
// Send a transactional email via Brevo
await tajo.brevo.sendTransactionalEmail({
  to: [{ email: 'customer@example.com', name: 'John Doe' }],
  templateId: 12,
  params: {
    ORDER_ID: '12345',
    ORDER_TOTAL: '$59.99',
    DELIVERY_DATE: '2024-02-15'
  }
});
```

### Συγχρονισμός Επαφών

```javascript
// Bulk import contacts to Brevo
await tajo.connectors.sync('brevo', {
  type: 'full',
  resources: ['contacts'],
  options: {
    listIds: [5, 6],
    updateExisting: true,
    emptyContactsAttributes: false
  }
});

// Check sync status
const status = await tajo.connectors.status('brevo');
console.log(status);
// {
//   connected: true,
//   lastSync: '2024-01-15T10:30:00Z',
//   contactsSynced: 25400,
//   campaignsSent: 142,
//   eventsTracked: 89320
// }
```

### Παρακολούθηση Προσαρμοσμένων Εκδηλώσεων

```javascript
// Track a custom event for a contact
await tajo.brevo.trackEvent({
  email: 'customer@example.com',
  event: 'product_purchased',
  eventdata: {
    id: 'txn_98765',
    data: {
      product_name: 'Premium Widget',
      price: 49.99,
      currency: 'USD'
    }
  }
});
```

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

Το Brevo επιβάλλει όρια ρυθμού σε τρία επίπεδα βάσει του πλάνου σας:

| Endpoint | Free/Starter | Professional | Enterprise |
| --- | --- | --- | --- |
| `POST /v3/smtp/email` | 1.000 RPS | 2.000 RPS | 6.000 RPS |
| `POST /v3/transactionalSMS/send` | 150 RPS | 200 RPS | 250 RPS |
| `POST /v3/events` | 10 RPS | 20 RPS | 60 RPS |
| `/v3/contacts/*` | 10 RPS | 20 RPS | 60 RPS |
| Όλα τα άλλα endpoints | 100 RPH | 200 RPH | 600 RPH |

Απόκριση Ορίου Ρυθμού

Όταν υπερβαίνετε ένα όριο ρυθμού, το API επιστρέφει κωδικό κατάστασης `429 Too Many Requests`. Παρακολουθήστε τα headers ορίου ρυθμού στις αποκρίσεις για παρακολούθηση της χρήσης σας.

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

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

| Πρόβλημα | Αιτία | Λύση |
| --- | --- | --- |
| 401 Unauthorized | Μη έγκυρο κλειδί API | Αναγεννήστε κλειδί API στις Ρυθμίσεις Brevo |
| Η επαφή δεν δημιουργήθηκε | Λείπει πεδίο email | Βεβαιωθείτε ότι το email παρέχεται για όλες τις επαφές |
| Το email δεν παραδόθηκε | Μη επαληθευμένο domain αποστολέα | Επαληθεύστε domain στις ρυθμίσεις Αποστολέων Brevo |
| Δεν λαμβάνεται webhook | Λανθασμένο URL ή σφάλμα server | Ελέγξτε προσβασιμότητα URL webhook και logs |
| Το SMS δεν στάλθηκε | Μη έγκυρη μορφή τηλεφώνου | Χρησιμοποιήστε διεθνή μορφή με κωδικό χώρας |

### Λειτουργία Εντοπισμού Σφαλμάτων

Ενεργοποιήστε λεπτομερή καταγραφή:

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

### Δοκιμή Σύνδεσης

```bash
tajo connectors test brevo
# ✓ API connection successful
# ✓ Contacts API accessible
# ✓ Transactional email ready
# ✓ SMS sending configured
# ✓ Webhooks registered
```

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

1. **Χρησιμοποιήστε εναλλαγή κλειδιών API** - Εναλλάσσετε κλειδιά API περιοδικά για ασφάλεια
2. **Εφαρμόστε επικύρωση webhook** - Επικυρώνετε υπογραφές webhook με πιστοποίηση username/password
3. **Εισαγωγές επαφών batch** - Χρησιμοποιήστε μαζική εισαγωγή για μεγάλα σύνολα δεδομένων αντί μεμονωμένων κλήσεων API
4. **Παρακολουθήστε όρια ρυθμού** - Ελέγχετε headers ορίου ρυθμού για αποφυγή σφαλμάτων 429
5. **Χρησιμοποιήστε παρακολούθηση εκδηλώσεων** - Εφαρμόστε Brevo Tracker για ολοκληρωμένα δεδομένα συμπεριφοράς πελάτη
6. **Ρυθμίστε σωστή πιστοποίηση αποστολέα** - Διαμορφώστε SPF, DKIM και DMARC για βέλτιστη παραδοσιμότητα

## Ασφάλεια

- **Πιστοποίηση API Key** - Πρόσβαση βάσει μυστικού token μέσω header `api-key`
- **OAuth 2.0** - Ανατεθειμένη πρόσβαση βάσει token για ιδιωτικές ενσωματώσεις
- **Επικύρωση webhook** - Πιστοποίηση username και password για ασφαλείς κλήσεις webhook
- **Κρυπτογράφηση TLS** - Όλη η επικοινωνία API κρυπτογραφείται κατά τη μεταφορά
- **Allowlisting IP** - Προαιρετικοί περιορισμοί IP διαθέσιμοι σε Enterprise πλάνα

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

- [Τεκμηρίωση API Brevo](https://developers.brevo.com/docs/getting-started)
- [Οδηγός Πιστοποίησης Brevo](https://developers.brevo.com/docs/authentication-schemes)
- [Όρια Ρυθμού Brevo](https://developers.brevo.com/docs/api-limits)
- [Σύνδεσμος Shopify](https://tajo.io/gr/docs/connectors/ecommerce/shopify)
- [Δεξιότητα Συγχρονισμού Πελατών](https://tajo.io/gr/docs/skills/data-sync/customer-sync)
- [API Επαφών Brevo](https://tajo.io/gr/docs/contact-management)