Airtable Bağlayıcısı

Airtable base’lerinizi Brevo’ya bağlayarak CRM senkronizasyonu, ürün kataloğu yönetimi ve Tajo aracılığıyla yapılandırılmış verilerle güçlendirilmiş otomatik pazarlama iş akışları elde edin.

Genel Bakış

Özellikler

• Tablodan listeye senkronizasyon - Airtable tablo kayıtlarını doğrudan Brevo kişi listelerine senkronize edin
• Ürün kataloğu köprüsü - E-posta önerileri için Airtable tablolarını ürün katalogları olarak kullanın
• CRM senkronizasyonu - Airtable CRM ile Brevo kişileri arasında çift yönlü senkronizasyon
• Form gönderim olayları - Airtable form gönderimlerini Brevo olayları olarak iletin
• Görünüm tabanlı filtreleme - Belirli Airtable görünümlerini hedeflenmiş Brevo listelerine senkronize edin
• Webhook otomasyonu - Airtable kayıtları değiştiğinde Brevo kampanyalarını tetikleyin

Ön Koşullar

Başlamadan önce sahip olmanız gerekenler:

1. Bir Airtable hesabı (Free plan veya üzeri)
2. Yapılandırılmış bir Kişisel Erişim Belirteci veya OAuth uygulaması
3. Senkronize etmek istediğiniz base ve tablolara erişim
4. API erişimi olan bir Brevo hesabı
5. Aktif aboneliği olan bir Tajo hesabı

Kimlik Doğrulama

Airtable, Kişisel Erişim Belirteçlerini ve OAuth 2.0’ı destekler.

Seçenek 1: Kişisel Erişim Belirteci (Önerilen)

1. airtable.com/create/tokens adresine gidin
2. Create new token seçeneğine tıklayın
3. “Tajo Integration” olarak adlandırın
4. Kapsamları ekleyin:

data.records:read
data.records:write
data.recordComments:read
schema.bases:read
webhook:manage

5. Belirli base’lere veya tüm base’lere erişim ekleyin
6. Create token seçeneğine tıklayın

Seçenek 2: OAuth 2.0

Çok kullanıcılı entegrasyonlar için OAuth 2.0 akışını kullanın:

1. Entegrasyonunuzu airtable.com/create/oauth adresinde kaydedin
2. Yönlendirme URI’sini yapılandırın: https://app.tajo.io/callbacks/airtable
3. Yukarıdakilerle aynı kapsamları isteyin

Tajo’ya Bağlanma

tajo connectors install airtable \
  --token $AIRTABLE_TOKEN

Yapılandırma

Temel Kurulum

connectors:
  airtable:
    enabled: true

    sync:
      records: true
      comments: false

    tables:
      - base_id: "appXXXXXXXXXXXXXX"
        table_name: "Customers"
        view: "Active Customers"
        sync_to_list: 28
      - base_id: "appXXXXXXXXXXXXXX"
        table_name: "Products"
        sync_as: "catalog"

Alan Eşleme

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

field_mapping:
  # Airtable field -> Brevo attribute
  Name: FIRSTNAME
  Email: email
  Phone: SMS
  Company: COMPANY
  Status: LEAD_STATUS
  Revenue: TOTAL_REVENUE
  "Last Contact": LAST_CONTACT_DATE
  Tags: TAGS
  Notes: NOTES
  "Created Time": SIGNUP_DATE

Görünüm Tabanlı Senkronizasyon

views:
  - base_id: "appXXXXXXXXXXXXXX"
    table_name: "Customers"
    view: "High Value"
    sync_to_list: 29
    filter_by_view: true

  - base_id: "appXXXXXXXXXXXXXX"
    table_name: "Customers"
    view: "Churned"
    sync_to_list: 30
    filter_by_view: true

API Uç Noktaları

Tajo, aşağıdaki Airtable Web API uç noktaları ile entegre olur:

Kod Örnekleri

Bağlayıcıyı Başlat

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

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

await tajo.connectors.connect('airtable', {
  token: process.env.AIRTABLE_TOKEN
});

Tabloyu Brevo’ya Senkronize Et

// Sync an Airtable table to a Brevo list
await tajo.connectors.sync('airtable', {
  type: 'full',
  resources: ['records'],
  baseId: 'appXXXXXXXXXXXXXX',
  tableName: 'Customers',
  view: 'Active Customers',
  targetList: 28
});

const status = await tajo.connectors.status('airtable');
console.log(status);
// {
//   connected: true,
//   lastSync: '2024-03-15T15:00:00Z',
//   recordsSynced: 2340,
//   tablesMonitored: 2,
//   basesConnected: 1
// }

Webhook’ları İşle

// Airtable webhooks notify of changes; fetch details with cursor
app.post('/webhooks/airtable', async (req, res) => {
  const { base, webhook, timestamp } = req.body;

  // Fetch changed records using webhook cursor
  const changes = await tajo.connectors.getWebhookPayloads('airtable', {
    baseId: base.id,
    webhookId: webhook.id,
    cursor: timestamp
  });

  for (const change of changes) {
    await tajo.connectors.handleEvent('airtable', {
      type: change.actionType,
      payload: change
    });
  }

  res.status(200).send('OK');
});

Brevo’dan Kayıt Oluştur

// Create an Airtable record when a Brevo contact converts
tajo.events.on('contact.attribute_updated', async (event) => {
  if (event.attribute === 'LIFECYCLE_STAGE' && event.value === 'customer') {
    await tajo.connectors.create('airtable', {
      baseId: 'appXXXXXXXXXXXXXX',
      tableName: 'Customers',
      fields: {
        Name: event.contact.name,
        Email: event.contact.email,
        Status: 'Customer',
        'Converted Date': new Date().toISOString().split('T')[0]
      }
    });
  }
});

Hız Limitleri

Airtable, base başına hız limitleri uygular:

Sorun Giderme

Sık Karşılaşılan Sorunlar

Hata Ayıklama Modu

connectors:
  airtable:
    debug: true
    log_level: verbose
    log_api_calls: true

Bağlantıyı Test Et

tajo connectors test airtable
# ✓ API authentication successful
# ✓ Base access verified
# ✓ Table schema readable
# ✓ Record listing operational
# ✓ Webhook registration available

En İyi Uygulamalar

1. Belirteçleri belirli base’lere kapsamlandırın - Gerekmedikçe tüm base’lere erişim vermeyin
2. Filtrelenmiş senkronizasyon için görünümleri kullanın - Veri hacmini azaltmak için tam tablolar yerine belirli görünümleri senkronize edin
3. Kayıt işlemlerini gruplandırın - Oluşturma ve güncellemeleri 10’luk gruplar halinde yapın
4. Sayfalamayı yönetin - Airtable sayfa başına 100 kayıt döndürür; offset ile yineleyin
5. Gerçek zamanlı için webhook kullanın - Değişiklikler için yoklama yerine webhook kaydedin
6. Alan türlerini kesin şekilde eşleyin - Airtable alan türlerini (seçim, sayı, tarih) Brevo öznitelik türlerine uyarlayın

Güvenlik

• Kişisel Erişim Belirteçleri - Belirli base’lere ve işlemlere kapsamlandırılmış
• OAuth 2.0 - Yenileme belirteçleri ile güvenli yetkilendirme akışı
• Yalnızca HTTPS - Tüm API iletişimi TLS 1.2+ ile şifrelenir
• Base Düzeyinde Erişim Kontrolü - Belirteçler bireysel base’lere kapsamlandırılır
• Şifrelenmiş Depolama - Belirteçler Tajo’da dinlenmede şifrelenir
• Webhook HMAC Doğrulaması - Webhook bildirimlerinin özgünlüğünü doğrulayın

İlgili Kaynaklar

• Notion Bağlayıcısı
• GitHub Bağlayıcısı
• Müşteri Senkronizasyon Yeteneği
• Brevo Kişiler API’si