Bağlayıcılar

Bağlayıcılar

Bağlayıcılar, platformlarınız ile Brevo arasında veri senkronize eden önceden oluşturulmuş entegrasyonlardır. Kimlik doğrulama, veri eşleme ve gerçek zamanlı senkronizasyonu yönetirler.

Bağlayıcı Nedir?

Bağlayıcı, aşağıdaki işlevleri gerçekleştiren çift yönlü bir veri köprüsüdür:

• Kimlik Doğrulama - Harici platformlarla güvenli bir şekilde kimlik doğrulaması yapar
• Veri Senkronizasyonu - Gerçek zamanlı veya toplu modda veri senkronize eder
• Alan Eşleme - Platform şemaları ile Brevo arasında alanları eşler
• Yetenek Etkinleştirme - Senkronize edilen veriler üzerinde eylem alacak yetenekleri etkinleştirir

Mevcut Bağlayıcılar

E-Ticaret Platformları

CRM Sistemleri

Ödemeler

Bağlayıcı Mimarisi

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

Veri Akışı

1. Kimlik Doğrulama: OAuth 2.0 veya API anahtarları aracılığıyla güvenli bağlantı
2. Gerçek Zamanlı Olaylar: Webhook’lar değişiklikleri anında yakalar
3. Toplu Senkronizasyon: Geçmiş veriler için zamanlanmış işler
4. Alan Eşleme: Brevo özniteliklerine yapılandırılabilir eşleme
5. Brevo API: Veriler kişilere, olaylara ve listelere senkronize edilir

Yapılandırma

Temel Kurulum

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

Senkronizasyon Modları

Hızlı Başlangıç

1. Bağlayıcınızı Seçin

Yukarıdaki katalogdan platformunuz için bağlayıcıyı seçin.

2. Kimlik Doğrulaması Yapın

Platformunuzu OAuth veya API kimlik bilgilerini kullanarak bağlayın:

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

3. Alan Eşlemesini Yapılandırın

Platform alanlarını Brevo kişi özniteliklerine eşleyin:

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

4. Veri Senkronizasyonunu Etkinleştirin

Veri senkronizasyonunu başlatın:

tajo connectors sync shopify --full

5. Yetenekleri Aktif Edin

Senkronize edilen verileri kullanan yetenekleri etkinleştirin:

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

Özel Bağlayıcılar

Katalogda bulunmayan platformlar için kendi bağlayıcınızı oluşturun:

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;

Sonraki Adımlar

• Shopify Bağlayıcısı - Shopify ile başlayın
• Veri Eşleme Rehberi - Alan eşlemesini öğrenin
• Connector SDK - Özel bağlayıcılar oluşturun
• Kimlik Doğrulama Desenleri - Bağlantılarınızı güvenceye alın