Supabase Bağlayıcısı

Müşteri etkileşim otomasyonu için veritabanı kayıtlarını, kullanıcı kimlik doğrulama verilerini, dosya depolama olaylarını ve gerçek zamanlı değişiklikleri senkronize etmek üzere Supabase projenizi bağlayın.

Genel Bakış

Özellikler

• Otomatik oluşturulan REST API, PostgREST aracılığıyla herhangi bir Postgres tablosunda CRUD işlemleri, kod gerektirmez
• Kimlik doğrulama kullanıcı senkronizasyonu, Supabase Auth kullanıcılarını (e-posta, telefon, sosyal oturumlar) etkileşim platformunuza senkronize edin
• Gerçek zamanlı abonelikler, Herhangi bir tablodaki INSERT, UPDATE, DELETE olaylarını gerçek zamanlı olarak dinleyin
• Satır Düzeyi Güvenlik, Tüm API erişimi, güvenli çok kiracılı veri için Postgres RLS politikalarına uyar
• Depolama entegrasyonu, Dosya yüklemelerini izleyin ve Depolama kovaları arasında varlıkları yönetin
• Edge Functions, Özel mantık ve webhook’lar için sunucusuz Deno işlevleri çağırın
• Tam metin arama, API aracılığıyla Postgres tam metin arama özelliklerinden yararlanın

Ön Koşullar

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

1. Bir Supabase projesi (app.supabase.com)
2. Projenizin API URL’si ve API anahtarları (Settings → API bölümünde bulunur)
3. API erişimi olan bir Tajo hesabı

Kimlik Doğrulama

Supabase API anahtarı kimlik doğrulaması kullanır. Her istek apikey başlığını gerektirir ve kullanıcı kapsamlı erişim için isteğe bağlı olarak Authorization bearer belirteci gerektirir.

# anon anahtarı kullanma (RLS'ye uyar)
curl 'https://<project_ref>.supabase.co/rest/v1/customers' \
  -H "apikey: <SUPABASE_ANON_KEY>" \
  -H "Authorization: Bearer <SUPABASE_ANON_KEY>"

# service_role anahtarı kullanma (RLS'yi atlar)
curl 'https://<project_ref>.supabase.co/rest/v1/customers' \
  -H "apikey: <SUPABASE_SERVICE_ROLE_KEY>" \
  -H "Authorization: Bearer <SUPABASE_SERVICE_ROLE_KEY>"

Yapılandırma

Temel Kurulum

connectors:
  supabase:
    enabled: true
    project_url: "https://xyzcompany.supabase.co"
    api_key: "${SUPABASE_SERVICE_ROLE_KEY}"

    # Veri senkronizasyon seçenekleri
    sync:
      users: true
      tables:
        - customers
        - orders
        - products
      storage: true
      realtime: true

    # Supabase Auth kullanıcılarını kişilere eşle
    user_mapping:
      email: email
      phone: SMS
      user_metadata.full_name: FIRSTNAME
      created_at: SIGNUP_DATE

Alan Eşleştirme

Supabase tablo sütunlarını etkileşim platformu özniteliklerine eşleyin:

Özel Tablo Eşleştirme

table_mapping:
  customers:
    # Sütun → Öznitelik eşleştirmesi
    email: email
    full_name: FIRSTNAME
    company: COMPANY
    plan: SUBSCRIPTION_PLAN
    mrr: MONTHLY_REVENUE
    created_at: SIGNUP_DATE

  orders:
    # Olay olarak izle
    sync_as: events
    event_name: "order_placed"
    properties:
      total: amount
      status: order_status
      items: line_items

API Uç Noktaları

Supabase REST API’si, veritabanı şemanızdan https://<ref>.supabase.co/rest/v1/ adresinde otomatik olarak oluşturulur.

Filtreleme Operatörleri

Olaylar

Kimlik Doğrulama Olayları

Veritabanı Olayları (Gerçek Zamanlı)

Webhook Olayları

Kod Örnekleri

Bağlayıcıyı Başlatma

import { TajoClient } from '@tajo/sdk';
import { createClient } from '@supabase/supabase-js';

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

// Supabase projesini bağla
await tajo.connectors.connect('supabase', {
  projectUrl: process.env.SUPABASE_URL,
  serviceRoleKey: process.env.SUPABASE_SERVICE_ROLE_KEY,
});

Kullanıcıları Kişilere Senkronize Etme

// Tüm Supabase Auth kullanıcılarını kişi olarak senkronize et
await tajo.connectors.sync('supabase', {
  type: 'full',
  resources: ['users'],
});

// Artımlı senkronizasyon (yalnızca yeni/değişen kullanıcılar)
await tajo.connectors.sync('supabase', {
  type: 'incremental',
  resources: ['users'],
  since: '2024-01-01T00:00:00Z',
});

Gerçek Zamanlı Değişiklikleri Dinleme

// Etkileşim tetikleyicileri için yeni siparişlere abone ol
const supabase = createClient(
  process.env.SUPABASE_URL,
  process.env.SUPABASE_SERVICE_ROLE_KEY
);

supabase
  .channel('orders')
  .on('postgres_changes',
    { event: 'INSERT', schema: 'public', table: 'orders' },
    async (payload) => {
      // Tajo'ya olay olarak ilet
      await tajo.events.track({
        email: payload.new.customer_email,
        event: 'order_placed',
        properties: {
          order_id: payload.new.id,
          total: payload.new.total,
          items: payload.new.line_items,
        },
      });
    }
  )
  .subscribe();

Sorgulama ve Segmentleme

// Hedefli kampanyalar için müşterileri plana göre sorgula
const { data: proUsers } = await supabase
  .from('customers')
  .select('email, full_name, plan, mrr')
  .eq('plan', 'pro')
  .gt('mrr', 100)
  .order('mrr', { ascending: false });

// Kampanya hedefleme için bir Brevo listesine senkronize et
await tajo.lists.addContacts(PRO_LIST_ID, proUsers);

Hız Sınırları

Sorun Giderme

Yaygın Sorunlar

Hata Ayıklama Modu

connectors:
  supabase:
    debug: true
    log_level: verbose
    log_queries: true
    log_realtime: true

Bağlantı Testi

tajo connectors test supabase
# ✓ API bağlantısı başarılı
# ✓ Kimlik doğrulama uç noktası erişilebilir
# ✓ Tablolar okunabilir (12 tablo bulundu)
# ✓ Depolama erişilebilir (3 kova)
# ✓ Gerçek zamanlı bağlantı kuruldu
# ✓ Edge Functions mevcut (4 işlev)

En İyi Uygulamalar

1. service_role anahtarını yalnızca sunucu tarafında kullanın, Asla istemci kodunda ifşa etmeyin
2. Tüm tablolarda RLS’yi etkinleştirin, service_role ile bile, derinlemesine savunma için RLS ile tasarlayın
3. Olay odaklı senkronizasyon için Realtime kullanın, Değişiklikleri yoklamaktan daha verimlidir
4. Toplu işlemler, Yüksek hacimli işlemler için toplu eklemeler ve in filtresini kullanın
5. Kullanıcı meta verilerini eşleyin, Kayıt sırasında etkileşimle ilgili alanları user_metadata içinde saklayın
6. Webhook’lar için Edge Functions kullanın, Düşük gecikmeli işleme için gelen webhook’ları Supabase Edge Functions ile işleyin

Güvenlik

• API Anahtarı Kimlik Doğrulaması, Tüm istekler geçerli API anahtarları gerektirir
• Satır Düzeyi Güvenlik (RLS), Satır başına Postgres yerel erişim kontrolü
• JWT Doğrulaması, Kimlik doğrulama belirteçleri her istekte doğrulanan imzalı JWT’lerdir
• SSL/TLS, Tüm bağlantılar aktarımda şifrelenir
• SOC 2 Type II, Supabase SOC 2 uyumludur
• Ağ Kısıtlamaları, Ücretli planlarda isteğe bağlı IP izin verme

İlgili Kaynaklar

• Shopify Bağlayıcısı
• Stripe Bağlayıcısı
• Auth0 Bağlayıcısı
• Supabase Resmi Belgeleri
• Supabase REST API Kılavuzu
• Supabase Auth Kılavuzu