Σύνδεσμος Airtable

Συνδέστε τις βάσεις Airtable σας με το Brevo για συγχρονισμό CRM, διαχείριση καταλόγου προϊόντων και αυτοματοποιημένες ροές εργασίας marketing που τροφοδοτούνται από δομημένα δεδομένα μέσω Tajo.

Επισκόπηση

Χαρακτηριστικά

• Συγχρονισμός πίνακα σε λίστα - Συγχρονισμός εγγραφών πίνακα Airtable απευθείας σε λίστες επαφών Brevo
• Γέφυρα καταλόγου προϊόντων - Χρήση πινάκων Airtable ως κατάλογοι προϊόντων για προτάσεις email
• Συγχρονισμός CRM - Αμφίδρομος συγχρονισμός μεταξύ CRM Airtable και επαφών Brevo
• Εκδηλώσεις υποβολής φόρμας - Προώθηση υποβολών φόρμας Airtable ως εκδηλώσεις Brevo
• Φιλτράρισμα βάσει προβολής - Συγχρονισμός συγκεκριμένων προβολών Airtable σε στοχευμένες λίστες Brevo
• Αυτοματοποίηση webhook - Ενεργοποίηση καμπανιών Brevo όταν αλλάζουν εγγραφές Airtable

Προαπαιτούμενα

Πριν ξεκινήσετε, βεβαιωθείτε ότι διαθέτετε:

1. Λογαριασμό Airtable (δωρεάν πλάνο ή ανώτερο)
2. Ρυθμισμένο Personal Access Token ή εφαρμογή OAuth
3. Πρόσβαση στις βάσεις και τους πίνακες που θέλετε να συγχρονίσετε
4. Λογαριασμό Brevo με πρόσβαση API
5. Λογαριασμό Tajo με ενεργή συνδρομή

Πιστοποίηση

Το Airtable υποστηρίζει Personal Access Tokens και OAuth 2.0.

Επιλογή 1: Personal Access Token (Συνιστάται)

1. Μεταβείτε στο airtable.com/create/tokens
2. Κάντε κλικ στο Create new token
3. Ονομάστε το “Tajo Integration”
4. Προσθέστε scopes:

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

5. Προσθέστε πρόσβαση σε συγκεκριμένες βάσεις ή σε όλες τις βάσεις
6. Κάντε κλικ στο Create token

Επιλογή 2: OAuth 2.0

Για ενσωματώσεις πολλαπλών χρηστών, χρησιμοποιήστε τη ροή OAuth 2.0:

1. Εγγράψτε την ενσωμάτωσή σας στο airtable.com/create/oauth
2. Ρυθμίστε URI ανακατεύθυνσης: https://app.tajo.io/callbacks/airtable
3. Ζητήστε τα ίδια scopes όπως παραπάνω

Σύνδεση με Tajo

tajo connectors install airtable \
  --token $AIRTABLE_TOKEN

Διαμόρφωση

Βασική Ρύθμιση

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"

Αντιστοίχιση Πεδίων

Αντιστοιχίστε πεδία Airtable σε χαρακτηριστικά επαφών Brevo:

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

Συγχρονισμός Βάσει Προβολής

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

Endpoints API

Το Tajo ενσωματώνεται με τα παρακάτω endpoints Airtable Web API:

Παραδείγματα Κώδικα

Αρχικοποίηση Συνδέσμου

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
});

Συγχρονισμός Πίνακα με Brevo

// 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
// }

Χειρισμός Webhooks

// 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

// 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]
      }
    });
  }
});

Όρια Ρυθμού

Το Airtable επιβάλλει όρια ρυθμού ανά βάση:

Αντιμετώπιση Προβλημάτων

Συνηθισμένα Προβλήματα

Λειτουργία Εντοπισμού Σφαλμάτων

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

Δοκιμή Σύνδεσης

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

Βέλτιστες Πρακτικές

1. Περιορίστε tokens σε συγκεκριμένες βάσεις - Μην παραχωρείτε πρόσβαση σε όλες τις βάσεις εκτός αν είναι απαραίτητο
2. Χρησιμοποιήστε προβολές για φιλτραρισμένο συγχρονισμό - Συγχρονίστε συγκεκριμένες προβολές αντί πλήρων πινάκων για μείωση όγκου δεδομένων
3. Ομαδοποίηση λειτουργιών εγγραφής - Ομαδοποιήστε δημιουργίες και ενημερώσεις σε batches των 10
4. Χειριστείτε σελιδοποίηση - Το Airtable επιστρέφει 100 εγγραφές ανά σελίδα· επαναλάβετε με offset
5. Χρησιμοποιήστε webhooks για πραγματικό χρόνο - Εγγράψτε webhooks αντί polling για αλλαγές
6. Αντιστοιχίστε τύπους πεδίων ακριβώς - Αντιστοιχίστε τύπους πεδίων Airtable (select, number, date) σε τύπους χαρακτηριστικών Brevo

Ασφάλεια

• Personal Access Tokens - Περιορισμένα σε συγκεκριμένες βάσεις και λειτουργίες
• OAuth 2.0 - Ασφαλής ροή εξουσιοδότησης με refresh tokens
• Μόνο HTTPS - Όλη η επικοινωνία API κρυπτογραφημένη μέσω TLS 1.2+
• Έλεγχος Πρόσβασης σε Επίπεδο Βάσης - Tokens περιορισμένα σε μεμονωμένες βάσεις
• Κρυπτογραφημένη Αποθήκευση - Τα tokens κρυπτογραφούνται σε ηρεμία στο Tajo
• Επαλήθευση HMAC Webhook - Επαλήθευση αυθεντικότητας ειδοποίησης webhook

Σχετικοί Πόροι

• Σύνδεσμος Notion
• Σύνδεσμος GitHub
• Δεξιότητα Συγχρονισμού Πελατών
• API Επαφών Brevo