Συνδετήρες

Συνδετήρες

Οι συνδετήρες είναι προκατασκευασμένες ενσωματώσεις που συγχρονίζουν δεδομένα μεταξύ των πλατφορμών σου και του Brevo. Διαχειρίζονται τον έλεγχο ταυτότητας, τον χαρτογραφικό συσχετισμό δεδομένων και τον συγχρονισμό σε πραγματικό χρόνο.

Τι είναι οι Συνδετήρες;

Ένας Συνδετήρας είναι μια αμφίδρομη γέφυρα δεδομένων που:

• Ελέγχει την ταυτότητα με ασφάλεια σε εξωτερικές πλατφόρμες
• Συγχρονίζει Δεδομένα σε πραγματικό χρόνο ή σε λειτουργία batch
• Αντιστοιχίζει Πεδία μεταξύ των schemas πλατφορμών και του Brevo
• Ενεργοποιεί Skills που δρουν στα συγχρονισμένα δεδομένα

Διαθέσιμοι Συνδετήρες

Πλατφόρμες E-commerce

Συστήματα CRM

Πληρωμές

Αρχιτεκτονική Συνδετήρων

graph LR
    A[Your Platform] <-->|OAuth/API Key| B[Tajo Connector]
    B <-->|Real-time Webhooks| C[Event Processing]
    C --> D[Field Mapping]
    D --> E[Brevo API]
    B <-->|Batch Sync| F[Scheduled Jobs]
    F --> D

Ροή Δεδομένων

1. Έλεγχος ταυτότητας: Ασφαλής σύνδεση μέσω OAuth 2.0 ή API keys
2. Συμβάντα σε πραγματικό χρόνο: Τα webhooks καταγράφουν αλλαγές άμεσα
3. Batch συγχρονισμός: Προγραμματισμένες εργασίες για ιστορικά δεδομένα
4. Αντιστοίχιση Πεδίων: Παραμετροποιήσιμη αντιστοίχιση σε ιδιότητες Brevo
5. Brevo API: Τα δεδομένα συγχρονίζονται σε επαφές, συμβάντα και λίστες

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

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

connectors:
  shopify:
    enabled: true
    shop_url: "your-store.myshopify.com"
    api_key: "${SHOPIFY_API_KEY}"
    api_secret: "${SHOPIFY_API_SECRET}"

    # Data sync settings
    sync:
      customers: true
      orders: true
      products: true
      carts: true

    # Field mappings
    field_mapping:
      email: email
      first_name: FIRSTNAME
      last_name: LASTNAME
      total_spent: TOTAL_SPENT

Τρόποι Συγχρονισμού

Γρήγορη Εκκίνηση

1. Επίλεξε τον Συνδετήρα σου

Διάλεξε τον συνδετήρα για την πλατφόρμα σου από τον παραπάνω κατάλογο.

2. Έλεγχος Ταυτότητας

Σύνδεσε την πλατφόρμα σου χρησιμοποιώντας OAuth ή διαπιστευτήρια API:

tajo connectors connect shopify \
  --shop-url your-store.myshopify.com \
  --api-key $SHOPIFY_API_KEY

3. Παραμετροποίηση Αντιστοίχισης Πεδίων

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

field_mapping:
  email: email
  firstName: FIRSTNAME
  lastName: LASTNAME
  totalOrders: ORDER_COUNT
  totalSpent: TOTAL_REVENUE
  lastOrderDate: LAST_ORDER_DATE

4. Ενεργοποίηση Συγχρονισμού Δεδομένων

Ξεκίνα τον συγχρονισμό δεδομένων:

tajo connectors sync shopify --full

5. Ενεργοποίηση Skills

Ενεργοποίησε skills που χρησιμοποιούν τα συγχρονισμένα δεδομένα:

tajo skills enable abandoned-cart
tajo skills enable customer-sync

Προσαρμοσμένοι Συνδετήρες

Φτιάξε τον δικό σου συνδετήρα για πλατφόρμες που δεν βρίσκονται στον κατάλογο:

Connector SDK

import { ConnectorSDK } from '@tajo/connector-sdk';

const connector = new ConnectorSDK({
  name: 'my-platform',
  version: '1.0.0',

  // Authentication
  auth: {
    type: 'oauth2',
    authorizationUrl: 'https://api.myplatform.com/oauth/authorize',
    tokenUrl: 'https://api.myplatform.com/oauth/token'
  },

  // Data mappings
  resources: {
    customers: {
      endpoint: '/api/customers',
      mapping: {
        email: 'contact.email',
        name: 'contact.full_name'
      }
    }
  },

  // Webhooks
  webhooks: {
    customer_created: '/webhooks/customer',
    order_placed: '/webhooks/order'
  }
});

export default connector;

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

• Συνδετήρας Shopify - Ξεκίνα με το Shopify
• Οδηγός Αντιστοίχισης Δεδομένων - Μάθε την αντιστοίχιση πεδίων
• Connector SDK - Κατασκεύασε custom συνδετήρες
• Πρότυπα Ελέγχου Ταυτότητας - Προστάτευσε τις συνδέσεις σου