Bu rehberde: İş akışınızdaki öğeleri bir Notion veritabanına yeni satır olarak eklersiniz. Notion'da bir entegrasyon oluşturur, veritabanınızı onunla paylaşır ve anahtarı OrqLabs'a girersiniz.

⏱ 10 dakika

Kimlik kartı

Alan	Değer
Sağlayıcı anahtarı	`NOTION`
Kategori	CRM ve veri
Kimlik doğrulama	Token (internal integration secret)
Kapsam	Organizasyon geneli
Webhook	Hayır
Yetenekler	CRM aktarımı
Kullanan kutular	CRM'e yaz (`leads.crmSync`)
Kullanan ajanlar	Doğrudan yok; Report Writer ve Content Creator çıktıları kutu üzerinden yazılır

Ne işe yarar?

Nitelikli adayları Notion CRM veritabanına düşürmek.
Content Creator taslaklarını "İçerik takvimi" veritabanına yazmak.
Rapor özetlerini haftalık rapor veritabanına eklemek.

Her öğe bir sayfa (satır) olur; eşlemedeki her anahtar bir özelliğe yazılır.

Ön koşullar

Notion çalışma alanı ve entegrasyon oluşturma izni. Ücretsiz plan yeterlidir.
OrqLabs'ta Sahip veya Yönetici rolü.

Adım adım kurulum

A) Notion entegrasyonu

Notion – internal integration: ① Integration name, ② Associated workspace, ③ Type: Internal. (Temsili görsel)

notion.so/profile/integrations → New integration.
① Ad: OrqLabs; ② çalışma alanı; ③ Type: Internal → Save.

Notion – secret ve yetenekler: ① Internal Integration Secret, ② 3 içerik yeteneği, ③ Connections. (Temsili görsel)

② Capabilities: Read content, Update content, Insert content → Save changes.
① Internal Integration Secret → Show → Copy. ntn_… ile başlar (eskiler secret_…).

B) Veritabanını paylaşma

Notion'da entegrasyonlar varsayılan olarak hiçbir sayfayı göremez.

Hedef veritabanını açın.
Sağ üstteki ⋯ → Connections → Connect to → OrqLabs → Confirm.
③ Veritabanı kimliği: adres https://www.notion.so/<alan>/<Ad>-<32 karakter>?v=<görünüm>. ?v= öncesindeki 32 karakter Database ID'dir.

C) OrqLabs'ta bağlama

OrqLabs bağlantı penceresi (Notion): ① Internal integration token, ② organizasyon kapsamlı, ③ Bağla. (Temsili görsel)

Entegrasyonlar → Notion → Bağla. ② Organizasyon geneli.
① Internal integration token alanına yapıştırın.
③ Bağla. OrqLabs bot kullanıcısını okuyarak doğrular.
CRM'e yaz kutusunda Bağlı hesap Notion; Target alanına Database ID; Field mapping alanına eşleme.

Bağlantı penceresi (token): ① alan, ③ Bağla, ④ yan panelde kurulum rehberi.

Özellik türü eşlemesi

Eşleme anahtarları özellik adlarıyla birebir eşleşmelidir (Türkçe karakter dahil).

Notion türü	Beklenen değer	Örnek
`title`	Metin	`"Ad": "{{ $json.name }}"`
`rich_text`	Metin (2.000 karakterde kırpılır)	`"Not": "{{ $json.summary }}"`
`email`	Geçerli e-posta	`"E-posta": "{{ $json.email }}"`
`phone_number`	Metin	`"Telefon": "{{ $json.phone }}"`
`number`	Sayı	`"Puan": "{{ $json.score }}"`
`select`	Seçenek adı (yoksa oluşturulur)	`"Durum": "{{ $json.status }}"`
`multi_select`	Virgülle ayrılmış	`"Etiketler": "{{ $json.tags }}"`
`url`	Tam adres	`"Web": "{{ $json.website }}"`
`date`	ISO tarih	`"Eklenme": "{{ $now }}"`
`checkbox`	`true` / `false`	`"Nitelikli": "true"`

title zorunludur.
relation, people, files, formula türlerine yazılmaz.
Güncelleme e-posta özelliğine göre arama ile yapılır; yoksa yeni sayfa oluşur.
Birden fazla veri kaynağı içeren veritabanlarında sorun olursa tek kaynaklı veritabanı kullanın.

Limitler

Konu	Sınır
İstek hızı	Saniyede ortalama 3
Sayfa oluşturma	İstek başına 1; 100 öğe ~35-40 sn
`rich_text`	2.000 karakter

Bağlantıyı test etme

Entegrasyon ayrıntı paneli: ① durum, ② Bağlantıyı test et, ⑤ Bağlantıyı kes.

② Bağlantıyı test et entegrasyon ve çalışma alanı adını döndürür; veritabanı erişimini doğrulamaz. İş akışını tek öğeyle test edin; çıktıda oluşan sayfanın adresi döner.

Kimlik bilgilerini yenileme

Secret süresizdir. Configuration → Refresh ile yenilediğinizde eskisi anında geçersiz olur; hemen Kimlik bilgileri → Güncelle ile girin.
Bir veritabanının bağlantısını kaldırmak yalnızca o sayfaya erişimi keser.

Sık karşılaşılan hatalar

Hata	Olası neden	Çözüm
`AUTH` – 401 "API token is invalid"	Secret yanlış veya yenilenmiş	Yeniden alın
`INVALID` – 404 "Could not find database"	Paylaşılmamış veya kimlik yanlış	Connections → OrqLabs; `?v=` öncesini alın
`INVALID` – "is not a property that exists"	Özellik adı uyuşmuyor	Birebir yazın
`INVALID` – "should be a number / valid email / date"	Tür uyuşmazlığı	İfadeyi düzeltin
`AUTH` – 403 `restricted_resource`	Insert content kapalı	Yeteneği açın
`RATE_LIMIT` – 429	Saniyede 3 aşıldı	Bekleme artırın

Sık sorulan sorular

Ücretsiz Notion yeterli mi? Evet.

Entegrasyon tüm çalışma alanımı görür mü? Hayır. Yalnızca açıkça bağladığınız sayfaları ve altlarını görür.

Notion

Kimlik kartı

Ne işe yarar?

Ön koşullar