Notion Bağlayıcısı

İçerik odaklı pazarlama iş akışları, CRM veritabanı senkronizasyonu ve otomatik bildirimler için Notion çalışma alanınızı Tajo üzerinden Brevo’ya bağlayın.

Genel Bakış

Özellikler

• Veritabanı senkronizasyonu - Notion veritabanı girişlerini Brevo kişilerine ve listelerine senkronize edin
• CRM köprüsü - Brevo’ya senkronize edilen hafif bir CRM olarak Notion veritabanlarını kullanın
• İçerik bildirimleri - Notion sayfaları yayınlandığında Brevo kampanyalarını tetikleyin
• Özellik eşleştirme - Notion veritabanı özelliklerini Brevo kişi özniteliklerine eşleyin
• Sayfa izleme - Sayfa güncellemelerini izleyin ve Brevo olayları olarak iletin
• Kullanıcı dizini senkronizasyonu - Notion çalışma alanı üyelerini Brevo kişilerine senkronize edin

Ön Koşullar

Başlamadan önce şunlara sahip olduğunuzdan emin olun:

1. Yönetici erişimi olan bir Notion çalışma alanı
2. Bir Notion dahili entegrasyonu veya OAuth uygulaması
3. Entegrasyonla paylaşılan veritabanı sayfaları
4. API erişimi olan bir Brevo hesabı
5. Etkin aboneliği olan bir Tajo hesabı

Kimlik Doğrulama

Notion iki kimlik doğrulama yöntemini destekler.

Seçenek 1: Dahili Entegrasyon (Tek çalışma alanı için önerilir)

1. notion.so/my-integrations adresine gidin
2. New integration öğesine tıklayın
3. Adını “Tajo Integration” olarak belirleyin
4. Çalışma alanınızı seçin
5. Yetenekleri ayarlayın:

Content Capabilities:
  Read content: ✓
  Update content: ✓
  Insert content: ✓

User Capabilities:
  Read user information: ✓

6. Internal Integration Secret değerini kopyalayın (ntn_ ile başlar)

Seçenek 2: OAuth 2.0 (Herkese açık entegrasyonlar)

Birden fazla çalışma alanına hizmet veren entegrasyonlar için OAuth 2.0 akışını kullanın:

1. Entegrasyonunuzu herkese açık entegrasyon olarak kaydedin
2. Kullanıcıları şuraya yönlendirin: https://api.notion.com/v1/oauth/authorize?client_id=...
3. Kodu /v1/oauth/token üzerinden erişim belirtecine dönüştürün

Tajo’ya Bağlanma

tajo connectors install notion \
  --token $NOTION_TOKEN

Yapılandırma

Temel Kurulum

connectors:
  notion:
    enabled: true
    api_version: "2022-06-28"

    sync:
      databases: true
      pages: false
      users: true

    databases:
      - id: "abc123def456"
        name: "Customers"
        sync_to_list: 25
      - id: "ghi789jkl012"
        name: "Leads"
        sync_to_list: 26

Alan Eşleştirme

Notion veritabanı özelliklerini Brevo kişi özniteliklerine eşleyin:

field_mapping:
  # Notion özelliği -> Brevo özniteliği
  Name:
    type: title
    target: FIRSTNAME
  Email:
    type: email
    target: email
  Phone:
    type: phone_number
    target: SMS
  Company:
    type: rich_text
    target: COMPANY
  Status:
    type: select
    target: LEAD_STATUS
  Deal Value:
    type: number
    target: DEAL_VALUE
  Last Contact:
    type: date
    target: LAST_CONTACT_DATE
  Tags:
    type: multi_select
    target: TAGS

API Uç Noktaları

Tajo, aşağıdaki Notion API uç noktalarıyla entegre olur:

Kod Örnekleri

Bağlayıcıyı Başlatma

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('notion', {
  token: process.env.NOTION_TOKEN
});

Veritabanını Brevo’ya Senkronize Etme

// Bir Notion veritabanını Brevo listesine senkronize et
await tajo.connectors.sync('notion', {
  type: 'full',
  resources: ['databases'],
  databaseId: 'abc123def456',
  targetList: 25
});

const status = await tajo.connectors.status('notion');
console.log(status);
// {
//   connected: true,
//   lastSync: '2024-03-15T14:30:00Z',
//   databasesSynced: 2,
//   pagesTracked: 1450,
//   usersCount: 32
// }

Sorgulama ve Filtreleme

// Notion veritabanını filtrelerle sorgula
const results = await tajo.connectors.query('notion', {
  databaseId: 'abc123def456',
  filter: {
    property: 'Status',
    select: { equals: 'Active' }
  },
  sorts: [
    { property: 'Last Contact', direction: 'descending' }
  ]
});

Brevo Olayından Sayfa Oluşturma

// Bir Brevo kişisi bir kilometre taşına ulaştığında Notion sayfası oluştur
tajo.events.on('contact.attribute_updated', async (event) => {
  if (event.attribute === 'LIFECYCLE_STAGE' && event.value === 'customer') {
    await tajo.connectors.create('notion', {
      databaseId: 'ghi789jkl012',
      properties: {
        Name: { title: [{ text: { content: event.contact.name } }] },
        Email: { email: event.contact.email },
        'Converted Date': { date: { start: new Date().toISOString() } }
      }
    });
  }
});

Hız Sınırları

Notion, entegrasyon başına hız sınırları uygular:

Hız sınırları aşıldığında Notion, Retry-After başlığıyla birlikte 429 Too Many Requests döndürür.

Sorun Giderme

Yaygın Sorunlar

Hata Ayıklama Modu

connectors:
  notion:
    debug: true
    log_level: verbose
    log_api_calls: true

Bağlantı Testi

tajo connectors test notion
# ✓ API kimlik doğrulaması başarılı
# ✓ Veritabanı erişimi doğrulandı
# ✓ Kullanıcı listesi erişilebilir
# ✓ Arama çalışır durumda
# ✓ Sayfa oluşturma kullanılabilir

En İyi Uygulamalar

1. Veritabanlarını açıkça paylaşın - Dahili entegrasyonlar yalnızca paylaşılan içeriği görür
2. Arama yerine veritabanı sorgularını kullanın - Bilinen veritabanları için sorgular daha hızlı ve güvenilirdir
3. Özellik türlerini dikkatli eşleyin - Notion’da birçok özellik türü vardır; bunları Brevo öznitelik türleriyle eşleştirin
4. Sayfalamayı yönetin - Eksiksiz veri için her zaman tüm imleç sayfalarında yineleyin
5. Artımlı senkronize edin - Yalnızca değişen girişleri senkronize etmek için last_edited_time filtrelerini kullanın
6. Bir yoklama programı ayarlayın - Notion, yerel olarak webhook desteklemez; düzenli aralıklarla yoklayın

Güvenlik

• Bearer Belirteç Kimlik Doğrulaması - Entegrasyon gizli anahtarları ve OAuth belirteçleri
• Yalnızca HTTPS - Tüm API iletişimi TLS 1.2+ ile şifrelenir
• Kapsamlı Erişim - Entegrasyonlar yalnızca açıkça paylaşılan içeriğe erişir
• OAuth 2.0 - Herkese açık entegrasyonlar için güvenli yetkilendirme akışı
• Şifreli Depolama - Belirteçler Tajo’da şifreli olarak saklanır
• Çalışma Alanı İzolasyonu - Her entegrasyon tek bir çalışma alanına kapsamlandırılır

İlgili Kaynaklar

• Airtable Bağlayıcısı
• GitHub Bağlayıcısı
• Linear Bağlayıcısı
• Brevo Kişiler API