Σύνδεσμος Brevo

Σύνδεσμος Brevo

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

Επισκόπηση

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

• Αποστολή μηνυμάτων πολλαπλών καναλιών - Αποστολή συναλλακτικού 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.

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 με καθορισμένες περιόδους ισχύος.

Διαμόρφωση

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

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:

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

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

Endpoints eCommerce

Endpoints Καμπάνιας

Εκδηλώσεις

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

Εκδηλώσεις eCommerce

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

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

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

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

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

// 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
// }

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

// Track a custom event for a contact
await tajo.brevo.trackEvent({
  email: '[email protected]',
  event: 'product_purchased',
  eventdata: {
    id: 'txn_98765',
    data: {
      product_name: 'Premium Widget',
      price: 49.99,
      currency: 'USD'
    }
  }
});

Όρια Ρυθμού

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

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

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

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

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

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

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

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
• Οδηγός Πιστοποίησης Brevo
• Όρια Ρυθμού Brevo
• Σύνδεσμος Shopify
• Δεξιότητα Συγχρονισμού Πελατών
• API Επαφών Brevo