Uygulama Düğümleri

5. Uygulama Düğümleri​

Bu bölümdeki düğümler dış servislere bağlanır. Her düğüm için önce bağlantı kurulumu, ardından operasyonlar ve parametreler anlatılmıştır.

Outlook Düğümü​

Outlook düğümü, SkyStudio workflow'larında Microsoft Outlook e-posta hesabınızla entegrasyon sağlar. E-posta gönderebilir ve gelen kutusunda gelişmiş arama yapabilirsiniz. Bağlantı için Microsoft OAuth kullanılır.

Bağlantı Kurulumu ve Yönetimi​

Outlook düğümünü kullanabilmek için Microsoft hesabınızla OAuth yetkilendirmesi yapmanız gerekir. API anahtarı veya token girişi gerekmez; yetkilendirme Microsoft'un resmi giriş ekranı üzerinden yapılır.

Microsoft Outlook'a Bağlanma​

1. Bağlantıyı başlatma

1. SkyStudio'da Outlook düğümünü canvas'a ekleyin.
2. Düğüme tıklayarak sağ paneli açın.
3. Operasyon seçin (Mail Gönder veya Mail Ara).
4. Sağ paneldeki Microsoft Outlook'a Bağlan butonuna tıklayın.

2. Microsoft hesabıyla yetkilendirme

1. Açılan Microsoft giriş ekranında kurumsal veya kişisel Microsoft hesabınızla oturum açın.
2. SkyStudio'nun Outlook'a erişim izni istemesini onaylayın.
3. Yetkilendirme tamamlandığında sağ panelde bağlantı aktif hale gelir ve alanlar görünür olur.

Not: Yetkilendirme, Microsoft'un standart OAuth 2.0 akışı üzerinden gerçekleşir. SkyStudio, şifrenizi görmez veya saklamaz.

SkyStudio'ya Bağlantı Ekleme (Alternatif Yöntem)​

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 Microsoft Outlook seçin.

4. Bağlantı Adı alanına tanımlayıcı bir isim girin (örn. Şirket Outlook).

5. Microsoft ile Yetkilendir butonuna tıklayın ve Microsoft giriş adımlarını tamamlayın.

6. Yetkilendirme tamamlandıktan sonra bağlantı otomatik olarak kaydedilir.

Bağlantıyı Düğüme Atama​

Outlook düğümünü canvas'a ekledikten sonra sağ paneldeki Uygulama Bağlantıları açılır menüsünden kaydettiğiniz bağlantıyı seçin.

Not: Farklı Microsoft hesapları için (örn. kişisel ve kurumsal) ayrı bağlantılar tanımlayabilirsiniz.

Operasyonlar​

Outlook düğümü 2 operasyon sunmaktadır:

Mail Gönder​

Bağlı Microsoft Outlook hesabı üzerinden e-posta gönderir. Bildirim, rapor paylaşımı ve otomatik yanıt senaryolarında kullanılır.

Parametreler​

Kullanım Örneği​

Bir workflow'dan otomatik rapor e-postası göndermek için:

• To: yonetici@sirket.com
• Subject: Haftalık Satış Raporu
• Body: {{llm.output}}

Örnek Çıktı​

{
  "id": "message-id-abc123",
  "status": "sent",
  "to": ["yonetici@sirket.com"],
  "subject": "Haftalık Satış Raporu"
}

Mail Ara​

Outlook gelen kutusunda anahtar kelime, gönderen veya konu filtresiyle e-posta arar. E-posta izleme ve içerik çıkarma workflow'larında kullanılır.

Parametreler​

Arama Sorgusu Örnekleri​

Örnek Çıktı​

{
  "value": [
    {
      "id": "message-id-xyz",
      "subject": "Nisan Fatura Özeti",
      "from": { "emailAddress": { "address": "muhasebe@sirket.com" } },
      "receivedDateTime": "2024-04-15T09:30:00Z",
      "bodyPreview": "Nisan ayına ait fatura özeti ekte yer almaktadır..."
    }
  ]
}

Örnek: Destek Talebi Yanıtlayıcı​

Gelen destek e-postalarını okuyup AI ile yanıt üreten ve gönderen workflow:

Mail Ara → LLM (yanıt üret) → Mail Gönder

Mail Ara ayarları:

• Search Query: subject:destek
• Folder: Inbox
• Limit: 5

Mail Gönder ayarları:

• To: Alıcı e-posta adresi
• Subject: Konu
• Body: {{llm.output}}

Outlook Calendar Düğümü​

Outlook Calendar düğümü, SkyStudio workflow'larında Microsoft Outlook takvimiyle entegrasyon sağlar. Etkinlikleri listeleyebilir, oluşturabilir, güncelleyebilir, silebilir; müsaitlik kontrolü yapabilir ve AI destekli takvim sorguları çalıştırabilirsiniz. Bağlantı için Teams düğümüyle aynı Azure App Registration yöntemi kullanılır.

Bağlantı Kurulumu ve Yönetimi​

1.Bağlantı Yöntemi​

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 Outlook Takvimi seçin.

4. Bağlantı yöntemi olarak OAuth 2.0 ‘ı seçin

5. Bu bağlantıyı iş akışlarında kimlerin seçip çalıştırabileceğini belirleyin.

6. “Microsoft ile Takvim Bağla” seçeneğine tıklayın.

Microsoft hesabıyla yetkilendirme

1. Açılan Microsoft giriş ekranında kurumsal veya kişisel Microsoft hesabınızla oturum açın.
2. SkyStudio'nun Outlook'a erişim izni istemesini onaylayın.

2.Bağlantı Yöntemi​

Outlook Calendar düğümünü kullanabilmek için Azure Portal'da bir App Registration oluşturmanız ve elde ettiğiniz Tenant ID, Client ID ve Client Secret bilgilerini SkyStudio'ya girmeniz gerekir.

Not: Bu düğümün bağlantı kurulum süreci Microsoft Teams düğümüyle tamamen aynıdır. Zaten bir Teams bağlantısı oluşturduysanız, aynı Azure App Registration bilgilerini Outlook Calendar için de kullanabilirsiniz.

Azure App Registration Oluşturma​

1. Yeni uygulama kaydetme

1. portal.azure.com adresine giriş yapın.

2. Arama çubuğuna App registrations yazıp ilgili servise gidin.

3. + New registration butonuna tıklayın.

4. Uygulamaya bir isim verin (örn. SkyStudio).

5. Accounts in this organizational directory only (Single tenant) seçin.

6. Register butonuna tıklayın.

2. Client ID ve Tenant ID kopyalama

Uygulama oluşturulduktan sonra Overview sayfasında:

• Application (client) ID → Client ID'niz
• Directory (tenant) ID → Tenant ID'niz

Her ikisini kopyalayın. Bu bilgilere sonradan tekrar erişilebilir.

3. Client Secret oluşturma

1. Sol menüden Certificates & secrets bölümüne gidin.

2. + New client secret butonuna tıklayın.

3. Bir Description ve Expiration Date ekleyin, Add butonuna tıklayın.

4. Oluşturulan secret'ın Value alanını hemen kopyalayın.

Önemli Not: Client Secret değeri yalnızca oluşturulduğu anda görüntülenir. Sayfayı kapattıktan sonra bir daha tam değerine ulaşamazsınız.

4. API İzinleri ekleme

1. Sol menüden API permissions bölümüne gidin.

2. + Add a permission → Microsoft Graph → Application permissions seçin.

3. Outlook Calendar için gerekli izinleri ekleyin:

4. Grant admin consent butonuna tıklayarak izinleri onaylayın.

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 Outlook Takvimi seçin.

4. Aşağıdaki alanları doldurun:

5. Kaydet butonuna tıklayın.

Bağlantıyı Düğüme Atama​

Outlook Calendar düğümünü canvas'a ekledikten sonra sağ paneldeki Uygulama Bağlantıları açılır menüsünden kaydettiğiniz bağlantıyı seçin.

Operasyonlar​

Outlook Calendar düğümü 10 operasyon sunmaktadır:

Etkinlikleri Getir​

Takvimden etkinlikleri tarih aralığı ve arama filtresiyle getirir.

Parametreler​

Bugünün Etkinlikleri​

Bağlı hesabın bugünkü takvim etkinliklerini döndürür.

Parametreler​

Yaklaşan Etkinlikler​

Belirtilen gün sayısı içindeki gelecek etkinlikleri listeler.

Parametreler​

Müsaitlik Kontrolü​

Belirtilen kullanıcıların belirli bir zaman dilimindeki müsaitliğini sorgular. Randevu ve toplantı planlama workflow'larında kullanılır.

Parametreler​

Outlook Takvim AI Asistan​

Doğal dil sorgusuyla Outlook takvim verilerini sorgular. Videoda da gösterildiği gibi "bu haftaki toplantılarım neler?" gibi sorularla takvim verilerine kolayca erişilebilir.

Parametreler​

Kullanım Örneği​

Query: "Bu haftaki toplantılarımı sıralar mısın?"

System Prompt: "Yalnızca bu haftaki etkinlikleri listele. Türkçe yanıt ver, başlık ve saatini göster."

Takvimleri Listele​

Hesaptaki tüm takvimleri ve Calendar ID'lerini listeler.

Parametreler​

Etkinlik Getir​

Belirli bir etkinliğin tüm detaylarını Event ID ile getirir.

Parametreler​

Etkinlik Oluştur​

Outlook takvimine yeni etkinlik ekler. İsteğe bağlı olarak Teams toplantı linki de oluşturulabilir.

Parametreler​

Etkinlik Güncelle​

Mevcut bir etkinliğin bilgilerini günceller.

Parametreler​

Etkinlik Sil​

Belirtilen etkinliği takvimden siler.

Parametreler​

Sık Karşılaşılan Hatalar​

Notlar​

• Calendar ID alanı boş bırakıldığında tüm operasyonlar otomatik olarak birincil takvim üzerinde çalışır.
• Etkinlik Oluştur operasyonunda Teams Meeting açıkken bir Teams toplantı bağlantısı otomatik oluşturulur; bu özelliğin çalışması için Azure App Registration'ın OnlineMeetings.ReadWrite.All iznine de sahip olması gerekir.
• Tarih/saat alanlarına YYYY-MM-DDTHH:MM:SS formatında değer girilir (örn. 2024-06-01T10:00:00). Timezone ayrı bir alan olarak girilir.
• Müsaitlik Kontrolü operasyonu, birden fazla kullanıcının müsaitliğini aynı anda kontrol edebilir. E-posta adreslerini virgülle ayırarak girebilirsiniz.
• Azure App Registration'ın Client Secret süresi dolduğunda bağlantı çalışmayı durdurur. Süresi dolmadan önce yeni secret oluşturup SkyStudio bağlantısını güncellemeniz önerilir.

Google Calendar Düğümü​

Google Calendar düğümü, SkyStudio workflow'larında Google Takvim ile entegrasyon sağlar. Etkinlikleri okuyabilir, oluşturabilir, güncelleyebilir ve silebilir; AI destekli doğal dil sorguları çalıştırabilirsiniz.

Bağlantı Kurulumu ve Yönetimi​

Google Calendar düğümünü kullanabilmek için önce bir Google hesabı bağlantısı oluşturmanız gerekir.

Yeni 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 Google Calendar seçin.

4. Google ile Yetkilendir butonuna tıklayın.

5. Açılan Google OAuth penceresinde hesabınızı seçin ve gerekli izinlere onay verin.

6. Yetkilendirme tamamlandığında bağlantı otomatik olarak kaydedilir.

Not: Google Calendar düğümü OAuth 2.0 protokolü kullanır. Şifreniz SkyStudio'ya iletilmez; yalnızca Google tarafından verilen erişim token'ı saklanır.

Bağlantıyı Düğüme Atama​

Google Calendar düğümünü canvas'a ekledikten sonra sağ paneldeki Uygulama Bağlantıları açılır menüsünden daha önce oluşturduğunuz Google hesabı bağlantısını seçin.

Calendar ID Nedir?​

Calendar ID, hangi takvimin kullanılacağını belirtir.

Takviminizin ID'sini öğrenmek için: Google Takvim → Takvim Ayarları → "Takvim entegrasyon" bölümü → Takvim Kimliği alanı.

Operasyonlar​

Google Calendar düğümü 9 operasyon sunmaktadır:

Etkinlikleri Getir​

Belirtilen tarih aralığındaki takvim etkinliklerini döndürür. Raporlama ve etkinlik filtreleme senaryolarında kullanılır.

Parametreler​

Örnek Çıktı​

{
  "items": [
    {
      "id": "abc123xyz",
      "summary": "Proje Toplantısı",
      "start": { "dateTime": "2024-11-15T10:00:00" },
      "end": { "dateTime": "2024-11-15T11:00:00" },
      "location": "Toplantı Odası 1",
      "status": "confirmed"
    }
  ]
}

Bugünün Etkinlikleri​

Seçilen takvimde bugün gerçekleşecek tüm etkinlikleri otomatik olarak getirir. Tarih parametresi girmeden günlük özet almak için idealdir.

Parametreler​

Not: Zaman dilimi belirtilmezse UTC kullanılır. Türkiye'de çalışan workflow'lar için Europe/Istanbul değerini girin.

Yaklaşan Etkinlikler​

Şu andan itibaren belirtilen gün sayısı içindeki etkinlikleri getirir. Hatırlatıcı ve bildirim workflow'ları için uygundur.

Parametreler​

Google Takvim AI Asistan​

Doğal dil kullanarak takvim verilerini sorgulamanızı sağlar. Karmaşık tarih/saat filtreleri yazmadan bilgiye ulaşmak için idealdir.

Parametreler​

Kullanım Örneği​

Query: "Bu hafta sonu kaç toplantım var?"

System Prompt: "Yalnızca 'Toplantı' veya 'Meeting' kelimesini içeren etkinlikleri say."

Not: System Prompt ile AI asistanına belirli takvimler, kişiler veya etkinlik kategorileri gibi kısıtlamalar tanımlayabilirsiniz.

Takvimleri Listele​

Google hesabınıza bağlı tüm takvimleri (kişisel, paylaşılan, ekip takvimleri vb.) döndürür. Hangi takvimlere erişiminiz olduğunu ve Calendar ID değerlerini öğrenmek için kullanılır.

Parametreler​

Örnek Çıktı​

{
  "items": [
    {
      "id": "primary",
      "summary": "Ahmet Yılmaz",
      "primary": true,
      "accessRole": "owner"
    },
    {
      "id": "tr.turkish#holiday@group.v.calendar.google.com",
      "summary": "Türkiye'deki Tatiller",
      "accessRole": "reader"
    }
  ]
}

Etkinlik Getir​

Belirli bir Event ID ile tek bir takvim etkinliğinin tüm detaylarını getirir.

Parametreler​

Event ID Nasıl Bulunur?​

"Etkinlikleri Getir" veya "Bugünün Etkinlikleri" operasyonlarından dönen çıktıdaki id alanı, o etkinliğin Event ID'sidir. Google Calendar web arayüzünde etkinliği açıp URL'den de kopyalanabilir.

Etkinlik Oluştur​

Google Takvim'de yeni bir etkinlik oluşturur. Katılımcı davetleri, konum ve tüm gün etkinlikleri desteklenir.

Parametreler​

Attendees Kullanımı​

Birden fazla katılımcı eklemek için e-posta adreslerini virgülle ayırın:

ali@sirket.com, ayse@sirket.com, mehmet@ortak.com

Her katılımcıya otomatik olarak Google Takvim daveti gönderilir.

All Day Event Modu​

All Day Event açıkken Start Date Time ve End Date Time alanlarına yine aynı format kullanılır (2024-12-31T00:00:00), ancak saat bilgisi dikkate alınmaz; etkinlik tüm gün olarak işaretlenir.

Etkinlik Güncelle​

Mevcut bir takvim etkinliğinin bilgilerini günceller. Yalnızca girilen alanlar değiştirilir; girilmeyen alanlar mevcut değerleriyle korunur.

Parametreler​

Not: Attendees alanı girildiğinde mevcut katılımcı listesinin tamamı yeni liste ile değiştirilir. Var olan katılımcıları korumak istiyorsanız önce "Etkinlik Getir" ile mevcut listeyi alıp üzerine ekleyin.

Etkinlik Sil​

Bir takvim etkinliğini kalıcı olarak siler. Bu işlem geri alınamaz.

Parametreler​

Not: Silme işlemi kalıcıdır ve geri alınamaz. Silmeden önce Event ID'nin doğru olduğundan emin olun.

Sık Karşılaşılan Hatalar​

Notlar​

• Tüm tarih/saat değerleri YYYY-MM-DDTHH:MM:SS formatında girilmelidir, örn. 2024-06-01T10:00:00. Bu alanlara değer elle yazılabilir veya / ile parametre bağlanabilir. Timezone offset (+03:00 gibi) datetime string'ine eklenmez; zaman dilimi ayrıca Timezone alanından belirtilir.
• Timezone alanı için geçerli değerler IANA zaman dilimi veritabanına dayanır. Türkiye için Europe/Istanbul kullanın.
• Google Calendar API'si saniyede 10 istek sınırına sahiptir. Çok sayıda etkinlik işleyen workflow'larda istekler arasına gecikme (delay) eklemeniz önerilir.
• Tekrarlayan etkinliklerde (recurring events) Etkinlik Sil yalnızca ilgili tek örneği siler; tüm seriyi silmek için Google Takvim arayüzünü kullanın.
• All Day Event açık olduğunda Timezone ayarı dikkate alınmaz.

Google Drive Düğümü​

Google Drive düğümü, SkyStudio workflow'larında Google Drive ve Google Sheets ile entegrasyon sağlar. Dosya okuma, arama, klasör yönetimi ve elektronik tablo işlemleri yapabilirsiniz.

Bağlantı Kurulumu ve Yönetimi​

Google Drive düğümünü kullanabilmek için önce bir Google hesabı bağlantısı oluşturmanız gerekir. Google Drive, Jira ve Confluence'dan farklı olarak OAuth 2.0 kimlik doğrulama yöntemini kullanır.

Yeni Bağlantı Ekleme​

1. SkyStudio'nun sol menüsünden Uygulama Bağlantıları bölümüne gidin.

2. Google Drive seçeneğine tıklayın.

3. Bağlantı yöntemi olarak OAuth 2.0 seçili olduğundan emin olun (varsayılan ve önerilen).

4. Bağlantı adı alanına bu bağlantı için bir isim girin (zorunlu).

5. Google ile yetkilendir butonuna tıklayın.

Bağlantı Yöntemleri​

OAuth 2.0 (Önerilen) Tarayıcı üzerinden Google hesabınızla yetkilendirme yapılır. Backend OAuth URL'i yapılandırıldığında tek tıklamayla açılır. En güvenli ve kolay yöntemdir.

API Anahtarı / Gelişmiş Kimlik bilgilerini JSON formatında manuel olarak girebilirsiniz. Kendi Google Cloud OAuth istemcinizi kullanmak istiyorsanız bu yöntemi tercih edin.

Yetkilendirme Adımları​

1. Google ile yetkilendir butonuna tıklayın.

2. Açılan Google oturum açma penceresinde hesabınızı seçin.

3. SkyStudio'nun istediği izinleri onaylayın.

4. Yetkilendirme başarılı olduğunda bağlantı otomatik kaydedilir.

Not: Yetkilendirme sırasında Google, Drive ve Sheets erişimi için izin isteyecektir. Workflow'larınızın düzgün çalışması için tüm istenen izinleri onaylayın.

Bağlantıyı Düğüme Atama​

Google Drive düğümünü canvas'a sürükledikten sonra sağ paneldeki Uygulama Bağlantıları açılır menüsünden daha önce oluşturduğunuz bağlantıyı seçin.

Operasyonlar​

Google Drive düğümü 13 operasyon sunmaktadır:

Dosyaları Listele​

Belirli bir klasördeki tüm dosya ve alt klasörleri listeler. Klasör ID verilmezse Drive'ın kök dizini listelenir.

Parametreler​

Folder ID Nasıl Bulunur?​

Google Drive'da klasörü açın. URL'deki son segment Folder ID'dir. Örnek: https://drive.google.com/drive/folders/1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs → ID: 1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs

Dosya Ara​

Google Drive arama söz dizimiyle dosya arar. Ad, içerik, MIME türü gibi kriterlere göre filtreleme yapılabilir.

Parametreler​

Google Drive AI Asistan​

Doğal dil kullanarak Drive dosyalarınızı sorgular. Dosya içeriklerini anlamlandırmak ve bilgi çıkarmak için kullanılır.

Parametreler​

Kullanım Örneği​

Query: "Geçen ay paylaşılan toplantı notlarını bul ve özetle"

System Prompt: "Yalnızca 'Toplantı Notları' klasöründeki dosyalara bak. Yanıtı Türkçe ver."

Spreadsheet Satırları Getir​

Google Sheets'ten belirli bir aralıktaki satırları JSON formatında getirir.

Parametreler​

Spreadsheet ID Nasıl Bulunur?​

Google Sheets URL'sindeki /d/ ile /edit arasındaki kısım Spreadsheet ID'dir. Örnek: https://docs.google.com/spreadsheets/d/1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs/edit → ID: 1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs

Range Formatı​

• Tüm sayfa: Sheet1 veya Sayfa1
• Belirli aralık: Sheet1!A1:D50
• Tüm A sütunu: Sheet1!A:A
• İlk 10 satır: Sheet1!1:10

Dosya İçeriğini Oku​

Google Drive'daki bir dosyanın içeriğini okur. Okuma yöntemine göre ham metin, AI analizi veya yapılandırılmış veri döndürebilir.

Parametreler​

Desteklenen Dosya Türleri​

Google Docs, Google Sheets, Google Slides, PDF, TXT, DOCX ve diğer metin tabanlı dosyalar okunabilir.

Dosyaya Sor​

Bir Drive dosyası hakkında doğal dilde soru sormanızı sağlar. Dosya içeriği otomatik olarak yüklenip AI ile işlenir.

Parametreler​

Kullanım Örneği​

File ID: 1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs

Question: "Bu rapordaki ana bulgular nelerdir? Madde madde listele."

Response Language: Turkish

Dosya Bilgisi Getir​

Bir dosyanın adı, boyutu, oluşturulma tarihi, MIME türü gibi meta veri bilgilerini getirir. Dosya içeriğini okumaz.

Parametreler​

Örnek Çıktı​

{
  "id": "1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs",
  "name": "Q4 Satış Raporu.pdf",
  "mimeType": "application/pdf",
  "size": "245760",
  "createdTime": "2024-10-01T09:00:00.000Z",
  "modifiedTime": "2024-11-15T14:30:00.000Z",
  "webViewLink": "https://drive.google.com/file/d/..."
}

Klasör Oluştur​

Google Drive'da yeni bir klasör oluşturur. İsteğe bağlı olarak mevcut bir klasörün içine oluşturulabilir.

Parametreler​

Spreadsheet Bilgisi​

Bir Google Sheets dosyasının sayfa adları, satır/sütun sayısı gibi yapısal meta veri bilgilerini getirir.

Parametreler​

Satır Ekle​

Mevcut bir Google Sheets sayfasına yeni satır(lar) ekler.

Parametreler​

Rows Formatı​

[
  { "Ad": "Ayşe", "Soyad": "Kaya", "Departman": "Pazarlama" },
  { "Ad": "Mehmet", "Soyad": "Demir", "Departman": "Mühendislik" }
]

Hücre Güncelle​

Google Sheets'teki belirli bir aralıktaki hücre değerlerini günceller.

Parametreler​

Values Formatı​

[
  ["Yeni Değer 1", "Yeni Değer 2"],
  ["Yeni Değer 3", "Yeni Değer 4"]
]

Hücreleri Temizle​

Google Sheets'teki belirli bir aralıktaki hücre içeriklerini siler (format korunur).

Parametreler​

Not: Bu işlem yalnızca hücre içeriklerini siler, hücre biçimlendirmesini (renk, font vb.) korur.

Spreadsheet Oluştur​

Yeni bir Google Sheets dosyası oluşturur. İstenilen sayfa adlarını başlangıçta tanımlayabilirsiniz.

Parametreler​

Örnek Çıktı​

{
  "spreadsheetId": "1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs",
  "spreadsheetUrl": "https://docs.google.com/spreadsheets/d/...",
  "title": "2025 Satış Takip Tablosu"
}

Sık Karşılaşılan Hatalar​

Notlar​

• File ID ile Spreadsheet ID aynı kavramdır — her Google Sheets dosyası aynı zamanda bir Drive dosyasıdır.
• Google Drive API, günlük istek limitlerine sahiptir. Büyük veri işlemlerinde Page Size ve istek aralıklarını göz önünde bulundurun.
• Dosyaya Sor ve Dosya İçeriğini Oku (AI analizi) operasyonları büyük dosyalarda daha uzun süre alabilir.
• Google Workspace (Docs, Sheets, Slides) dışı ikili dosyalar (resim, video vb.) içerik okuma için desteklenmeyebilir.

Google Maps Düğümü​

Google Maps düğümü, SkyStudio workflow'larında Google Maps Platform ile entegrasyon sağlar. Adres/koordinat dönüştürme, mesafe hesaplama, yakın yer arama, yön tarifi alma ve statik harita görseli oluşturma gibi işlemleri otomatikleştirebilirsiniz.

Bağlantı Kurulumu ve Yönetimi​

Google Maps düğümünü kullanabilmek için bir Google Maps API anahtarı gereklidir.

API Anahtarı Alma​

1. Google Cloud Console adresine gidin.

2. Bir proje oluşturun veya mevcut bir projeyi seçin.

3. APIs & Services → Library bölümünden aşağıdaki API'leri etkinleştirin:

• Maps JavaScript API
• Geocoding API
• Places API
• Directions API
• Distance Matrix API
• Maps Static API

4. APIs & Services → Credentials bölümünden Create Credentials → API Key seçin.

5. Oluşturulan API anahtarını kopyalayın.

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 Google Maps seçin.

4. API anahtarınızı ilgili alana yapıştırın ve kaydedin.

Bağlantıyı Düğüme Atama​

Google Maps düğümünü canvas'a ekledikten sonra sağ paneldeki Uygulama Bağlantıları açılır menüsünden oluşturduğunuz bağlantıyı seçin.

Not: Her operasyon için aynı bağlantı kullanılır. Farklı projeler için farklı API anahtarıyla birden fazla bağlantı tanımlayabilirsiniz.

Operasyonlar​

Google Maps düğümü 9 operasyon sunmaktadır:

Adres → Koordinat​

Bir metin adresini enlem (latitude) ve boylam (longitude) koordinat değerlerine dönüştürür. Geocoding işlemi olarak da bilinir.

Parametreler​

Örnek Çıktı​

{
  "lat": 41.0369,
  "lng": 28.9850,
  "formatted_address": "Taksim Meydanı, Beyoğlu/İstanbul, Türkiye"
}

Mesafe & Süre​

Bir veya birden fazla başlangıç noktasından bir veya birden fazla varış noktasına olan mesafeyi ve tahmini seyahat süresini hesaplar (Distance Matrix).

Parametreler​

Origins / Destinations Formatı​

Tek nokta: Kadıköy, İstanbul

Birden fazla nokta: Kadıköy, İstanbul|Beşiktaş, İstanbul

Yakındaki Yerler​

Verilen koordinat noktası etrafında belirtilen yarıçap içindeki yerleri listeler. Restoran, eczane, ATM gibi kategoriye göre filtreleme yapılabilir.

Parametreler​

Place Type Örnekleri​

restaurant, cafe, hospital, pharmacy, bank, atm, gas_station, hotel, supermarket, school, park

Yer Ara​

Metin tabanlı arama sorgusuyla Google Maps'te yer ve adres arar. Kullanıcı girişine dayalı yer arama senaryolarında kullanılır.

Parametreler​

Örnek Çıktı​

{
  "results": [
    {
      "place_id": "ChIJLU7jZClu0xQRIOd2kzuSCZU",
      "name": "İstanbul Havalimanı",
      "formatted_address": "Tayakadın, 34283 Arnavutköy/İstanbul",
      "geometry": {
        "location": { "lat": 41.2608, "lng": 28.7418 }
      },
      "rating": 4.3
    }
  ]
}

Harita AI Asistan​

Doğal dil sorgusuyla Google Maps verilerini sorgular. Karmaşık arama ve filtreleme işlemlerini sade bir soru formatıyla gerçekleştirir.

Parametreler​

Kullanım Örneği​

Query: "Kadıköy'e en yakın 3 eczaneyi bul"

System Prompt: "Sadece 24 saat açık olan yerleri listele ve adreslerini Türkçe ver."

Koordinat → Adres​

Enlem/boylam koordinatlarını okunabilir metin adresine dönüştürür. Ters geocoding (reverse geocoding) işlemidir.

Parametreler​

Örnek Çıktı​

{
  "formatted_address": "Sultanahmet, Fatih/İstanbul 34122, Türkiye",
  "address_components": [
    { "long_name": "Sultanahmet", "types": ["neighborhood"] },
    { "long_name": "Fatih", "types": ["sublocality"] },
    { "long_name": "İstanbul", "types": ["locality"] }
  ]
}

Yön Tarifi​

İki nokta arasında adım adım yol tarifi üretir. Ara duraklar (waypoints) eklenebilir; farklı ulaşım modları desteklenir.

Parametreler​

Waypoints Kullanımı​

Üsküdar, İstanbul|Bostancı, İstanbul

Her waypoint bir ara durak oluşturur; rota sırayla tüm noktalardan geçer.

Yer Detayı​

Bir yerin Place ID'sini kullanarak o yere ait detaylı bilgileri getirir: telefon numarası, çalışma saatleri, web sitesi, fotoğraflar, yorumlar ve daha fazlası.

Parametreler​

Place ID Nasıl Bulunur?​

"Yer Ara" operasyonunun çıktısındaki place_id alanı doğrudan kullanılabilir. Google Maps web arayüzünde de bir yeri sağ tıklayarak Place ID kopyalanabilir.

Fields Örnekleri​

name, rating, formatted_address, formatted_phone_number, website, opening_hours, photos, reviews, price_level, geometry

Harita Görseli​

Belirtilen konumu merkez alarak statik bir harita görseli (PNG) oluşturur. Workflow çıktılarına veya raporlara harita eklemek için kullanılır.

Parametreler​

Zoom Rehberi​

Hızlı Başlangıç Örnekleri​

Sık Karşılaşılan Hatalar​

Notlar​

• Language alanı için ISO 639-1 dil kodları kullanılır: Türkçe için tr, İngilizce için en, Almanca için de.
• Radius (Yakındaki Yerler) maksimum 50.000 metre olabilir; daha büyük değerler otomatik kırpılır.
• Harita Görseli operasyonu görsel URL'si yerine doğrudan PNG binary döndürebilir; workflow'da "Dosya Çıktısı" düğümü ile kaydetmek mümkündür.
• Google Maps API'si istek başına ücretlendirme modeli kullanır. Yüksek hacimli workflow'larda maliyet optimizasyonu için sonuçları önbelleğe almayı (cache) düşünün.
• Place ID zamanla değişebilir; uzun süreli saklama yerine her seferinde "Yer Ara" ile güncel ID almak önerilir.

SharePoint Düğümü​

SharePoint düğümü, SkyStudio workflow'larında Microsoft SharePoint sitenizdeki liste verilerine, dosyalara ve sayfalara erişmenizi sağlar. Liste öğelerini okuyabilir, oluşturabilir, güncelleyebilir; dosya yükleyip indirebilir ve AI destekli içerik sorguları çalıştırabilirsiniz. Bağlantı için Azure App Registration kullanılır.

Bağlantı Kurulumu ve Yönetimi​

1.Bağlantı Yöntemi​

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 SharePoint seçin.

4. Bağlantı yöntemi olarak OAuth 2.0 ‘ı seçin

5. Bu bağlantıyı iş akışlarında kimlerin seçip çalıştırabileceğini belirleyin.

6. “Microsoft ile SharePoint Bağla” seçeneğine tıklayın.

Microsoft hesabıyla yetkilendirme

1. Açılan Microsoft giriş ekranında kurumsal veya kişisel Microsoft hesabınızla oturum açın.
2. SkyStudio'nun SharePoint’den erişim izni istemesini onaylayın.

2.Bağlantı Yöntemi​

SharePoint düğümünü kullanabilmek için Azure Portal'da bir App Registration oluşturmanız ve elde ettiğiniz Tenant ID, Client ID, Client Secret bilgilerini SharePoint Site URL'inizle birlikte SkyStudio'ya girmeniz gerekir.

🎬 Videoyu izlemek için tıklayın → SharePoint Bağlantısı Nasıl Kurulur?

Not: Bu düğümün Azure kurulum süreci Microsoft Teams ve Outlook Calendar düğümleriyle tamamen aynıdır. Zaten bu düğümlerden biri için App Registration oluşturduysanız, aynı bilgileri SharePoint için de kullanabilirsiniz.

Azure App Registration Oluşturma​

1. Yeni uygulama kaydetme

1. portal.azure.com adresine giriş yapın.

2. Arama çubuğuna App registrations yazıp ilgili servise gidin.

3. + New registration butonuna tıklayın.

4. Uygulamaya bir isim verin (örn. SkyStudio).

5. Accounts in this organizational directory only (Single tenant) seçin.

6. Register butonuna tıklayın.

2. Client ID ve Tenant ID kopyalama

Uygulama oluşturulduktan sonra Overview sayfasında:

• Application (client) ID → Client ID'niz
• Directory (tenant) ID → Tenant ID'niz

3. Client Secret oluşturma

1. Sol menüden Certificates & secrets bölümüne gidin.

2. + New client secret butonuna tıklayın.

3. Bir Description ve Expiration Date ekleyin, Add butonuna tıklayın.

4. Oluşturulan secret'ın Value alanını hemen kopyalayın.

Not: Client Secret değeri yalnızca oluşturulduğu anda görüntülenir. Sayfayı kapattıktan sonra bir daha tam değerine ulaşamazsınız.

4. API İzinleri ekleme

1. Sol menüden API permissions bölümüne gidin.

2. + Add a permission → Microsoft Graph → Application permissions seçin.

3. SharePoint için gerekli izinleri ekleyin:

4. Grant admin consent butonuna tıklayarak izinleri onaylayın.

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 SharePoint seçin.

4. Aşağıdaki alanları doldurun:

5. Kaydet butonuna tıklayın.

Bağlantıyı Düğüme Atama​

SharePoint düğümünü canvas'a ekledikten sonra sağ paneldeki Uygulama Bağlantıları açılır menüsünden kaydettiğiniz bağlantıyı seçin.

Not: Farklı SharePoint siteleri için ayrı bağlantılar tanımlayabilirsiniz. Her bağlantıda aynı Tenant/Client bilgilerini kullanıp yalnızca Site URL'yi değiştirmeniz yeterlidir.

Operasyonlar​

SharePoint düğümü 11 operasyon sunmaktadır:

Liste Öğelerini Getir​

SharePoint listesindeki öğeleri OData filtresiyle sorgular. Proje takibi, görev yönetimi veya veri raporlama workflow'larında kullanılır.

Parametreler​

OData Filtre Örnekleri​

Dosyaları Listele​

Belirli bir belge kütüphanesi veya klasördeki dosyaları listeler.

Parametreler​

Ara​

SharePoint sitesinde anahtar kelimeyle içerik arar. Liste öğeleri, dosyalar ve sayfalar dahil tüm içerikte arama yapılabilir.

Parametreler​

SharePoint AI Asistan​

Doğal dil sorgusuyla SharePoint içeriklerini sorgular. Videoda da gösterildiği gibi "klasör isimlerini getir" gibi doğal dilde sorgular yazabilirsiniz.

Parametreler​

Kullanım Örneği​

Query: "Belgeler kütüphanesindeki bu ayki yüklenen dosyalar hangileri?"

System Prompt: "Yalnızca son 30 gün içinde oluşturulan içerikleri göster. Türkçe yanıt ver."

Siteleri Listele​

Organizasyondaki SharePoint sitelerini arama sorgusuna göre listeler. Site URL'lerini keşfetmek için kullanılır.

Parametreler​

Liste Öğesi Getir​

Belirli bir liste öğesinin tüm detaylarını Item ID ile getirir.

Parametreler​

Liste Öğesi Oluştur​

Belirtilen SharePoint listesine yeni bir öğe ekler.

Parametreler​

Fields (JSON) Örneği​

{
  "Title": "Yeni Proje Görevi",
  "Status": "Başlanmadı",
  "Priority": "Yüksek",
  "AssignedTo": "ahmet@sirket.com"
}

Liste Öğesi Güncelle​

Mevcut bir liste öğesinin alanlarını günceller.

Parametreler​

Dosya İndir / Oku​

SharePoint'teki bir dosyayı indirir veya içeriğini metin olarak okur. AI ile içerik analizi senaryolarında kullanılır.

Parametreler​

Dosya Yükle​

Bir belge kütüphanesine dosya yükler.

Parametreler​

Sayfa İçeriğini Oku​

Belirtilen SharePoint sayfasının içeriğini okur. Bilgi tabanı ve içerik yönetimi workflow'larında kullanılır.

Parametreler​

Sık Karşılaşılan Hatalar​

Notlar​

• Site URL alanı, bağlantı sırasında bir kez girilir ve o bağlantının kullandığı tüm operasyonlar için geçerlidir. Farklı sitelere erişmek için ayrı bağlantılar tanımlayın.
• List Name alanı büyük/küçük harfe duyarlıdır. SharePoint'te listenin tam adını kullanın (örn. Documents veya Belgeler).
• Fields (JSON) alanına yalnızca güncellemek istediğiniz alanları girin. Diğer alanlar değişmeden kalır.
• Dosya İndir / Oku operasyonunda Item ID yoksa File Path (göreli yol) kullanılabilir. İkisi de girilirse Item ID önceliklidir.
• OData filtre sözdizimi için alan adlarının SharePoint iç adlarını (internal name) kullandığınızdan emin olun; görünen ad (display name) farklı olabilir.
• Azure App Registration'ın Client Secret süresi dolduğunda bağlantı çalışmayı durdurur. Süresi dolmadan önce yenilemeniz önerilir.

Microsoft Teams Düğümü​

Microsoft Teams düğümü, SkyStudio workflow'larında Microsoft Teams çalışma alanınızla entegrasyon sağlar. Kanal mesajları okuyabilir ve gönderebilir, toplantı oluşturabilir, dosya paylaşabilir ve AI destekli sorgular çalıştırabilirsiniz. Bağlantı için Azure üzerinde bir App Registration oluşturulması gerekir.

Bağlantı Kurulumu ve Yönetimi​

1.Bağlantı Yöntemi​

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 Microsoft Teams seçin.

4. Bağlantı yöntemi olarak OAuth 2.0 ‘ı seçin

5. Bu bağlantıyı iş akışlarında kimlerin seçip çalıştırabileceğini belirleyin.

6. “Microsoft ile Teams Bağla” seçeneğine tıklayın.

Microsoft hesabıyla yetkilendirme

1. Açılan Microsoft giriş ekranında kurumsal veya kişisel Microsoft hesabınızla oturum açın.
2. SkyStudio'nun Teams’den erişim izni istemesini onaylayın.

2.Bağlantı Yöntemi​

Teams düğümünü kullanabilmek için Azure Portal'da bir App Registration oluşturmanız, gerekli izinleri (Graph API permissions) tanımlamanız ve elde ettiğiniz Tenant ID, Client ID ve Client Secret bilgilerini SkyStudio'ya girmeniz gerekir.

🎬 Videoyu izlemek için tıklayın → Microsoft Teams Bağlantısı Nasıl Kurulur?

Azure App Registration Oluşturma​

1. Yeni uygulama kaydetme

1. portal.azure.com adresine giriş yapın.

2. Arama çubuğuna App registrations yazıp App registrations servisine gidin.

3. + New registration butonuna tıklayın.

4. Uygulamaya bir isim verin (örn. SkyStudio).

5. Supported account types olarak Accounts in this organizational directory only (Single tenant) seçin.

6. Register butonuna tıklayın.

2. Client ID ve Tenant ID kopyalama

Uygulama oluşturulduktan sonra açılan Overview sayfasında şu bilgiler görünür:

• Application (client) ID → bu sizin Client ID'niz
• Directory (tenant) ID → bu sizin Tenant ID'niz

Her ikisini de kopyalayıp bir yere kaydedin. Bu bilgilere daha sonra tekrar erişilebilir.

3. Client Secret oluşturma

1. Sol menüden Certificates & secrets bölümüne gidin.

2. Client secrets sekmesinde + New client secret butonuna tıklayın.

3. Bir Description (açıklama) girin ve Expiration (geçerlilik süresi) seçin.

4. Add butonuna tıklayın.

5. Oluşturulan secret'ın Value sütunundaki değeri hemen kopyalayın.

Not: Client Secret değeri yalnızca oluşturulduğu anda görüntülenir. Sayfayı kapattıktan sonra bir daha tam değerine ulaşamazsınız. Kopyalamayı unutursanız secret'ı silip yeniden oluşturmanız gerekir.

4. API İzinleri (Permissions) ekleme

1. Sol menüden API permissions bölümüne gidin.

2. + Add a permission butonuna tıklayın.

3. Microsoft Graph seçin.

4. Application permissions sekmesini seçin.

5. Teams düğümü için gerekli izinleri arayıp ekleyin:

6. İzinleri ekledikten sonra Grant admin consent butonuna tıklayarak izinleri onaylayın.

Not: Admin consent için Microsoft 365 yönetici hesabına ihtiyacınız vardır. Yetkili değilseniz IT departmanınızdan yardım alın.

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 Microsoft Teams seçin.

4. Aşağıdaki alanları doldurun:

5. Kaydet butonuna tıklayın.

Bağlantıyı Düğüme Atama​

Microsoft Teams düğümünü canvas'a ekledikten sonra sağ paneldeki Uygulama Bağlantıları açılır menüsünden kaydettiğiniz bağlantıyı seçin.

Operasyonlar​

Microsoft Teams düğümü 12 operasyon sunmaktadır:

Kanalları Listele​

Belirtilen team'deki tüm kanalları döndürür. Kanal ID'lerini keşfetmek için kullanılır.

Parametreler​

Kanal Mesajlarını Oku​

Belirtilen kanalın mesaj geçmişini döndürür.

Parametreler​

Kanala Mesaj Gönder​

Belirtilen Teams kanalına mesaj gönderir. Bildirim ve rapor paylaşımı workflow'larında kullanılır.

Parametreler​

Chat Mesajı Gönder​

Belirli bir Teams chat'ine (birebir veya grup chat) mesaj gönderir.

Parametreler​

Toplantı Oluştur​

Yeni bir Microsoft Teams toplantısı oluşturur ve katılım bağlantısı döndürür.

Parametreler​

Teams AI Asistan​

Doğal dil sorgusuyla Teams verilerini sorgular. Video transkriptinden de görebileceğiniz gibi, örneğin son toplantının başlığını doğal dilde sorabilirsiniz.

Parametreler​

Kullanım Örneği​

Query: "Son toplantımın başlığı neydi?"

System Prompt: "Yalnızca son 7 gündeki toplantıları dikkate al. Türkçe yanıt ver."

Team'leri Listele​

Organizasyondaki tüm team'leri listeler. Team ID'lerini keşfetmek için kullanılır.

Parametreler​

Chat'leri Listele​

Kullanıcının dahil olduğu chat'leri (birebir ve grup) listeler.

Parametreler​

Kullanıcı Bilgisi​

Belirli bir kullanıcının (ID veya e-posta ile) Microsoft 365 profil bilgilerini döndürür.

Parametreler​

Kullanıcıları Listele​

Organizasyondaki kullanıcıları listeler, isimle arama yapılabilir.

Parametreler​

Dosya Gönder​

Bir Teams kanalına dosya gönderir. Dosya içeriği base64 veya düz metin olarak sağlanabilir.

Parametreler​

Toplantı Kayıtları​

Belirli bir toplantının kayıt bilgilerini ve erişim bağlantılarını döndürür.

Parametreler​

Sık Karşılaşılan Hatalar​

Notlar​

• Client Secret'ın varsayılan geçerlilik süresi Azure'da 6 ay veya 1 yıldır. Süresi dolduğunda Azure'da yeni bir secret oluşturup SkyStudio bağlantısını güncellemeniz gerekir.
• User Email (işlem yapan kullanıcı) alanına girilen hesabın Teams'e erişimi olmalı ve organizasyonun bir üyesi olmalıdır.
• API izinleri için Admin consent gereklidir; bu işlemi yalnızca Microsoft 365 Global Admin veya Application Admin rolüne sahip kullanıcılar yapabilir.
• Dosya Gönder operasyonunda büyük dosyalar için içeriği base64 formatına çevirmeniz gerekebilir; bunu önceki bir düğümde (örn. LLM veya Transform) yapabilirsiniz.
• Teams AI Asistan operasyonu, bağlı hesabın erişebildiği tüm Teams verilerini sorgulayabilir.

Slack Düğümü​

Slack düğümü, SkyStudio iş akışlarında Slack çalışma alanınızla entegrasyon sağlar. Kanallara mesaj gönderebilir, kanal geçmişini okuyabilir, mesajlarda arama yapabilir, kanal ve kullanıcı listelerini çekebilir ve Slack AI Asistan ile doğal dil sorguları çalıştırabilirsiniz. Bağlantı için Slack Bot Token kullanılır.

Bağlantı Kurulumu ve Yönetimi​

Slack düğümünü kullanabilmek için Slack çalışma alanınızda bir uygulama (Slack App) oluşturup Bot Token almanız gerekir.

Slack Bot Token Alma​

1. Tarayıcıdan api.slack.com/apps adresine gidin ve Slack hesabınızla oturum açın.

2. Create New App butonuna tıklayın ve From scratch seçeneğini seçin.

3. Uygulamaya bir isim verin ve kullanacağınız Slack çalışma alanını seçin.

4. Sol menüden OAuth & Permissions bölümüne gidin.

5. Scopes başlığı altındaki Bot Token Scopes kısmına aşağıdaki izinleri ekleyin:

6. Sayfanın üst kısmındaki Install to Workspace butonuna tıklayın ve izinleri onaylayın.
7. Yükleme tamamlandığında Bot User OAuth Token görüntülenir (xoxb- ile başlar). Bu değeri kopyalayın.

Not: Bot Token xoxb- ön ekiyle başlar. Kullanıcı token'ı (xoxp-) değil, mutlaka Bot Token kullanın.

Botu Kanala Ekleme​

Bot yalnızca üye olduğu kanallara mesaj gönderebilir ve o kanalların geçmişini okuyabilir.

1. Slack uygulamasında ilgili kanalı açın.
2. Mesaj kutusuna /invite @uygulama_adi yazıp gönderin.
3. Bot kanala eklendiğinde işlem tamamlanır.

SkyStudio'ya Bağlantı Ekleme​

1. İş akışı canvas'ının alt araç çubuğundaki zincir ikonuna (Uygulama Bağlantıları) tıklayın.
2. Açılan pencerede + Yeni bağlantı butonuna tıklayın.
3. Sağlayıcı listesinden Slack seçin (İş birliği kategorisi altındadır).
4. Aşağıdaki alanları doldurun:

5. Bağlantı ekleyin butonuna tıklayın.

Not: Tüm alanları tek tek doldurmak yerine Ham JSON olarak düzenleyin butonuna tıklayarak yapılandırmayı JSON olarak yapıştırabilirsiniz.

Erişim Seviyesi Seçimi​

Bağlantıyı Düğüme Atama​

Slack düğümünü canvas'a ekledikten sonra sağ paneldeki Uygulama Bağlantıları açılır menüsünden kaydettiğiniz bağlantıyı seçin.

Operasyonlar​

Slack düğümü 7 operasyon sunmaktadır:

Mesaj Gönder​

Belirtilen kanala veya kişiye mesaj gönderir. Bildirim, rapor paylaşımı ve uyarı senaryolarında en sık kullanılan operasyondur.

Parametreler​

Kullanım Örneği​

Bir workflow'dan otomatik uyarı göndermek için:

• Channel: #satis-bildirimleri
• Text: Günlük satış raporu hazır: {{llm.output}}

Örnek Çıktı​

{
  "ok": true,
  "channel": "C0123ABC456",
  "ts": "1718352000.000100",
  "message": {
    "text": "Günlük satış raporu hazır",
    "user": "U0BOT123"
  }
}

Kanal Mesajlarını Getir​

Belirtilen kanalın mesaj geçmişini getirir. Kanal özeti çıkarma, günlük digest hazırlama gibi senaryolarda kullanılır.

Parametreler​

Örnek Çıktı​

{
  "messages": [
    {
      "user": "U01ABCDEF",
      "text": "Toplantı 15:00'e ertelendi",
      "ts": "1718352000.000100"
    }
  ],
  "has_more": false
}

Mesajlarda Ara​

Çalışma alanı genelinde anahtar kelime, kanal veya kişi filtresiyle mesaj arar.

Parametreler​

Arama Sorgusu Örnekleri​

Slack AI Asistan​

Doğal dil sorgusuyla Slack verilerini sorgular. Hangi kanalda ne konuşulduğunu sormak için kullanılır.

Parametreler​

Kullanım Örneği​

Query: "Bu hafta ürün kanalında hangi kararlar alındı?"

System Prompt: "Sonuçları madde madde, Türkçe ve tarih sırasıyla ver."

Kanalları Listele​

Çalışma alanındaki kanalları listeler. Kanal ID'lerini öğrenmek için kullanılır.

Parametreler​

Kanal Üyelerini Getir​

Belirtilen kanaldaki üyelerin listesini döndürür.

Parametreler​

Kullanıcıları Listele​

Çalışma alanındaki tüm kullanıcıları listeler. Kullanıcı ID'lerini öğrenmek için kullanılır.

Parametreler​

Sık Karşılaşılan Hatalar​

Notlar​

• Bot Token xoxb- formatındadır ve yalnızca botun eklendiği kanallarda çalışır.
• Mesajlarda Ara operasyonu search:read izni gerektirir; bu izin ücretsiz Slack planlarında sınırlı olabilir.
• Özel (private) kanallara erişmek için bot o kanala manuel olarak davet edilmelidir.
• Zengin biçimli mesaj göndermek için Blocks alanına Slack Block Kit JSON'u verebilirsiniz.
• Bir mesaja thread içinde yanıt vermek için Thread TS alanına orijinal mesajın ts değerini girin.
• Kanal adı yerine kanal ID'si kullanmak daha güvenlidir; kanal adı değiştirilirse ID sabit kalır.

Jira Düğümü​

SkyStudio'nun Jira entegrasyonu, Jira projelerinizi workflow'larınıza doğrudan bağlamanızı sağlar. Issue yönetiminden sprint takibine, yorum ve worklog işlemlerine kadar tüm temel Jira operasyonlarını otomatikleştirebilirsiniz.

Bağlantı Kurulumu ve Yönetimi​

Jira düğümlerini kullanabilmek için önce bir Jira bağlantısı tanımlamanız gerekir. Bağlantılar tüm workflow'larınızda yeniden kullanılabilir; bir kez tanımladıktan sonra her düğümde seçmeniz yeterlidir.

Yeni Bağlantı Oluşturma​

Uygulama Bağlantıları ekranına gelin. Yeni Bağlantı’yı seçin. Sağlayıcı listesinden Jira'yı seçin ve aşağıdaki bilgileri doldurun:

Bağlantı Formu Alanları

Not: id.atlassian.com → Güvenlik → API tokenları adımlarını izleyin, yeni bir token oluşturun ve kopyalayıp bu alana yapıştırın.

Formu doldurup Kaydet'e tıkladığınızda bağlantı kaydedilir ve tüm Jira düğümlerinde kullanılabilir hale gelir.

Jira API Anahtarı Alma Adımları

• Jira hesabınıza giriş yapın ve sağ üst köşedeki profil (avatar) simgesine tıklayın.
• Açılan menüden "Hesap ayarları" (Account settings / Manage account) seçeneğine tıklayın.
• Sol menüden "Güvenlik" (Security) sekmesine geçin.
• Güvenlik sayfasında "API tokens" (API belirteçleri) bölümünü bulun ve "Create API token" (API anahtarı oluştur) butonuna tıklayın.
• Açılan pencerede tokene, ne amaçla kullanıldığını belirten açıklayıcı bir isim verin.
• Token için bir geçerlilik süresi (1 ile 365 gün arası, varsayılan 1 yıl) belirleyin.
• "Create" (Oluştur) butonuna tıklayarak anahtarı oluşturun.
• Oluşturulan anahtarı "Copy to clipboard" ile kopyalayın ve güvenli bir yere (tercihen bir şifre yöneticisine) kaydedin.

Not: Bu ekrandan ayrıldıktan sonra token'ı tekrar görüntüleyemezsiniz; bu yüzden oluşturduktan hemen sonra kopyalayıp güvenli bir yere kaydetmeniz gerekir. Belirli izinlerle (scoped) bir token oluşturmak isterseniz aynı sayfada "Create API token with scopes" seçeneğini kullanıp ilgili uygulamayı (Jira/Confluence) ve izin kapsamlarını seçebilirsiniz.

Bağlantıyı Düğüme Atama​

Bağlantı oluşturduktan sonra, her Jira düğümünde Uygulama Bağlantıları açılır menüsünden tanımlı bağlantılarınızı görebilir ve seçebilirsiniz. Bağlantıyı seçtikten sonra çalıştırma ve test süreçlerinde kimlik bilgileri otomatik olarak birleştirilir; düğüm üzerindeki Connection alanı isteğe bağlı yedek olarak işlev görür.

Aktif Bağlantıları Görüntüleme​

Canvas'ın sağ üst köşesindeki Aktif Bağlantılar düğmesine tıklayarak mevcut workflow'da kullanılan tüm araç bağlantılarını görebilirsiniz. Yayınlanan iş akışları bu bağlantılar üzerinden çalışır; dış erişim senaryolarında hangi erişim bilgisinin geçerli olacağını kurumsal politikalarınıza göre değerlendirmeniz önerilir.

Not: Bağlantı alanında / yazarak workflow içindeki diğer düğümlerden dinamik değerler ekleyebilirsiniz.

Operasyonlar​

SkyStudio Jira düğümü aşağıdaki 14 operasyonu destekler. İlk üç operasyon Öne Çıkan olarak işaretlenmiş olup en sık kullanılan senaryolar için tasarlanmıştır.

Öne Çıkan Operasyonlar​

Issue Getir​

Jira'da belirli bir issue'yu key değeri ile getirir. Tek bir issue'nun tüm detaylarına erişmek istediğinizde kullanın.

Giriş Parametreleri

Çıktı

Issue'nun talep edilen tüm alanlarını içeren bir JSON nesnesi döner. summary, status, assignee, priority, description, created, updated gibi standart alanları kapsar.

Örnek Kullanım

Issue Key alanına ENG-101 yazarak sadece özet ve durum bilgisi almak için Fields alanına summary,status girin.

Issue Ara (JQL)​

Jira Query Language (JQL) kullanarak birden fazla issue'yu filtreler ve listeler. Belirli kriterlere uyan issue'ları toplu getirmek için idealdir.

Giriş Parametreleri

Çıktı

JQL sorgusuna uyan issue'ların listesini içeren bir dizi döner. Her eleman, talep edilen alanları içerir.

JQL Örnekleri

project = ENG AND status = "To Do"
assignee = currentUser() AND sprint in openSprints()
project = BUGS AND priority = High AND created >= -7d
labels = "backend" ORDER BY created DESC

Jira AI Asistan​

Doğal dil ile Jira verilerinizi sorgulayabileceğiniz AI destekli bir asistan. JQL bilgisi gerektirmeden karmaşık sorguları çalıştırmanıza olanak tanır.

Giriş Parametreleri

Çıktı

Asistan, sorguyu yorumlayarak ilgili Jira verilerini getirir ve doğal dil formatında yanıt üretir.

Örnek Kullanım

Query alanına "Son 3 günde açılan kritik hataları listele" yazarak herhangi bir JQL yazmadan ilgili issue'ları getirebilirsiniz.

Issue Yönetimi​

Issue Oluştur​

Jira'da yeni bir issue oluşturur. Otomatik hata takibi, görev üretimi veya destek talebi akışlarında kullanılabilir.

Giriş Parametreleri

Çıktı

Oluşturulan issue'nun id, key ve self (URL) bilgilerini içeren bir JSON nesnesi döner.

Issue Durumunu Değiştir​

Mevcut bir issue'nun durumunu günceller. Workflow geçişlerini otomatikleştirmek için kullanılır.

Giriş Parametreleri

Çıktı

Başarılı işlem sonucunda boş bir yanıt döner (HTTP 204).

Not: Transition ID'yi bilmiyorsanız önce Issue Geçişlerini Getir operasyonunu çalıştırarak ilgili issue için mevcut geçişleri ve ID'lerini listeleyin.

Issue Geçişlerini Getir​

Bir issue için mevcut durum geçişlerini ve geçiş ID'lerini listeler. Issue Durumunu Değiştir operasyonundan önce kullanılır.

Giriş Parametreleri

Çıktı

Her geçiş için id, name (örn. "In Progress", "Done") ve to (hedef durum) bilgilerini içeren bir dizi döner.

Proje Operasyonları​

Projeleri Listele​

Bağlı Jira hesabında erişilebilir tüm projeleri listeler.

Giriş Parametreleri

Çıktı

Her proje için id, key, name ve projectTypeKey bilgilerini içeren bir dizi döner.

Proje Getir​

Belirli bir projenin detaylarını key değeri ile getirir.

Giriş Parametreleri

Çıktı

Projenin id, key, name, description, lead ve yapılandırma bilgilerini içeren bir JSON nesnesi döner.

Board Operasyonları​

Board'ları Listele​

Bir projeye ait Scrum veya Kanban board'larını listeler.

Giriş Parametreleri

Çıktı

Her board için id, name ve type (scrum veya kanban) bilgilerini içeren bir dizi döner.

Sprint Operasyonları​

Sprint Issue'larını Getir​

Belirli bir sprint'e ait tüm issue'ları listeler. Sprint bazlı raporlama ve otomasyon için kullanılır.

Giriş Parametreleri

Çıktı

Sprint'e ait issue'ların listesini içeren bir dizi döner.

Yorum Operasyonları​

Yorumları Getir​

Bir issue'ya yapılmış tüm yorumları listeler.

Giriş Parametreleri

Çıktı

Her yorum için id, author, body (yorum içeriği) ve created (tarih) bilgilerini içeren bir dizi döner.

Yorum Ekle​

Mevcut bir issue'ya yeni bir yorum ekler. Bildirim göndermek, durum güncellemek veya not bırakmak için kullanılabilir.

Giriş Parametreleri

Çıktı

Oluşturulan yorumun id, author, body ve created bilgilerini içeren bir JSON nesnesi döner.

Worklog Operasyonları​

Worklog'ları Getir​

Bir issue üzerinde kaydedilmiş tüm zaman takip (worklog) kayıtlarını listeler.

Giriş Parametreleri

Çıktı

Her worklog kaydı için id, author, timeSpent, timeSpentSeconds ve started (başlangıç tarihi) bilgilerini içeren bir dizi döner.

Worklog Ekle​

Bir issue'ya yeni bir zaman takip kaydı ekler. Çalışma sürelerini otomatik olarak loglamak için kullanılır.

Giriş Parametreleri

Çıktı

Oluşturulan worklog kaydının id, author, timeSpent, timeSpentSeconds ve started bilgilerini içeren bir JSON nesnesi döner.Örnek 1: Hata Otomasyonu

Bir formdan gelen hata bilgisini otomatik olarak Jira'ya issue olarak açın:

1. Metin Girişi düğümü ile kullanıcıdan hata bilgisi alın

2. Issue Oluştur düğümüne bağlayın; Project Key: BUGS, Issue Type: Bug, Priority: High olarak ayarlayın

3. Yorum Ekle düğümü ile oluşturulan issue'ya kaynak bilgisi ekleyinÖrnek 2: Sprint Durum Raporu

Aktif sprint'teki tüm issue'ların durumunu raporlayın:

1. Sprint Issue'larını Getir düğümü ile sprint ID'sini girin

2. Jira AI Asistan veya Veri Analizi düğümü ile verileri özetleyin

3. Metin Çıktısı ile raporu kullanıcıya iletinÖrnek 3: Otomatik Worklog

Bir görev tamamlandığında otomatik olarak zaman kaydı oluşturun:

1. Issue Durumunu Değiştir düğümü ile issue'yu Done durumuna alın

2. Worklog Ekle düğümü ile Time Spent: 1h, Comment: Otomatik tamamlandı değerlerini kaydedin

Sık Karşılaşılan Hatalar​

Confluence Düğümü​

Confluence düğümü, SkyStudio workflow'larında Atlassian Confluence ile entegrasyon sağlar. Confluence sayfalarını, alanlarını ve blog yazılarını okuyabilir; AI destekli doğal dil sorguları çalıştırabilirsiniz.

Bağlantı Kurulumu ve Yönetimi​

Confluence düğümünü kullanabilmek için önce bir Atlassian bağlantısı oluşturmanız gerekir.

Yeni 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. Aşağıdaki bilgileri doldurun:

API Token Oluşturma​

1. id.atlassian.com/manage-profile/security/api-tokens adresine gidin.

2. Create API token butonuna tıklayın.

3. Token'a bir etiket verin (örn. SkyStudio) ve oluşturun.

4. Oluşturulan token'ı kopyalayıp SkyStudio'daki API Token alanına yapıştırın.

Not: API token yalnızca bir kez görüntülenebilir. Hemen kopyalamayı unutmayın.

Bağlantıyı Düğüme Atama​

Confluence düğümünü canvas'a sürükledikten sonra sağ paneldeki Uygulama Bağlantıları açılır menüsünden daha önce oluşturduğunuz bağlantıyı seçin. Manuel mod seçildiğinde bağlantı bilgilerini doğrudan alana girebilirsiniz.

Operasyonlar​

Confluence düğümü 7 operasyon sunmaktadır:

Alanları Listele​

Confluence hesabınızdaki tüm alanları (space) döndürür. Hangi alanlara erişiminiz olduğunu keşfetmek ve Space Key değerlerini öğrenmek için kullanılır.

Parametreler​

Örnek Çıktı​

{
  "results": [
    {
      "id": "123456",
      "key": "TECH",
      "name": "Teknik Dokümantasyon",
      "type": "global",
      "status": "current"
    }
  ]
}

Confluence AI Asistan​

Doğal dil kullanarak Confluence verilerini sorgulamanızı sağlar. Karmaşık Confluence sorgularını yazmadan bilgiye ulaşmak için idealdir.

Parametreler​

Kullanım Örneği​

Query: "Onboarding süreciyle ilgili sayfaları bul"

System Prompt: "Yalnızca son 6 ayda güncellenen sayfaları dikkate al"

Not: System Prompt ile AI asistanına belirli bir alan, yazar veya zaman dilimi gibi kısıtlamalar tanımlayabilirsiniz.

Sayfaları Listele​

Belirli bir Confluence alanındaki (space) sayfaların listesini döndürür.

Parametreler​

Örnek Çıktı​

{
  "results": [
    {
      "id": "98765",
      "title": "API Entegrasyon Rehberi",
      "space": { "key": "TECH" },
      "version": { "number": 5 },
      "_links": { "webui": "/spaces/TECH/pages/98765" }
    }
  ]
}

Sayfaları İçeriğini Getir​

Sayfa ID'si ile Confluence'daki bir sayfanın tam içeriğini getirir.

Parametreler​

Page ID Nasıl Bulunur?​

Confluence'da sayfayı açın. URL'deki /pages/ kısmından sonra gelen sayısal değer Page ID'dir. Örnek: https://sirketim.atlassian.net/wiki/spaces/TECH/pages/98765 → Page ID: 98765

Body Format Seçenekleri​

• storage — Confluence'ın iç XML formatı (varsayılan)
• view — HTML görünüm formatı
• export_view — Dışa aktarım için optimize edilmiş HTML

Alt Sayfaları Getir​

Bir üst sayfanın (parent page) doğrudan veya tüm hiyerarşik alt sayfalarını getirir. Sayfa ağaçlarını haritalamak için kullanışlıdır.

Parametreler​

Recursive Modu Hakkında​

Recursive (All Children) seçeneği kapalıyken yalnızca bir seviye aşağıdaki doğrudan alt sayfalar döner. Açık olduğunda tüm hiyerarşi (torunlar dahil) getirilir.

Sayfa Tarihçesini Getir​

Bir Confluence sayfasının tüm revizyon geçmişini döndürür. Kim, ne zaman değiştirdi bilgisiyle denetim ve takip senaryoları için uygundur.

Parametreler​

Örnek Çıktı​

{
  "results": [
    {
      "number": 7,
      "when": "2024-11-15T10:23:00.000Z",
      "by": { "displayName": "Ahmet Yılmaz" },
      "message": "Kurulum adımları güncellendi"
    }
  ]
}

Blog Sayfalarını Getir​

Belirli bir Confluence alanındaki blog yazılarını (blog posts) listeler.

Parametreler​

Sık Karşılaşılan Hatalar​

Notlar​

• File Path parametresi, büyük veri döndüren operasyonlarda sonucu doğrudan bir dosyaya kaydetmek için kullanılır. Workflow içinde daha sonra bu dosyayı işleyebilirsiniz.
• Get All (Auto Paginate) seçeneği çok sayıda kayıt olan alanlarda yavaşlamaya yol açabilir; Limit ile birlikte kullanmanız önerilir.
• Confluence Cloud ve Confluence Server API'leri farklıdır; bu düğüm Confluence Cloud (Atlassian Cloud) için tasarlanmıştır.

Notion Düğümü​

Notion düğümü, 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 düğümünü 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.

Not: 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ı Düğüme Atama​

Notion düğümünü 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 düğümü 8 operasyon sunmaktadır:

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​

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​

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​

Ö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​

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​

Ö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​

Sayfa Oluştur​

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

Parametreler​

Ö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​

Sık Karşılaşılan Hatalar​

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 düğümüne göndermeden önce içeriği kısaltmayı veya filtrelemeyi düşünün.

HubSpot Düğümü​

HubSpot düğümü, SkyStudio workflow'larında HubSpot CRM ile entegrasyon sağlar. Kişi, fırsat (deal) ve şirket kayıtlarını okuyabilir, filtreleyebilir ve AI destekli sorgular çalıştırabilirsiniz.

Bağlantı Kurulumu ve Yönetimi​

HubSpot düğümünü kullanabilmek için HubSpot'ta bir Private App oluşturmanız ve erişim token'ını SkyStudio'ya eklemeniz gerekir.

Private App Token Alma​

1. HubSpot hesabınıza giriş yapın.

2. Sağ üstteki profil simgesinden Ayarlar'a gidin.

3. Sol menüden Entegrasyonlar → Private Apps bölümünü açın.

4. Uygulama Oluştur butonuna tıklayın.

5. Uygulamaya bir ad verin ve gerekli izin kapsamlarını (scopes) seçin:

• CRM → crm.objects.contacts.read, crm.objects.deals.read, crm.objects.companies.read

6. Uygulamayı Oluştur butonuna tıklayın.

7. Oluşturulan Access Token'ı kopyalayın (pat-eu1-… veya pat-na1-… ile başlar).

Not: Token yalnızca bir kez tam olarak görüntülenir. Kopyalamayı unutursanız token'ı yeniden oluşturmanız gerekir.

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 HubSpot seçin.

4. Bağlantı Adı alanına tanımlayıcı bir isim girin (örn. Prod HubSpot).

5. Private App Erişim Token'ı alanına kopyaladığınız token'ı yapıştırın.

6. Kaydet butonuna tıklayın.

Bağlantıyı Düğüme Atama​

HubSpot düğümünü canvas'a ekledikten sonra sağ paneldeki Uygulama Bağlantıları açılır menüsünden kaydettiğiniz bağlantıyı seçin.

Not: Farklı HubSpot portalları için (örn. test ve canlı) ayrı bağlantılar tanımlayabilir ve workflow'da hangisini kullanacağınızı seçebilirsiniz.

Operasyonlar​

HubSpot düğümü 7 operasyon sunmaktadır:

Kişileri Getir​

HubSpot CRM'deki tüm kişi (contact) kayıtlarını döndürür. Toplu kişi listesi çekme ve senkronizasyon senaryolarında kullanılır.

Parametreler​

Properties Örnekleri​

firstname, lastname, email, phone, company, jobtitle, city, country, createdate, lastmodifieddate, hubspot_owner_id

Örnek Çıktı​

{
  "results": [
    {
      "id": "12345",
      "properties": {
        "firstname": "Ahmet",
        "lastname": "Yılmaz",
        "email": "ahmet@sirket.com",
        "phone": "+905551234567",
        "company": "Örnek A.Ş."
      }
    }
  ]
}

Fırsatları Getir​

HubSpot CRM'deki tüm fırsat (deal) kayıtlarını döndürür. Satış pipeline takibi ve raporlama workflow'larında kullanılır.

Parametreler​

Properties Örnekleri​

dealname, amount, dealstage, closedate, pipeline, hubspot_owner_id, createdate, hs_lastmodifieddate

Örnek Çıktı​

{
  "results": [
    {
      "id": "67890",
      "properties": {
        "dealname": "Kurumsal Lisans - Örnek A.Ş.",
        "amount": "15000",
        "dealstage": "presentationscheduled",
        "closedate": "2024-12-31T00:00:00.000Z"
      }
    }
  ]
}

Nesne Ara​