Supabase कनेक्टर

customer engagement automation के लिए database records, user authentication data, file storage events, और real-time changes sync करने हेतु अपने Supabase project को कनेक्ट करें।

अवलोकन

विशेषताएं

• Auto-generated REST API, PostgREST के माध्यम से किसी भी Postgres table पर CRUD operations, बिना किसी code के
• Auth user sync, Supabase Auth users (email, phone, social logins) को अपने engagement platform से sync करें
• Real-time subscriptions, किसी भी table पर INSERT, UPDATE, DELETE events को real-time में सुनें
• Row Level Security, सभी API access secure multi-tenant data के लिए Postgres RLS policies का सम्मान करता है
• Storage integration, file uploads ट्रैक करें और Storage buckets में assets manage करें
• Edge Functions, custom logic और webhooks के लिए serverless Deno functions invoke करें
• Full-text search, API के माध्यम से Postgres full-text search capabilities का लाभ उठाएं

पूर्वावश्यकताएं

शुरू करने से पहले, सुनिश्चित करें कि आपके पास हैं:

1. एक Supabase project (app.supabase.com)
2. आपके project का API URL और API keys (Settings → API में पाया जाता है)
3. API access वाला एक Tajo account

प्रमाणीकरण

Supabase API key authentication का उपयोग करता है। हर request के लिए apikey header आवश्यक है और user-scoped access के लिए वैकल्पिक रूप से एक Authorization bearer token।

# anon key का उपयोग (RLS का सम्मान करती है)
curl 'https://<project_ref>.supabase.co/rest/v1/customers' \
  -H "apikey: <SUPABASE_ANON_KEY>" \
  -H "Authorization: Bearer <SUPABASE_ANON_KEY>"

# service_role key का उपयोग (RLS को bypass करती है)
curl 'https://<project_ref>.supabase.co/rest/v1/customers' \
  -H "apikey: <SUPABASE_SERVICE_ROLE_KEY>" \
  -H "Authorization: Bearer <SUPABASE_SERVICE_ROLE_KEY>"

कॉन्फ़िगरेशन

बेसिक सेटअप

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

    # Data sync options
    sync:
      users: true
      tables:
        - customers
        - orders
        - products
      storage: true
      realtime: true

    # Supabase Auth users को contacts से map करें
    user_mapping:
      email: email
      phone: SMS
      user_metadata.full_name: FIRSTNAME
      created_at: SIGNUP_DATE

Field Mapping

Supabase table columns को engagement platform attributes से map करें:

Custom Table Mapping

table_mapping:
  customers:
    # Column → Attribute mapping
    email: email
    full_name: FIRSTNAME
    company: COMPANY
    plan: SUBSCRIPTION_PLAN
    mrr: MONTHLY_REVENUE
    created_at: SIGNUP_DATE

  orders:
    # events के रूप में ट्रैक करें
    sync_as: events
    event_name: "order_placed"
    properties:
      total: amount
      status: order_status
      items: line_items

API Endpoints

Supabase REST API आपके database schema से https://<ref>.supabase.co/rest/v1/ पर auto-generated होता है।

Filtering Operators

Events

Auth Events

Database Events (Realtime)

Webhook Events

कोड उदाहरण

कनेक्टर शुरू करें

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

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

// Supabase project कनेक्ट करें
await tajo.connectors.connect('supabase', {
  projectUrl: process.env.SUPABASE_URL,
  serviceRoleKey: process.env.SUPABASE_SERVICE_ROLE_KEY,
});

Users को Contacts से Sync करें

// सभी Supabase Auth users को contacts के रूप में sync करें
await tajo.connectors.sync('supabase', {
  type: 'full',
  resources: ['users'],
});

// Incremental sync (केवल नए/बदले गए users)
await tajo.connectors.sync('supabase', {
  type: 'incremental',
  resources: ['users'],
  since: '2024-01-01T00:00:00Z',
});

Real-time Changes सुनें

// engagement triggers के लिए नए orders की subscribe करें
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 को एक event के रूप में forward करें
      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();

Query और Segment

// targeted campaigns के लिए plan द्वारा customers क्वेरी करें
const { data: proUsers } = await supabase
  .from('customers')
  .select('email, full_name, plan, mrr')
  .eq('plan', 'pro')
  .gt('mrr', 100)
  .order('mrr', { ascending: false });

// campaign targeting के लिए Brevo list से sync करें
await tajo.lists.addContacts(PRO_LIST_ID, proUsers);

Rate Limits

समस्या निवारण

सामान्य समस्याएं

Debug Mode

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

Connection Test करें

tajo connectors test supabase
# ✓ API connection successful
# ✓ Auth endpoint accessible
# ✓ Tables readable (12 tables found)
# ✓ Storage accessible (3 buckets)
# ✓ Realtime connection established
# ✓ Edge Functions available (4 functions)

सर्वोत्तम प्रथाएं

1. service_role key केवल server-side उपयोग करें, इसे client code में कभी expose न करें
2. सभी tables पर RLS enable करें, service_role के साथ भी, defense in depth के लिए RLS के साथ design करें
3. Event-driven sync के लिए Realtime का उपयोग करें, changes के लिए polling की तुलना में अधिक efficient
4. Operations को batch करें, high-volume operations के लिए bulk inserts और in filter का उपयोग करें
5. User metadata map करें, signup के दौरान engagement-relevant fields को user_metadata में store करें
6. Webhooks के लिए Edge Functions का उपयोग करें, low-latency handling के लिए Supabase Edge Functions के साथ incoming webhooks process करें

सुरक्षा

• API Key Authentication, सभी requests के लिए valid API keys आवश्यक
• Row Level Security (RLS), प्रति row Postgres-native access control
• JWT Verification, Auth tokens signed JWTs हैं जो हर request पर verified होते हैं
• SSL/TLS, transit में सभी connections encrypted
• SOC 2 Type II, Supabase SOC 2 compliant है
• Network Restrictions, paid plans पर Optional IP allowlisting

संबंधित संसाधन

• Shopify कनेक्टर
• Stripe कनेक्टर
• Auth0 कनेक्टर
• Supabase Official Docs
• Supabase REST API Guide
• Supabase Auth Guide