Connectors

Connectors sind vorgefertigte Integrationen, die Daten zwischen deinen Plattformen und Brevo synchronisieren. Sie übernehmen Authentifizierung, Datenmapping und Echtzeit-Synchronisierung.

Was sind Connectors?

Ein Connector ist eine bidirektionale Datenbrücke, die:

• Authentifiziert sich sicher bei externen Plattformen
• Synchronisiert Daten in Echtzeit oder im Batch-Modus
• Ordnet Felder zwischen Plattform-Schemata und Brevo zu
• Ermöglicht Skills, um auf synchronisierten Daten zu agieren

Verfügbare Connectors

E-Commerce-Plattformen

CRM-Systeme

Zahlungen

Connector-Architektur

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

Datenfluss

1. Authentifizierung: Sichere Verbindung über OAuth 2.0 oder API-Schlüssel
2. Echtzeit-Events: Webhooks erfassen Änderungen sofort
3. Batch-Sync: Geplante Jobs für historische Daten
4. Feldzuordnung: Konfigurierbare Zuordnung zu Brevo-Attributen
5. Brevo API: Daten werden mit Kontakten, Events und Listen synchronisiert

Konfiguration

Grundeinrichtung

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

Sync-Modi

Schnellstart

1. Wähle deinen Connector

Wähle aus dem Katalog oben den Connector für deine Plattform aus.

2. Authentifizieren

Verbinde deine Plattform über OAuth oder API-Zugangsdaten:

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

3. Feldzuordnung konfigurieren

Ordne Plattformfelder den Brevo-Kontaktattributen zu:

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

4. Datensynchronisierung aktivieren

Starte die Datensynchronisierung:

tajo connectors sync shopify --full

5. Skills aktivieren

Aktiviere Skills, die die synchronisierten Daten nutzen:

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

Nächste Schritte

• Shopify Connector - Mit Shopify starten