---
title: "Notion konnektor"
description: "Teljes Notion integrációs útmutató adatbázisok, oldalak és munkaterület-tartalom Brevóval való szinkronizációjához a Tajo segítségével."
url: https://tajo.io/hu/docs/connectors/custom/notion/
markdown: https://tajo.io/hu/docs/connectors/custom/notion.md
lang: hu-HU
robots: noindex
---

Kérj korai hozzáférést

Adja meg keresztnevét és munkahelyi e-mail-címét. Küldünk egy hivatkozást, amellyel megerősítheti a Tajo-hozzáférési kérelmét.

# Notion konnektor

Konnektor állapota: Tervezett Még nem készült el. A Tajo ma nem futtatja ezt a konnektort.

| Forrásmező | Célmező | Mintaérték |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Csatlakoztasd a Notion munkaterületedet a Brevóhoz tartalomalapú marketing munkafolyamatokhoz, CRM adatbázis-szinkronizáláshoz és automatizált értesítésekhez a Tajo segítségével.

## Áttekintés

| Tulajdonság | Érték |
| --- | --- |
| **Platform** | Notion |
| **Kategória** | Egyéni |
| **Telepítés bonyolultsága** | Könnyű |
| **Hivatalos integráció** | Nem |
| **Szinkronizált adatok** | Adatbázisok, Oldalak, Felhasználók |
| **API típus** | REST API |
| **Hitelesítés** | Belső integrációs token / OAuth 2.0 |
| **Alap URL** | `https://api.notion.com` |
| **API verzió** | `2022-06-28` (a `Notion-Version` fejléc alapján) |

## Funkciók

- **Adatbázis-szinkronizáció** – Notion adatbázis-bejegyzések szinkronizálása Brevo kapcsolatokba és listákba
- **CRM híd** – Notion adatbázisok könnyű CRM-ként való használata, szinkronizálva a Brevóval
- **Tartalom-értesítések** – Brevo kampányok indítása Notion oldalak közzétételekor
- **Tulajdonság-leképezés** – Notion adatbázis-tulajdonságok leképezése Brevo kapcsolat-attribútumokhoz
- **Oldal-figyelés** – Oldalfrissítések követése és továbbítása Brevo eseményekként
- **Felhasználói könyvtár-szinkronizáció** – Notion munkaterület tagok szinkronizálása Brevo kapcsolatokba

## Előfeltételek

Mielőtt elkezdenéd, győződj meg róla, hogy rendelkezel:

1. Egy Notion munkaterülettel adminisztrátori hozzáféréssel
2. Egy Notion belső integrációval vagy OAuth alkalmazással
3. Az integrációval megosztott adatbázis-oldalakkal
4. Egy Brevo fiókkal API-hozzáféréssel
5. Egy Tajo fiókkal aktív előfizetéssel

## Hitelesítés

A Notion két hitelesítési módszert támogat.

### 1. lehetőség: Belső integráció (egyetlen munkaterülethez ajánlott)

1. Menj a [notion.so/my-integrations](https://www.notion.so/my-integrations) oldalra
2. Kattints a **New integration** gombra
3. Nevezd el „Tajo Integration”-nek
4. Válaszd ki a munkaterületedet
5. Állítsd be a képességeket:

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

User Capabilities:
  Read user information: ✓
```

6. Másold ki a **Internal Integration Secret** kódot (ntn\_-nel kezdődik)

Oldal megosztás szükséges

A belső integrációk csak az azokkal explicit módon megosztott oldalakhoz és adatbázisokhoz férhetnek hozzá. Oszd meg minden célzott adatbázist az integrációddal a ”…” menü > “Connections” > integráció kiválasztása útján.

### 2. lehetőség: OAuth 2.0 (nyilvános integrációk)

Több munkaterületet kiszolgáló integrációkhoz használd az OAuth 2.0 folyamot:

1. Regisztráld az integrációdat nyilvános integrációként
2. Irányítsd a felhasználókat ide: `https://api.notion.com/v1/oauth/authorize?client_id=...`
3. Cseréld ki a kódot hozzáférési tokenre a `/v1/oauth/token` végponton

### Csatlakozás a Tajóhoz

```bash
tajo connectors install notion \
  --token $NOTION_TOKEN
```

## Konfiguráció

### Alapbeállítás

```yaml
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
```

### Mezőleképezés

Képezd le a Notion adatbázis-tulajdonságokat Brevo kapcsolat-attribútumokhoz:

```yaml
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
```

## API végpontok

A Tajo az alábbi Notion API végpontokkal integrálódik:

| Végpont | Módszer | Cél |
| --- | --- | --- |
| `/v1/databases/{id}/query` | POST | Adatbázis-bejegyzések lekérdezése |
| `/v1/databases/{id}` | GET | Adatbázis-séma lekérése |
| `/v1/pages` | POST | Új oldal létrehozása |
| `/v1/pages/{id}` | GET | Oldal tulajdonságainak lekérése |
| `/v1/pages/{id}` | PATCH | Oldal tulajdonságainak frissítése |
| `/v1/blocks/{id}/children` | GET | Blokk gyermekek lekérése |
| `/v1/users` | GET | Az összes munkaterület-felhasználó listázása |
| `/v1/users/{id}` | GET | Felhasználó lekérése |
| `/v1/search` | POST | Keresés a munkaterületen |

## Kódpéldák

### A konnektor inicializálása

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

### Adatbázis szinkronizálása a Brevóba

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

### Lekérdezés és szűrés

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

### Oldal létrehozása Brevo eseményből

```javascript
// 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() } }
      }
    });
  }
});
```

## Ráta-korlátok

A Notion integrációnként alkalmaz ráta-korlátokat:

| Korlát típusa | Érték |
| --- | --- |
| **Ráta-korlát** | 3 kérés/másodperc integrációnként |
| **Burst korlát** | Rövid burst megengedett, majd szabályozás |
| **Oldal mérete** | Max. 100 elem oldalazott kérésenként |

Kurzor alapú oldalazás

A Notion kurzor alapú oldalazást használ. A Tajo ezt automatikusan kezeli, iterálva az összes oldalon a `next_cursor` paraméter segítségével, amíg a `has_more` hamis értéket nem ad vissza.

A Notion `429 Too Many Requests` választ ad vissza a ráta-korlátok túllépésekor, a `Retry-After` fejléccel.

## Hibaelhárítás

### Gyakori problémák

| Probléma | Ok | Megoldás |
| --- | --- | --- |
| 401 Unauthorized | Érvénytelen vagy lejárt token | Generáld újra az integrációs tokent |
| 403 Forbidden | Az oldal nincs megosztva az integrációval | Oszd meg az oldalt/adatbázist az integrációval a Connections menüponton keresztül |
| 404 Object not found | Helytelen adatbázis azonosító vagy nincs megosztva | Ellenőrizd az adatbázis azonosítót és a megosztási beállításokat |
| Hiányzó tulajdonságok | Séma eltérés | Szinkronizáld újra az adatbázis-sémát és frissítsd a mezőleképezést |
| Ráta-korlát túllépve | Túl sok gyors kérés | Csökkentsd a szinkronizálás gyakoriságát vagy a köteg méretét |

### Hibakeresési mód

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

### Kapcsolat tesztelése

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

## Legjobb gyakorlatok

1. **Oszd meg explicit módon az adatbázisokat** – A belső integrációk csak a megosztott tartalmakat látják
2. **Adatbázis lekérdezéseket használj keresés helyett** – Az ismert adatbázisokhoz a lekérdezések gyorsabbak és megbízhatóbbak
3. **Gondosan képezd le a tulajdonság típusokat** – A Notionnak sok tulajdonság típusa van; illesszd össze ezeket a Brevo attribútum típusokkal
4. **Kezelj oldalazást** – Mindig iterálj az összes kurzoros oldalon a teljes adatokért
5. **Szinkronizálj növekményesen** – Csak a módosított bejegyzések szinkronizálásához használj `last_edited_time` szűrőket
6. **Állíts be lekérdezési ütemezést** – A Notion nem támogatja natívan a webhookokat; rendszeres időközönként kérdezz le

## Biztonság

- **Bearer Token hitelesítés** – Integrációs titkok és OAuth tokenek
- **Csak HTTPS** – Minden API kommunikáció TLS 1.2+-on keresztül titkosítva
- **Hatókörrel korlátozott hozzáférés** – Az integrációk csak az explicit módon megosztott tartalmakhoz férnek hozzá
- **OAuth 2.0** – Biztonságos engedélyezési folyam nyilvános integrációkhoz
- **Titkosított tárolás** – A tokenek titkosítva tárolódnak a Tajóban
- **Munkaterület izoláció** – Minden integráció egyetlen munkaterületre korlátozott

## Kapcsolódó források

- [Airtable konnektor](https://tajo.io/hu/docs/connectors/custom/airtable)
- [GitHub konnektor](https://tajo.io/hu/docs/connectors/custom/github)
- [Linear konnektor](https://tajo.io/hu/docs/connectors/custom/linear)
- [Brevo Contacts API](https://tajo.io/hu/docs/contact-management)