Συγχρονισμός Πελατών

Αυτόματος συγχρονισμός δεδομένων πελατών από την e-commerce πλατφόρμα σας στις επαφές Brevo. Αυτό το skill διασφαλίζει ότι η λίστα επαφών σας στη Brevo αντικατοπτρίζει πάντα την τρέχουσα βάση πελατών σας.

Επισκόπηση

Ιδιότητα	Τιμή
Κατηγορία	Συγχρονισμός Δεδομένων
Κατάσταση	Σταθερό
Έκδοση	2.1
Ενεργοποιήσεις	`customer_created`, `customer_updated`, `customer_deleted`
Ενέργειες	Δημιουργία Επαφής, Ενημέρωση Επαφής, Διαγραφή Επαφής

Πώς Λειτουργεί

graph LR
    A[E-commerce Platform] -->|Customer Event| B[Customer Sync Skill]
    B -->|Map Data| C[Field Mapping]
    C -->|API Call| D[Brevo Contacts API]
    D -->|Success| E[Contact Updated]
    D -->|Error| F[Retry Queue]

Ανίχνευση Συμβάντος: Ακούει συμβάντα lifecycle πελατών από την πλατφόρμα σας
Αντιστοίχιση Δεδομένων: Αντιστοιχεί πεδία πλατφόρμας σε χαρακτηριστικά επαφής Brevo
Συγχρονισμός API: Δημιουργεί, ενημερώνει ή διαγράφει επαφές μέσω API Brevo
Διαχείριση Σφαλμάτων: Επαναλαμβάνει αποτυχημένες λειτουργίες με εκθετική αναμονή

Ρύθμιση

Βασική Εγκατάσταση

skills:
  customer-sync:
    enabled: true
    source: shopify  # or woocommerce, magento, custom

    # Map platform fields to Brevo attributes
    field_mapping:
      email: email
      firstName: FIRSTNAME
      lastName: LASTNAME
      phone: SMS

    # Sync options
    options:
      sync_mode: realtime  # or batch
      delete_behavior: soft  # or hard
      list_id: 5  # Add to this list

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

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

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

Parameter	Type	Description
`email` required	string	Διεύθυνση email πελάτη. Χρησιμοποιείται ως μοναδικό αναγνωριστικό στη Brevo.
`firstName` optional	string	Μικρό όνομα πελάτη. Αντιστοιχεί στο χαρακτηριστικό FIRSTNAME. Default: `FIRSTNAME`
`lastName` optional	string	Επώνυμο πελάτη. Αντιστοιχεί στο χαρακτηριστικό LASTNAME. Default: `LASTNAME`
`phone` optional	string	Αριθμός τηλεφώνου σε μορφή E.164. Αντιστοιχεί στο χαρακτηριστικό SMS για WhatsApp/SMS. Default: `SMS`
`acceptsMarketing` optional	boolean	Κατάσταση συναίνεσης marketing. Ελέγχει την κατάσταση εγγραφής email. Default: `true`

Προσαρμοσμένα Χαρακτηριστικά

Προσθέστε προσαρμοσμένες αντιστοιχίσεις χαρακτηριστικών για δεδομένα e-commerce:

field_mapping:
  # Standard fields
  email: email
  firstName: FIRSTNAME

  # Custom e-commerce attributes
  totalOrders: TOTAL_ORDERS
  totalSpent: TOTAL_SPENT
  lastOrderDate: LAST_ORDER_DATE
  customerTier: CUSTOMER_TIER
  tags: TAGS

Tip

Δημιουργήστε πρώτα τα χαρακτηριστικά: Τα προσαρμοσμένα χαρακτηριστικά πρέπει να δημιουργηθούν στη Brevo πριν μπορέσουν να συγχρονιστούν. Χρησιμοποιήστε τον πίνακα ελέγχου ή το API Brevo για να τα δημιουργήσετε.

Ενεργοποιήσεις

customer_created

Ενεργοποιείται όταν δημιουργείται νέος πελάτης στην πλατφόρμα σας.

{
  "event": "customer_created",
  "timestamp": "2024-01-15T10:30:00Z",
  "data": {
    "id": "cust_12345",
    "email": "[email protected]",
    "firstName": "Jane",
    "lastName": "Smith",
    "phone": "+1234567890",
    "acceptsMarketing": true,
    "createdAt": "2024-01-15T10:30:00Z"
  }
}

customer_updated

Ενεργοποιείται όταν τροποποιούνται πληροφορίες πελάτη.

{
  "event": "customer_updated",
  "timestamp": "2024-01-15T14:45:00Z",
  "data": {
    "id": "cust_12345",
    "email": "[email protected]",
    "changes": {
      "phone": {
        "old": null,
        "new": "+1234567890"
      }
    }
  }
}

customer_deleted

Ενεργοποιείται όταν αφαιρείται πελάτης από την πλατφόρμα σας.

{
  "event": "customer_deleted",
  "timestamp": "2024-01-15T16:00:00Z",
  "data": {
    "id": "cust_12345",
    "email": "[email protected]",
    "deletedAt": "2024-01-15T16:00:00Z"
  }
}

Ενέργειες

Δημιουργία Επαφής

Δημιουργεί νέα επαφή στη Brevo όταν δημιουργείται πελάτης.

Δημιουργία νέας επαφής στον λογαριασμό Brevo σας

Query Parameters

Parameter	Description
email string required	Διεύθυνση email επαφής
attributes object optional	Χαρακτηριστικά επαφής
listIds array optional	IDs λιστών για προσθήκη επαφής
updateEnabled boolean optional	Ενημέρωση εάν η επαφή υπάρχει Default: `false`

Responses

201 Η επαφή δημιουργήθηκε επιτυχώς

400 Μη έγκυρες παράμετροι αιτήματος

409 Η επαφή υπάρχει ήδη

Ενημέρωση Επαφής

Ενημερώνει υπάρχουσα επαφή όταν αλλάζουν δεδομένα πελάτη.

Ενημέρωση χαρακτηριστικών υπάρχουσας επαφής

Path Parameters

Parameter	Description
identifier string required	Email ή ID επαφής

Query Parameters

Parameter	Description
attributes object optional	Χαρακτηριστικά για ενημέρωση
listIds array optional	Λίστες για προσθήκη επαφής
unlinkListIds array optional	Λίστες για αφαίρεση επαφής

Responses

204 Η επαφή ενημερώθηκε επιτυχώς

400 Μη έγκυρες παράμετροι αιτήματος

404 Η επαφή δεν βρέθηκε

Διαγραφή Επαφής

Αφαιρεί επαφή όταν διαγράφεται πελάτης.

Μόνιμη διαγραφή επαφής από τη Brevo

Path Parameters

Parameter	Description
identifier string required	Email ή ID επαφής

Responses

204 Η επαφή διαγράφηκε επιτυχώς

404 Η επαφή δεν βρέθηκε

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

JavaScript (Node.js)

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

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

// Enable customer sync skill
await tajo.skills.enable('customer-sync', {
  source: 'shopify',
  fieldMapping: {
    email: 'email',
    firstName: 'FIRSTNAME',
    lastName: 'LASTNAME',
    totalOrders: 'TOTAL_ORDERS',
    totalSpent: 'TOTAL_SPENT'
  },
  options: {
    syncMode: 'realtime',
    listId: 5
  }
});

// Manually trigger a sync
await tajo.skills.trigger('customer-sync', {
  event: 'customer_created',
  data: {
    email: '[email protected]',
    firstName: 'Jane',
    lastName: 'Smith'
  }
});

Python

from tajo import TajoClient

tajo = TajoClient(
    api_key=os.environ['TAJO_API_KEY'],
    brevo_api_key=os.environ['BREVO_API_KEY']
)

# Enable customer sync skill
tajo.skills.enable('customer-sync', {
    'source': 'woocommerce',
    'field_mapping': {
        'email': 'email',
        'first_name': 'FIRSTNAME',
        'last_name': 'LASTNAME',
        'total_orders': 'TOTAL_ORDERS'
    },
    'options': {
        'sync_mode': 'realtime',
        'list_id': 5
    }
})

# Manually trigger a sync
tajo.skills.trigger('customer-sync', {
    'event': 'customer_updated',
    'data': {
        'email': '[email protected]',
        'total_orders': 10,
        'total_spent': 1250.00
    }
})

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

Πίνακας Ελέγχου Κατάστασης Συγχρονισμού

Παρακολουθήστε την απόδοση συγχρονισμού στον πίνακα ελέγχου Tajo:

Ποσοστό Επιτυχίας Συγχρονισμού: Ποσοστό επιτυχημένων συγχρονισμών
Μέση Καθυστέρηση: Χρόνος από το συμβάν έως την ενημέρωση Brevo
Ποσοστό Σφαλμάτων: Αποτυχημένες προσπάθειες συγχρονισμού
Βάθος Ουράς: Εκκρεμείς λειτουργίες συγχρονισμού

Ειδοποιήσεις Webhook

Λάβετε ειδοποιήσεις για συμβάντα συγχρονισμού:

notifications:
  webhook_url: https://your-app.com/webhooks/tajo
  events:
    - sync_completed
    - sync_failed
    - batch_completed

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

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

Η Επαφή Υπάρχει Ήδη (409)

Ενεργοποιήστε το updateEnabled: true στη ρύθμισή σας για να ενημερώνει υπάρχουσες επαφές αντί να αποτυγχάνει.

Σφάλμα	Αιτία	Λύση
`Contact already exists`	Υπάρχει επαφή με αυτό το email	Ενεργοποιήστε `updateEnabled: true`
`Invalid attribute`	Το χαρακτηριστικό δεν υπάρχει στη Brevo	Δημιουργήστε πρώτα το χαρακτηριστικό στη Brevo
`Rate limit exceeded`	Πάρα πολλά αιτήματα API	Χρησιμοποιήστε κατάσταση συγχρονισμού παρτίδας
`Invalid email format`	Κακώς μορφοποιημένη διεύθυνση email	Επικυρώστε τα emails πριν τον συγχρονισμό

Κατάσταση Αποσφαλμάτωσης

Ενεργοποιήστε καταγραφή αποσφαλμάτωσης για αντιμετώπιση προβλημάτων:

skills:
  customer-sync:
    debug: true
    log_level: verbose

Σχετικά Skills

Συμβάντα Παραγγελιών – συγχρονισμός δεδομένων παραγγελιών
Κατάλογος Προϊόντων – συγχρονισμός δεδομένων προϊόντων
Συμβάντα Καλαθιού – παρακολούθηση δραστηριότητας καλαθιού

Επόμενα Βήματα

Ρυθμίστε αντιστοιχίσεις πεδίων για την πλατφόρμα σας
Ρυθμίστε προσαρμοσμένα χαρακτηριστικά στη Brevo
Ενεργοποιήστε συγχρονισμό πραγματικού χρόνου για άμεσες ενημερώσεις

Συγχρονισμός Πελατών