Supabase-kobling

Koble Supabase-prosjektet ditt for å synkronisere databaseposter, brukerautentiseringsdata, fillagringshendelser og sanntidsendringer for automatisering av kundeengasjement.

Oversikt

Funksjoner

• Autogenerert REST API, CRUD-operasjoner på enhver Postgres-tabell via PostgREST, ingen kode kreves
• Synkronisering av Auth-brukere, Synkroniser Supabase Auth-brukere (e-post, telefon, sosial innlogging) til engasjementsplattformen din
• Sanntidsabonnementer, Lytt på INSERT-, UPDATE- og DELETE-hendelser på enhver tabell i sanntid
• Row Level Security, All API-tilgang respekterer Postgres RLS-policyer for sikre data med flere tenanter
• Lagringsintegrasjon, Spor filopplastinger og administrer ressurser på tvers av Storage-bøtter
• Edge Functions, Kall serverløse Deno-funksjoner for egendefinert logikk og webhooks
• Fulltekstsøk, Utnytt Postgres’ fulltekstsøkfunksjoner gjennom API-et

Forutsetninger

Før du begynner, sørg for at du har:

1. Et Supabase-prosjekt (app.supabase.com)
2. Prosjektets API URL og API-nøkler (finnes i Settings → API)
3. En Tajo-konto med API-tilgang

Autentisering

Supabase bruker API-nøkkelautentisering. Hver forespørsel krever apikey-headeren og valgfritt et Authorization-bearer-token for brukeravgrenset tilgang.

# Bruk av anon-nøkkel (respekterer RLS)
curl 'https://<project_ref>.supabase.co/rest/v1/customers' \
  -H "apikey: <SUPABASE_ANON_KEY>" \
  -H "Authorization: Bearer <SUPABASE_ANON_KEY>"

# Bruk av service_role-nøkkel (omgår RLS)
curl 'https://<project_ref>.supabase.co/rest/v1/customers' \
  -H "apikey: <SUPABASE_SERVICE_ROLE_KEY>" \
  -H "Authorization: Bearer <SUPABASE_SERVICE_ROLE_KEY>"

Konfigurasjon

Grunnleggende oppsett

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

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

    # Mapp Supabase Auth-brukere til kontakter
    user_mapping:
      email: email
      phone: SMS
      user_metadata.full_name: FIRSTNAME
      created_at: SIGNUP_DATE

Feltmapping

Mapp Supabase-tabellkolonner til engasjementsplattformattributter:

Egendefinert tabellmapping

table_mapping:
  customers:
    # Kolonne → attributt-mapping
    email: email
    full_name: FIRSTNAME
    company: COMPANY
    plan: SUBSCRIPTION_PLAN
    mrr: MONTHLY_REVENUE
    created_at: SIGNUP_DATE

  orders:
    # Spor som hendelser
    sync_as: events
    event_name: "order_placed"
    properties:
      total: amount
      status: order_status
      items: line_items

API-endepunkter

Supabases REST API genereres automatisk fra databaseskjemaet ditt på https://<ref>.supabase.co/rest/v1/.

Filteroperatorer

Hendelser

Auth-hendelser

Databasehendelser (Realtime)

Webhook-hendelser

Kodeeksempler

Initialiser kobling

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

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

// Koble til Supabase-prosjekt
await tajo.connectors.connect('supabase', {
  projectUrl: process.env.SUPABASE_URL,
  serviceRoleKey: process.env.SUPABASE_SERVICE_ROLE_KEY,
});

Synkroniser brukere til kontakter

// Synkroniser alle Supabase Auth-brukere som kontakter
await tajo.connectors.sync('supabase', {
  type: 'full',
  resources: ['users'],
});

// Inkrementell synkronisering (kun nye/endrede brukere)
await tajo.connectors.sync('supabase', {
  type: 'incremental',
  resources: ['users'],
  since: '2024-01-01T00:00:00Z',
});

Lytt til sanntidsendringer

// Abonner på nye bestillinger for engasjementsutløsere
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) => {
      // Videresend til Tajo som en hendelse
      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();

Spør og segmenter

// Spør kunder etter plan for målrettede kampanjer
const { data: proUsers } = await supabase
  .from('customers')
  .select('email, full_name, plan, mrr')
  .eq('plan', 'pro')
  .gt('mrr', 100)
  .order('mrr', { ascending: false });

// Synkroniser til en Brevo-liste for kampanjemålretting
await tajo.lists.addContacts(PRO_LIST_ID, proUsers);

Ratebegrensninger

Feilsøking

Vanlige problemer

Feilsøkingsmodus

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

Test tilkobling

tajo connectors test supabase
# ✓ API-tilkobling vellykket
# ✓ Auth-endepunkt tilgjengelig
# ✓ Tabeller lesbare (12 tabeller funnet)
# ✓ Lagring tilgjengelig (3 bøtter)
# ✓ Realtime-tilkobling etablert
# ✓ Edge Functions tilgjengelig (4 funksjoner)

Beste praksis

1. Bruk service_role-nøkkel kun på tjenersiden, Eksponer den aldri i klientkode
2. Aktiver RLS på alle tabeller, Selv med service_role, design med RLS for dybdeforsvar
3. Bruk Realtime for hendelsesdrevet synkronisering, Mer effektivt enn polling for endringer
4. Batch-operasjoner, Bruk bulk-innsettinger og in-filter for operasjoner med stort volum
5. Mapp brukermetadata, Lagre engasjementsrelevante felt i user_metadata ved registrering
6. Bruk Edge Functions for webhooks, Behandle innkommende webhooks med Supabase Edge Functions for lav-latens-håndtering

Sikkerhet

• API-nøkkelautentisering, Alle forespørsler krever gyldige API-nøkler
• Row Level Security (RLS), Postgres-nativ tilgangskontroll per rad
• JWT-verifisering, Auth-tokens er signerte JWT-er verifisert på hver forespørsel
• SSL/TLS, Alle tilkoblinger er kryptert under transport
• SOC 2 Type II, Supabase er SOC 2-kompatibel
• Nettverksrestriksjoner, Valgfri IP-hviteliste på betalte planer

Relaterte ressurser

• Shopify-kobling
• Stripe-kobling
• Auth0-kobling
• Supabases offisielle dokumentasjon
• Supabase REST API-veiledning
• Supabase Auth-veiledning