Σύνδεσμος Notion

Συνδέστε τον χώρο εργασίας Notion σας με το Brevo για ροές εργασίας marketing βάσει περιεχομένου, συγχρονισμό βάσης δεδομένων CRM και αυτοματοποιημένες ειδοποιήσεις μέσω Tajo.

Επισκόπηση

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

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

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

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

1. Χώρο εργασίας Notion με πρόσβαση διαχειριστή
2. Εσωτερική ενσωμάτωση Notion ή εφαρμογή OAuth
3. Σελίδες βάσης δεδομένων κοινοποιημένες με την ενσωμάτωση
4. Λογαριασμό Brevo με πρόσβαση API
5. Λογαριασμό Tajo με ενεργή συνδρομή

Πιστοποίηση

Το Notion υποστηρίζει δύο μεθόδους πιστοποίησης.

Επιλογή 1: Εσωτερική Ενσωμάτωση (Συνιστάται για μεμονωμένο χώρο εργασίας)

1. Μεταβείτε στο notion.so/my-integrations
2. Κάντε κλικ στο New integration
3. Ονομάστε το “Tajo Integration”
4. Επιλέξτε τον χώρο εργασίας σας
5. Ορίστε δυνατότητες:

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

User Capabilities:
  Read user information: ✓

6. Αντιγράψτε το Internal Integration Secret (αρχίζει με ntn_)

Επιλογή 2: OAuth 2.0 (Δημόσιες ενσωματώσεις)

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

1. Εγγράψτε την ενσωμάτωσή σας ως δημόσια ενσωμάτωση
2. Ανακατευθύνετε χρήστες στο: https://api.notion.com/v1/oauth/authorize?client_id=...
3. Ανταλλάξτε τον κώδικα για access token στο /v1/oauth/token

Σύνδεση με Tajo

tajo connectors install notion \
  --token $NOTION_TOKEN

Διαμόρφωση

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

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

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

Αντιστοιχίστε ιδιότητες βάσης δεδομένων Notion σε χαρακτηριστικά επαφών Brevo:

field_mapping:
  # Notion property -> Brevo attribute
  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

Endpoints API

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

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

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

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

Συγχρονισμός Βάσης Δεδομένων με Brevo

// Sync a Notion database to a Brevo list
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
// }

Ερώτημα και Φιλτράρισμα

// Query Notion database with filters
const results = await tajo.connectors.query('notion', {
  databaseId: 'abc123def456',
  filter: {
    property: 'Status',
    select: { equals: 'Active' }
  },
  sorts: [
    { property: 'Last Contact', direction: 'descending' }
  ]
});

Δημιουργία Σελίδας από Εκδήλωση Brevo

// Create a Notion page when a Brevo contact reaches a milestone
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() } }
      }
    });
  }
});

Όρια Ρυθμού

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

Το Notion επιστρέφει 429 Too Many Requests όταν υπερβαίνονται τα όρια ρυθμού, με header Retry-After.

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

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

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

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

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

tajo connectors test notion
# ✓ API authentication successful
# ✓ Database access verified
# ✓ User list accessible
# ✓ Search operational
# ✓ Page creation available

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

1. Κοινοποιείτε βάσεις δεδομένων ρητά - Οι εσωτερικές ενσωματώσεις βλέπουν μόνο κοινοποιημένο περιεχόμενο
2. Χρησιμοποιήστε ερωτήματα βάσης δεδομένων αντί αναζήτησης - Τα ερωτήματα είναι γρηγορότερα και πιο αξιόπιστα για γνωστές βάσεις δεδομένων
3. Αντιστοιχίστε τύπους ιδιοτήτων προσεκτικά - Το Notion έχει πολλούς τύπους ιδιοτήτων· αντιστοιχίστε τους σε τύπους χαρακτηριστικών Brevo
4. Χειριστείτε σελιδοποίηση - Επαναλαμβάνετε πάντα σε όλες τις σελίδες cursor για πλήρη δεδομένα
5. Συγχρονισμός σταδιακά - Χρησιμοποιήστε φίλτρα last_edited_time για συγχρονισμό μόνο αλλαγμένων καταχωρήσεων
6. Ρυθμίστε πρόγραμμα polling - Το Notion δεν υποστηρίζει webhooks εγγενώς· ανακτήστε σε τακτά διαστήματα

Ασφάλεια

• Πιστοποίηση Bearer Token - Secrets ενσωμάτωσης και OAuth tokens
• Μόνο HTTPS - Όλη η επικοινωνία API κρυπτογραφημένη μέσω TLS 1.2+
• Πρόσβαση βάσει scope - Οι ενσωματώσεις έχουν πρόσβαση μόνο σε ρητά κοινοποιημένο περιεχόμενο
• OAuth 2.0 - Ασφαλής ροή εξουσιοδότησης για δημόσιες ενσωματώσεις
• Κρυπτογραφημένη Αποθήκευση - Τα tokens κρυπτογραφούνται σε ηρεμία στο Tajo
• Απομόνωση Χώρου Εργασίας - Κάθε ενσωμάτωση περιορίζεται σε μεμονωμένο χώρο εργασίας

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

• Σύνδεσμος Airtable
• Σύνδεσμος GitHub
• Σύνδεσμος Linear
• API Επαφών Brevo