Konnektorok

Konnektorok

A konnektorok előre elkészített integrációk, amelyek szinkronizálják az adatokat a platformjaid és a Brevo között. Kezelik a hitelesítést, az adatleképezést és a valós idejű szinkronizációt.

Mik azok a konnektorok?

A Konnektor egy kétirányú adathíd, amely:

• Biztonságosan hitelesít külső platformokkal
• Szinkronizálja az adatokat valós időben vagy kötegelt módban
• Mezőket képez le a platformséma és a Brevo között
• Engedélyezi a Skilleket, hogy a szinkronizált adatokra reagáljanak

Elérhető konnektorok

E-kereskedelmi platformok

CRM-rendszerek

Fizetések

Konnektor-architektúra

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

Adatáramlás

1. Hitelesítés: Biztonságos kapcsolat OAuth 2.0 vagy API kulcsokon keresztül
2. Valós idejű események: A webhookok azonnal rögzítik a változásokat
3. Kötegelt szinkronizáció: Ütemezett feladatok a történeti adatokhoz
4. Mezőleképezés: Konfigurálható leképezés a Brevo attribútumokhoz
5. Brevo API: Az adatok szinkronizálódnak a kapcsolatokba, eseményekbe és listákba

Konfiguráció

Alapbeállítás

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

Szinkronizációs módok

Gyors kezdés

1. Válaszd ki a konnektorodat

Válaszd ki a platformodnak megfelelő konnektort a fenti katalógusból.

2. Hitelesíts

Csatlakoztasd a platformot OAuth vagy API hitelesítő adatokkal:

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

3. Konfiguráld a mezőleképezést

Képezd le a platformmezőket a Brevo kapcsolat-attribútumokhoz:

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

4. Engedélyezd az adatszinkronizációt

Indítsd el az adatszinkronizációt:

tajo connectors sync shopify --full

5. Aktiváld a Skilleket

Engedélyezd azokat a Skilleket, amelyek a szinkronizált adatokat használják:

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

Egyedi konnektorok

Építs saját konnektort a katalógusban nem szereplő platformokhoz:

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;

Következő lépések

• Shopify konnektor – Kezdj neki a Shopify-jal
• Adatleképezési útmutató – Tanuld meg a mezőleképezést
• Connector SDK – Építs egyedi konnektorokat
• Hitelesítési minták – Biztosítsd a kapcsolataidat