Notion Node

Notion node'u, SkyStudio workflow'larında Notion çalışma alanınızla entegrasyon sağlar. Sayfa ve veritabanı kayıtlarını okuyabilir, yeni sayfa oluşturabilir, mevcut sayfalara içerik ekleyebilir ve AI destekli sorgular çalıştırabilirsiniz.

---

Bağlantı Kurulumu ve Yönetimi

Notion node'unu kullanabilmek için Notion'da bir Internal Integration oluşturmanız ve oluşturulan token'ı SkyStudio'ya eklemeniz gerekir. Ayrıca entegrasyonun erişmesini istediğiniz sayfa ve veritabanlarını integration ile paylaşmanız gerekir.

Notion Integration Token Alma

1. Integration oluşturma

1. notion.so/my-integrations adresine gidin.
2. + New integration butonuna tıklayın.
3. Integration'a bir isim verin (örn. SkyStudio).
4. Hangi workspace'e bağlanacağını seçin.
5. Submit butonuna tıklayın.

2. Token'ı kopyalama

Integration oluşturulduktan sonra Internal Integration Token alanındaki secret_ ile başlayan token'ı Show butonuyla görüntüleyin ve kopyalayın.

Not: Bu token'ı güvenli bir yerde saklayın. Kaybetseniz bile notion.so/my-integrations sayfasından her zaman yeniden görüntüleyebilirsiniz.

3. Sayfa ve veritabanlarını integration ile paylaşma

Notion'da integration oluşturmak tek başına yeterli değildir. Erişilmesi istenen her sayfa veya veritabanı için ayrıca paylaşım yapılmalıdır:

1. Notion'da erişmek istediğiniz sayfayı veya veritabanını açın.
2. Sağ üstteki ... (üç nokta) menüsüne tıklayın.
3. Connections (veya Add connections) seçeneğini seçin.
4. Oluşturduğunuz integration'ı (örn. SkyStudio) listeden bulup tıklayın.

İpucu: Bir üst sayfaya erişim verdiğinizde, o sayfanın altındaki tüm alt sayfalar ve veritabanları da otomatik olarak erişilebilir hale gelir.

SkyStudio'ya Bağlantı Ekleme

1. SkyStudio'nun sol menüsünden Uygulama Bağlantıları bölümüne gidin.
2. Yeni Bağlantı Ekle butonuna tıklayın.
3. Sağlayıcı olarak Notion seçin.
4. Bağlantı Adı alanına tanımlayıcı bir isim girin (örn. Prod Notion).
5. Integration Token alanına kopyaladığınız secret_… token'ını yapıştırın.
6. Kaydet butonuna tıklayın.

Bağlantıyı Node'a Atama

Notion node'unu canvas'a ekledikten sonra sağ paneldeki Uygulama Bağlantıları açılır menüsünden kaydettiğiniz bağlantıyı seçin.

---

Operasyonlar

Notion node'u 8 operasyon sunmaktadır:

Operasyon	Kategori	Açıklama
Veritabanı Sorgula	Öne Çıkan	Notion veritabanını filtre ve sıralama ile sorgular
Notion AI Asistan	Öne Çıkan	Doğal dil sorgusuyla Notion içeriklerini sorgular
Sayfaları Listele	Standart	Workspace'teki sayfaları listeler
Sayfa Getir	Standart	Belirli bir sayfanın meta verilerini döndürür
Sayfa İçeriğini Getir	Standart	Belirli bir sayfanın içeriğini (blok içeriği) döndürür
Veritabanlarını Listele	Standart	Workspace'teki tüm veritabanlarını listeler
Sayfa Oluştur	Standart	Yeni bir Notion sayfası oluşturur
İçerik Ekle	Standart	Mevcut bir sayfaya içerik ekler

---

Veritabanı Sorgula

Notion veritabanındaki kayıtları filtre ve sıralama seçenekleriyle sorgular. CRM, görev takibi veya içerik takvimi gibi veritabanı tabanlı uygulamalarda kullanılır.

Parametreler

Parametre	Zorunlu	Açıklama
Connection	Evet	Kullanılacak Notion bağlantısı
Database ID	Evet	Sorgulanacak veritabanının ID'si
Filter Property	Hayır	Filtreleme yapılacak özellik adı (örn. Status, Assigned To)
Filter Value	Hayır	Filtre değeri (örn. Done, Ahmet)
Sort By Property	Hayır	Sonuçları sıralamak için kullanılacak özellik adı
Limit	Hayır	Döndürülecek maksimum kayıt sayısı

Database ID Nasıl Bulunur?

Notion'da veritabanını açın. URL'deki yapı şu şekildedir: notion.so/{workspace}/{database-id}?v=...

Database ID, URL'deki ?v= kısmından önceki 32 karakterlik bölümdür. Alternatif olarak veritabanı sayfasında ... menüsünden Copy link seçeneğiyle kopyalanan linkteki ID kullanılabilir.

Örnek Çıktı

{
  "results": [
    {
      "id": "page-id-123",
      "properties": {
        "Name": { "title": [{ "plain_text": "Proje Toplantısı" }] },
        "Status": { "select": { "name": "In Progress" } },
        "Due Date": { "date": { "start": "2024-06-01" } }
      }
    }
  ]
}

---

Notion AI Asistan

Doğal dil sorgusuyla Notion içeriklerini sorgular. Karmaşık filtreler yazmadan sayfa ve veritabanı analizine ulaşmak için idealdir.

Parametreler

Parametre	Zorunlu	Açıklama
Connection	Evet	Kullanılacak Notion bağlantısı
Query	Evet	Doğal dilde Notion sorgusu
System Prompt	Hayır	AI asistanının davranışını özelleştiren sistem talimatı

Kullanım Örneği

Query: "Bu hafta tamamlanması gereken görevler neler?"

System Prompt: "Yalnızca 'Görevler' veritabanındaki kayıtları dikkate al. Sonuçları Türkçe ve öncelik sırasına göre listele."

---

Sayfaları Listele

Notion workspace'indeki sayfaları listeler. Page ID'lerini keşfetmek ve sayfa envanteri çıkarmak için kullanılır.

Parametreler

Parametre	Zorunlu	Açıklama
Connection	Evet	Kullanılacak Notion bağlantısı
Limit	Hayır	Döndürülecek maksimum sayfa sayısı

Örnek Çıktı

{
  "results": [
    {
      "id": "abc123",
      "properties": {
        "title": [{ "plain_text": "Ürün Yol Haritası" }]
      },
      "url": "https://notion.so/abc123"
    }
  ]
}

---

Sayfa Getir

Belirli bir Notion sayfasının meta verilerini (başlık, oluşturma tarihi, son düzenlenme tarihi, özellikler) döndürür. Sayfanın blok içeriğini almaz; bunun için Sayfa İçeriğini Getir operasyonunu kullanın.

Parametreler

Parametre	Zorunlu	Açıklama
Connection	Evet	Kullanılacak Notion bağlantısı
Page ID	Evet	Bilgileri getirilecek sayfanın ID'si

---

Sayfa İçeriğini Getir

Belirli bir Notion sayfasının blok içeriğini (metin, başlıklar, listeler, tablolar vb.) döndürür. Sayfa içeriğini okuma ve özetleme senaryolarında kullanılır.

Parametreler

Parametre	Zorunlu	Açıklama
Connection	Evet	Kullanılacak Notion bağlantısı
Page ID	Evet	İçeriği getirilecek sayfanın ID'si

Örnek Çıktı

{
  "results": [
    {
      "type": "heading_1",
      "heading_1": { "rich_text": [{ "plain_text": "Proje Özeti" }] }
    },
    {
      "type": "paragraph",
      "paragraph": { "rich_text": [{ "plain_text": "Bu projede amaç..." }] }
    }
  ]
}

---

Veritabanlarını Listele

Workspace'teki tüm Notion veritabanlarını listeler. Database ID'lerini keşfetmek için kullanılır.

Parametreler

Parametre	Zorunlu	Açıklama
Connection	Evet	Kullanılacak Notion bağlantısı
Limit	Hayır	Döndürülecek maksimum veritabanı sayısı

---

Sayfa Oluştur

Belirtilen üst sayfanın veya veritabanının altında yeni bir Notion sayfası oluşturur.

Parametreler

Parametre	Zorunlu	Açıklama
Connection	Evet	Kullanılacak Notion bağlantısı
Parent ID	Evet	Yeni sayfanın oluşturulacağı üst sayfanın veya veritabanının ID'si
Parent Type	Evet	Üst öğenin tipi: page veya database
Title	Hayır	Oluşturulacak sayfanın başlığı
Content	Hayır	Sayfanın ilk içeriği (düz metin olarak)

Örnek Çıktı

{
  "id": "new-page-id-456",
  "url": "https://notion.so/new-page-id-456",
  "properties": {
    "title": [{ "plain_text": "Haftalık Rapor - Haziran 2024" }]
  }
}

---

İçerik Ekle

Mevcut bir Notion sayfasının sonuna yeni içerik (blok) ekler. Sayfa günlüğü tutma ve otomatik içerik biriktirme workflow'larında kullanılır.

Parametreler

Parametre	Zorunlu	Açıklama
Connection	Evet	Kullanılacak Notion bağlantısı
Page ID	Evet	İçerik eklenecek sayfanın ID'si
Content	Evet	Sayfaya eklenecek metin içeriği

---

Hızlı Başlangıç Örnekleri

Örnek 1: Görev Takip Raporu

Notion veritabanındaki açık görevleri sorgulayıp Slack'e özet gönderen workflow:

Schedule (Her sabah 09:00) → Veritabanı Sorgula → LLM (özetle) → Slack Mesajı

Veritabanı Sorgula ayarları:

• Database ID: {gorev-veritabani-id}
• Filter Property: Status
• Filter Value: In Progress
• Sort By Property: Due Date
• Limit: 20

---

Örnek 2: Toplantı Notu Otomasyonu

Webhook tetikleyiciyle gelen toplantı özetini Notion'a otomatik kaydeden workflow:

Webhook → LLM (notu formatla) → Sayfa Oluştur

Sayfa Oluştur ayarları:

• Parent ID: {toplanti-notlari-sayfa-id}
• Parent Type: page
• Title: {{tarih}} - Toplantı Notu
• Content: {{llm.output}}

---

Örnek 3: Notion AI ile İçerik Arama

Kullanıcının doğal dilde sorduğu soruları Notion bilgi tabanıyla yanıtlayan chatbot:

Metin Girişi → Notion AI Asistan → Metin Çıktısı

Notion AI Asistan ayarları:

• Query: {{input.text}}
• System Prompt: "Sen şirketin bilgi tabanı asistanısın. Yalnızca Notion'daki belgelerden yanıt ver. Türkçe ve kısa yanıtlar üret."

---

Örnek 4: Sayfa İçeriği Özetleme

Bir Notion sayfasının içeriğini okuyup e-posta olarak gönderen workflow:

Schedule (Haftalık) → Sayfaları Listele → Sayfa İçeriğini Getir → LLM (özetle) → E-posta Gönder

Sayfa İçeriğini Getir ayarları:

• Page ID: {{pages.results[0].id}}

---

Sık Karşılaşılan Hatalar

Hata	Olası Neden	Çözüm
401 Unauthorized	Token geçersiz veya yanlış girilmiş	Notion Integration Token'ını kontrol edin; secret_ ile başladığından emin olun
404 Not Found	Sayfa veya veritabanı bulunamadı ya da integration ile paylaşılmamış	İlgili sayfayı veya veritabanını Notion'da integration ile paylaşın (Connections → SkyStudio)
403 Forbidden	Integration'ın bu içeriğe erişim izni yok	Sayfayı integration ile paylaşmayı unutmuş olabilirsiniz; Notion'da ilgili sayfayı açıp Connections bölümüne gidin
Boş results	Filtre koşuluna uyan kayıt yok	Filter Property ve Filter Value değerlerini veritabanındaki alan adlarıyla birebir eşleşecek şekilde kontrol edin
validation_error	Database ID veya Page ID formatı yanlış	ID'nin tire işaretleri dahil 32 karakterlik UUID formatında olduğunu doğrulayın

---

Notlar

• Notion Integration Token'ı (secret_…) süresi dolmaz; ancak integration silinirse veya token yenilenirse SkyStudio bağlantısını güncellemeniz gerekir.
• Sayfaları Listele ve Veritabanlarını Listele operasyonları yalnızca integration ile paylaşılmış içerikleri döndürür. Paylaşılmamış sayfalar listelenmez.
• Sayfa Getir sayfanın meta verilerini (başlık, tarih, özellikler), Sayfa İçeriğini Getir ise blok içeriğini getirir. İkisi farklı operasyondur ve birbirinin yerini tutmaz.
• Sayfa Oluştur operasyonunda Parent Type alanı database seçilirse oluşturulan sayfa veritabanına bir satır olarak eklenir; page seçilirse alt sayfa olarak eklenir.
• Büyük sayfa içeriklerinde (çok bloklu) Sayfa İçeriğini Getir işlemi zaman alabilir; LLM node'una göndermeden önce içeriği kısaltmayı veya filtrelemeyi düşünün.