Uygulama Düğümleri

5. Uygulama Düğümleri

Uygulama düğümleri, SkyStudio iş akışlarının harici uygulamalar ve servislerle bağlantı kurmasını sağlar.

Bu düğümler üzerinden e-posta ve takvim işlemleri gerçekleştirilebilir, dosya ve dokümanlara erişilebilir, mesajlaşma ve iş birliği platformları kullanılabilir, proje yönetimi ve CRM sistemleriyle çalışılabilir, toplantı kayıtları işlenebilir ve yazılım geliştirme süreçleri iş akışlarına dahil edilebilir.

Uygulama düğümlerinin büyük bölümünde kullanılmadan önce ilgili servis için bir Uygulama Bağlantısı oluşturulması gerekir.

Genel kullanım süreci aşağıdaki şekildedir:

1. İş akışı çalışma alanından Düğüm Ekle seçeneğini kullanın.
2. Kullanmak istediğiniz uygulama düğümünü seçin.
3. Düğümün gerçekleştireceği operasyonu belirleyin.
4. Gerekliyse ilgili servis için bir Uygulama Bağlantısı oluşturun.
5. Düğümün sağ panelindeki Uygulama Bağlantıları alanından oluşturduğunuz bağlantıyı seçin.
6. Seçilen operasyona ait gerekli parametreleri yapılandırın.
7. Önceki düğümlerin çıktılarını kullanmak için ilgili parametre alanında / karakterini kullanın.
8. Yapılandırmayı tamamladıktan sonra düğümü Test seçeneğiyle çalıştırarak bağlantı ve parametrelerin doğru çalıştığını kontrol edin.

---

5.1. Outlook​

Outlook düğümü, SkyStudio iş akışlarının Microsoft Outlook e-posta hesabıyla çalışmasını sağlar.

Bu düğüm üzerinden e-posta gönderilebilir ve Outlook gelen kutusunda gelişmiş arama ve filtreleme işlemleri gerçekleştirilebilir.

Bağlantı Kurulumu ve Yönetimi​

Outlook düğümü Microsoft'un OAuth 2.0 yetkilendirme yöntemini kullanır. API anahtarı veya manuel token girilmesine gerek yoktur.

Bağlantıyı doğrudan düğüm üzerinden oluşturmak için:

1. İş akışına Outlook düğümünü ekleyin.
2. Düğüme tıklayarak sağ yapılandırma panelini açın.
3. Mail Gönder veya Mail Ara operasyonlarından birini seçin.
4. Microsoft Outlook'a Bağlan seçeneğine tıklayın.
5. Açılan Microsoft giriş ekranında kurumsal veya kişisel Microsoft hesabınızla oturum açın.
6. SkyStudio'nun Outlook hesabına erişmesi için istenen izinleri onaylayın.
7. Yetkilendirme tamamlandığında bağlantı aktif hale gelir.

Bağlantı ayrıca Uygulama Bağlantıları ekranından oluşturulabilir:

1. SkyStudio sol menüsündeki Uygulama Bağlantıları bölümüne gidin.
2. Yeni Bağlantı Ekle seçeneğine tıklayın.
3. Sağlayıcı olarak Microsoft Outlook seçin.
4. Bağlantı Adı alanına açıklayıcı bir isim girin.
5. Microsoft ile Yetkilendir seçeneğini kullanın.
6. Microsoft hesabıyla giriş ve izin işlemlerini tamamlayın.
7. Yetkilendirme tamamlandığında bağlantı otomatik olarak kaydedilir.

OAuth yetkilendirmesi Microsoft'un resmi giriş ekranı üzerinden gerçekleştirilir. SkyStudio Microsoft hesabınızın şifresini görmez veya saklamaz.

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

Outlook düğümünü çalışma alanına ekledikten sonra sağ panelde bulunan Uygulama Bağlantıları alanından oluşturduğunuz bağlantıyı seçin.

Kişisel ve kurumsal Outlook hesapları için ayrı bağlantılar oluşturabilirsiniz.

Operasyonlar​

Outlook düğümü iki operasyon sunar:

Operasyon	Açıklama
Mail Gönder	Outlook üzerinden yeni bir e-posta oluşturur ve gönderir.
Mail Ara	Outlook gelen kutusunda arama ve filtreleme gerçekleştirir.

Mail Gönder​

Bağlı Microsoft Outlook hesabı üzerinden e-posta gönderir.

Temel parametreler:

Parametre	Zorunlu	Açıklama
Connection	Evet	Kullanılacak Outlook bağlantısı
To	Evet	Alıcı e-posta adresi
Subject	Evet	E-postanın konu satırı
Body	Evet	E-posta içeriği
CC	Hayır	Kopyaya eklenecek adresler
BCC	Hayır	Gizli kopyaya eklenecek adresler

Birden fazla alıcı kullanılacaksa e-posta adresleri virgülle ayrılabilir.

Önceki düğümlerde oluşturulan metinler Body alanına / üzerinden bağlanabilir.

Mail Ara​

Outlook gelen kutusunda anahtar kelime, gönderen veya konu gibi kriterlere göre arama gerçekleştirir.

Temel parametreler:

Parametre	Zorunlu	Açıklama
Connection	Evet	Kullanılacak Outlook bağlantısı
Search Query	Evet	Arama sorgusu
Folder	Hayır	Aranacak klasör
Limit	Hayır	Döndürülecek maksimum e-posta sayısı

Arama sorgusu örnekleri:

• fatura
• from:ahmet@sirket.com
• subject:toplantı
• hasAttachment:true

---

5.2. Outlook Calendar​

Outlook Calendar düğümü, SkyStudio iş akışlarının Microsoft Outlook takvimiyle çalışmasını sağlar.

Bu düğüm üzerinden etkinlikler listelenebilir, oluşturulabilir, güncellenebilir ve silinebilir. Ayrıca kullanıcıların müsaitlik bilgileri kontrol edilebilir ve doğal dil kullanılarak takvim verileri sorgulanabilir.

Bağlantı Kurulumu ve Yönetimi​

Outlook Calendar iki farklı bağlantı yöntemiyle kullanılabilir:

• OAuth 2.0
• Azure App Registration

OAuth 2.0 ile bağlantı oluşturmak için:

1. Uygulama Bağlantıları bölümüne gidin.
2. Yeni Bağlantı Ekle seçeneğine tıklayın.
3. Sağlayıcı olarak Outlook Takvimi seçin.
4. Bağlantı yöntemi olarak OAuth 2.0 seçin.
5. Bağlantıyı iş akışlarında kimlerin kullanabileceğini belirleyin.
6. Microsoft ile Takvim Bağla seçeneğine tıklayın.
7. Microsoft hesabınızla oturum açın.
8. İstenen takvim erişim izinlerini onaylayın.

Azure App Registration Oluşturma​

Kurumsal bağlantı için Azure App Registration kullanılabilir.

1. Azure Portal'a giriş yapın.
2. App registrations bölümüne gidin.
3. New registration seçeneğine tıklayın.
4. Uygulamaya açıklayıcı bir ad verin.
5. Hesap türü olarak Single tenant seçin.
6. Uygulamayı oluşturun.
7. Application (client) ID değerini kopyalayın.
8. Directory (tenant) ID değerini kopyalayın.
9. Certificates & secrets bölümüne gidin.
10. New client secret seçeneğiyle bir Client Secret oluşturun.
11. Oluşturulan secret'ın Value değerini hemen kopyalayın.

Client Secret değeri yalnızca oluşturulduğu anda tam olarak görüntülenir.

API İzinleri​

Outlook Calendar işlemleri için Microsoft Graph üzerinde ihtiyaç duyulan izinler tanımlanmalıdır.

İzin	Açıklama
Calendars.Read	Takvim etkinliklerini okumak
Calendars.ReadWrite	Etkinlik oluşturmak, güncellemek ve silmek
User.Read.All	Kullanıcı ve müsaitlik bilgilerine erişmek

İzinler eklendikten sonra gerekli durumlarda Grant admin consent işlemi yapılmalıdır.

SkyStudio'ya Bağlantı Ekleme​

Azure yöntemi kullanılırken aşağıdaki bilgiler girilir:

• Bağlantı Adı
• Tenant ID
• Client ID
• Client Secret
• User Email

Bağlantı kaydedildikten sonra Outlook Calendar düğümünün Uygulama Bağlantıları alanından seçilir.

Operasyonlar​

Outlook Calendar aşağıdaki operasyonları sunar:

• Etkinlikleri Getir
• Bugünün Etkinlikleri
• Yaklaşan Etkinlikler
• Müsaitlik Kontrolü
• Outlook Takvim AI Asistan
• Takvimleri Listele
• Etkinlik Getir
• Etkinlik Oluştur
• Etkinlik Güncelle
• Etkinlik Sil

Etkinlik Oluştur​

Yeni bir takvim etkinliği oluştururken aşağıdaki bilgiler kullanılabilir:

• Calendar ID
• Subject
• Body
• Start Date Time
• End Date Time
• Timezone
• Location
• Attendees
• Teams Meeting
• All Day Event

Tarih ve saat değerleri YYYY-MM-DDTHH:MM:SS formatında girilir.

Türkiye için Timezone değeri Europe/Istanbul olarak kullanılabilir.

Teams Meeting etkinleştirildiğinde toplantıya otomatik Teams bağlantısı eklenebilir. Bunun için App Registration üzerinde gerekli Online Meetings izinlerinin bulunması gerekir.

Müsaitlik Kontrolü​

Bir veya birden fazla kullanıcının belirli zaman aralığındaki müsaitliği kontrol edilebilir.

Birden fazla e-posta adresi virgülle ayrılarak girilebilir.

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

• 401 Unauthorized: Client Secret süresi dolmuş olabilir.
• 403 Forbidden: Calendars.ReadWrite izni eksik olabilir.
• Event not found: Event ID yanlış olabilir.
• Invalid datetime format: Tarih formatını kontrol edin.
• Boş etkinlik listesi: Calendar ID veya tarih aralığını kontrol edin.

---

5.3. Google Calendar​

Google Calendar düğümü, SkyStudio iş akışlarının Google Takvim ile çalışmasını sağlar.

Etkinlikler okunabilir, oluşturulabilir, güncellenebilir ve silinebilir. Ayrıca doğal dil kullanılarak takvim verileri sorgulanabilir.

Bağlantı Kurulumu ve Yönetimi​

1. SkyStudio sol menüsünden Uygulama Bağlantıları bölümüne gidin.
2. Yeni Bağlantı Ekle seçeneğine tıklayın.
3. Sağlayıcı olarak Google Calendar seçin.
4. Google ile Yetkilendir seçeneğine tıklayın.
5. Açılan Google OAuth ekranında kullanacağınız hesabı seçin.
6. İstenen erişim izinlerini onaylayın.
7. Yetkilendirme tamamlandığında bağlantı otomatik olarak kaydedilir.

Google Calendar OAuth 2.0 kullanır. Google hesabınızın şifresi SkyStudio'ya iletilmez.

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

Google Calendar düğümünü çalışma alanına ekledikten sonra sağ paneldeki Uygulama Bağlantıları alanından oluşturduğunuz Google bağlantısını seçin.

Calendar ID​

Calendar ID, hangi takvim üzerinde işlem yapılacağını belirler.

Değer	Açıklama
primary	Kullanıcının varsayılan takvimi
Kullanıcı e-postası	Belirli bir takvim
Özel ID	Google Takvim tarafından oluşturulan benzersiz kimlik

Calendar ID, Google Takvim içerisindeki Takvim Ayarları → Takvim entegrasyonu → Takvim Kimliği alanından alınabilir.

Operasyonlar​

Google Calendar dokuz operasyon sunar:

• Etkinlikleri Getir
• Bugünün Etkinlikleri
• Yaklaşan Etkinlikler
• Google Takvim AI Asistan
• Takvimleri Listele
• Etkinlik Getir
• Etkinlik Oluştur
• Etkinlik Güncelle
• Etkinlik Sil

Etkinlik Oluştur​

Temel parametreler:

• Connection
• Calendar ID
• Title
• Description
• Start Date Time
• End Date Time
• Timezone
• Location
• Attendees
• All Day Event

Birden fazla katılımcı virgülle ayrılmış e-posta adresleriyle eklenebilir.

Kullanım Notları​

Tarih/saat değerleri YYYY-MM-DDTHH:MM:SS formatında kullanılmalıdır.

Timezone ayrı bir parametre olarak tanımlanır.

Türkiye için Europe/Istanbul kullanılabilir.

Etkinlik Güncelle yalnızca belirtilen alanları değiştirir.

Etkinlik Sil kalıcı bir işlemdir.

---

5.4. Google Drive​

Google Drive düğümü, SkyStudio iş akışlarının Google Drive ve Google Sheets ile çalışmasını sağlar.

Dosya arama, dosya okuma, klasör yönetimi ve elektronik tablo işlemleri gerçekleştirilebilir.

Bağlantı Kurulumu ve Yönetimi​

Önerilen bağlantı yöntemi OAuth 2.0'dır.

1. Uygulama Bağlantıları bölümünü açın.
2. Google Drive sağlayıcısını seçin.
3. Bağlantı yönteminin OAuth 2.0 olduğundan emin olun.
4. Bağlantıya açıklayıcı bir ad verin.
5. Google ile Yetkilendir seçeneğine tıklayın.
6. Google hesabınızı seçin.
7. Drive ve Sheets erişimi için istenen izinleri onaylayın.
8. Yetkilendirme tamamlandığında bağlantı kaydedilir.

Gelişmiş kullanımda Google Cloud kimlik bilgileri JSON formatında manuel olarak da tanımlanabilir.

Operasyonlar​

Google Drive 13 operasyon sunar:

• Dosyaları Listele
• Dosya Ara
• Google Drive AI Asistan
• Spreadsheet Satırları Getir
• Dosya İçeriğini Oku
• Dosyaya Sor
• Dosya Bilgisi Getir
• Klasör Oluştur
• Spreadsheet Bilgisi
• Satır Ekle
• Hücre Güncelle
• Hücreleri Temizle
• Spreadsheet Oluştur

Dosyaları Listele​

Belirli bir klasördeki dosya ve klasörleri listeler.

Folder ID boş bırakılırsa Drive'ın kök dizini kullanılır.

Folder ID, Google Drive klasör URL'sindeki /folders/ bölümünden sonraki değerdir.

Spreadsheet Satırları Getir​

Google Sheets içerisindeki belirli hücre aralığındaki satırları getirir.

Range örnekleri:

• Sheet1
• Sheet1!A1:D50
• Sheet1!A:A
• Sheet1!1:10

Spreadsheet ID, Sheets URL'sindeki /d/ ile /edit arasındaki değerdir.

Dosya İçeriğini Oku​

Google Drive üzerindeki dosyanın içeriğini okur.

Google Docs, Google Sheets, Google Slides, PDF, TXT ve DOCX gibi metin tabanlı içerikler kullanılabilir.

AI analizi yapılacaksa ayrıca analiz talimatı ve yanıt dili belirtilebilir.

Dosyaya Sor​

Belirli bir Google Drive dosyasının içeriğine doğal dilde soru sorulmasını sağlar.

Google Sheets İşlemleri​

Satır Ekle, mevcut Sheet'e yeni satır ekler.

Hücre Güncelle, belirlenen Range içerisindeki değerleri değiştirir.

Hücreleri Temizle, hücre içeriklerini kaldırır ancak biçimlendirmeyi korur.

Spreadsheet Oluştur, yeni bir Google Sheets dosyası oluşturur.

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

• 401 Unauthorized: Google hesabını yeniden yetkilendirin.
• 403 Forbidden: Dosya paylaşım izinlerini kontrol edin.
• 404 File not found: File ID veya Spreadsheet ID'yi kontrol edin.
• Invalid range: Range formatını kontrol edin.
• Quota exceeded: Google API kotası aşılmış olabilir.

---

5.5. SharePoint​

SharePoint düğümü, SkyStudio iş akışlarının SharePoint sitelerindeki listelere, dosyalara ve sayfalara erişmesini sağlar.

Bağlantı Kurulumu ve Yönetimi​

SharePoint iki yöntemle bağlanabilir:

• OAuth 2.0
• Azure App Registration

OAuth 2.0 için:

1. Uygulama Bağlantıları bölümünü açın.
2. Yeni Bağlantı Ekle seçeneğine tıklayın.
3. Sağlayıcı olarak SharePoint seçin.
4. OAuth 2.0 yöntemini seçin.
5. Bağlantıyı kimlerin kullanabileceğini belirleyin.
6. Microsoft ile SharePoint Bağla seçeneğine tıklayın.
7. Microsoft hesabınızla giriş yapın.
8. İstenen erişim izinlerini onaylayın.

Azure App Registration​

Kurumsal bağlantıda aşağıdaki bilgiler kullanılır:

• Tenant ID
• Client ID
• Client Secret
• Site URL

Microsoft Graph üzerinde ihtiyaç duyulan izinler:

• Sites.Read.All
• Sites.ReadWrite.All
• Files.Read.All
• Files.ReadWrite.All

İzinlerden sonra gerekli durumlarda Grant admin consent işlemi yapılmalıdır.

Operasyonlar​

SharePoint 11 operasyon sunar:

• Liste Öğelerini Getir
• Dosyaları Listele
• Ara
• SharePoint AI Asistan
• Siteleri Listele
• Liste Öğesi Getir
• Liste Öğesi Oluştur
• Liste Öğesi Güncelle
• Dosya İndir / Oku
• Dosya Yükle
• Sayfa İçeriğini Oku

Liste İşlemleri​

Liste verileri OData ifadeleriyle filtrelenebilir.

Örneğin:

• Status eq 'Tamamlandı'
• Priority eq 'Yüksek'
• contains(Title, 'proje')

Liste öğesi oluşturma ve güncelleme işlemlerinde alanlar JSON formatında tanımlanabilir.

Dosya İşlemleri​

Dosya okuma işlemlerinde Item ID veya File Path kullanılabilir.

Dosya yükleme işleminde Library Name, Folder Path, File Name ve Content bilgileri tanımlanır.

Kullanım Notları​

Farklı SharePoint siteleri için ayrı bağlantılar kullanılabilir.

Liste adları büyük/küçük harfe duyarlı olabilir.

OData sorgularında alanların SharePoint internal name değerlerinin kullanılması gerekebilir.

---

5.6. Microsoft Teams​

Microsoft Teams düğümü, Teams içerisindeki mesajlaşma, toplantı, kullanıcı ve dosya işlemlerinin iş akışlarında kullanılmasını sağlar.

Bağlantı Kurulumu ve Yönetimi​

Teams bağlantısı OAuth 2.0 veya Azure App Registration ile gerçekleştirilebilir.

OAuth 2.0 için:

1. Uygulama Bağlantıları bölümüne gidin.
2. Yeni Bağlantı Ekle seçeneğine tıklayın.
3. Microsoft Teams sağlayıcısını seçin.
4. OAuth 2.0 yöntemini seçin.
5. Microsoft ile Teams Bağla seçeneğine tıklayın.
6. Microsoft hesabınızla oturum açın.
7. İstenen izinleri onaylayın.

Azure App Registration​

1. Azure Portal'da App Registration oluşturun.
2. Client ID ve Tenant ID değerlerini alın.
3. Client Secret oluşturun.
4. Gerekli Microsoft Graph izinlerini ekleyin.
5. Gerekli durumlarda Admin Consent verin.
6. Bilgileri SkyStudio bağlantısına girin.

API İzinleri​

Kaynak dokümanda Teams için şu izinler yer alır:

• Team.ReadBasic.All
• Channel.ReadBasic.All
• ChannelMessage.Read.All
• ChannelMessage.Send
• Chat.ReadWrite.All
• OnlineMeetings.ReadWrite.All
• Files.ReadWrite.All
• User.Read.All

Operasyonlar​

Microsoft Teams 12 operasyon sunar:

• Kanalları Listele
• Kanal Mesajlarını Oku
• Kanala Mesaj Gönder
• Chat Mesajı Gönder
• Toplantı Oluştur
• Teams AI Asistan
• Team'leri Listele
• Chat'leri Listele
• Kullanıcı Bilgisi
• Kullanıcıları Listele
• Dosya Gönder
• Toplantı Kayıtları

Kanala Mesaj Gönder​

Temel olarak Team ID, Channel ID ve Message bilgileri kullanılır.

Mesaj tipi text veya HTML olabilir.

Toplantı Oluştur​

Toplantı oluştururken:

• Toplantı Başlığı
• Başlangıç
• Bitiş
• Timezone
• Katılımcılar

alanları kullanılabilir.

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

• 401 Unauthorized: Client Secret'ı kontrol edin.
• 403 Forbidden: Graph API izinlerini kontrol edin.
• Team/Channel bulunamadı: Team ID veya Channel ID yanlış olabilir.
• AADSTS700016: Client ID'yi kontrol edin.

---

5.7. Slack​

Slack düğümü, SkyStudio iş akışlarının Slack çalışma alanıyla çalışmasını sağlar.

Kanallara mesaj gönderilebilir, mesaj geçmişi okunabilir, çalışma alanında arama yapılabilir ve kullanıcı/kanal bilgileri alınabilir.

Slack App Oluşturma​

1. Slack API Apps ekranını açın.
2. Create New App seçeneğine tıklayın.
3. From scratch seçeneğini kullanın.
4. Uygulamaya ad verin.
5. Kullanılacak Slack workspace'i seçin.
6. OAuth & Permissions bölümünü açın.

Bot Token Scope'ları​

Kullanılacak operasyonlara göre aşağıdaki scope'lar eklenebilir:

Scope	Kullanım
chat:write	Mesaj göndermek
channels:history	Kanal mesajlarını okumak
channels:read	Kanalları listelemek
groups:read	Özel kanalları görmek
users:read	Kullanıcıları listelemek
search:read	Mesajlarda arama yapmak

Scope'lar eklendikten sonra:

1. Install to Workspace seçeneğine tıklayın.
2. İzinleri onaylayın.
3. Oluşturulan Bot User OAuth Token değerini kopyalayın.

Bot Token xoxb- ile başlamalıdır.

Botu Kanala Ekleme​

Bot yalnızca üye olduğu kanallarda işlem yapabilir.

İlgili kanalda:

/invite @uygulama_adi

komutunu kullanın.

SkyStudio Bağlantısı​

1. Uygulama Bağlantıları alanını açın.
2. Yeni Bağlantı oluşturun.
3. Sağlayıcı olarak Slack seçin.
4. Bağlantı adını ve erişim seviyesini belirleyin.
5. xoxb- ile başlayan Bot Token'ı ekleyin.
6. Bağlantıyı kaydedin.

Operasyonlar​

Slack yedi operasyon sunar:

• Kanal Mesajlarını Getir
• Mesaj Gönder
• Mesajlarda Ara
• Slack AI Asistan
• Kanalları Listele
• Kanal Üyelerini Getir
• Kullanıcıları Listele

Mesaj Gönder​

Channel alanına kanal adı, kanal ID'si veya kullanıcı ID'si girilebilir.

Thread içerisinde yanıt vermek için Thread TS kullanılabilir.

Zengin içerikli mesajlar için Blocks alanına Slack Block Kit JSON'u eklenebilir.

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

• not_in_channel: Botu kanala ekleyin.
• channel_not_found: Kanal ID'sini kontrol edin.
• invalid_auth: Bot Token'ı kontrol edin.
• missing_scope: Gerekli scope'u ekleyin.
• ratelimited: İstek sıklığını azaltın.
• not_allowed_token_type: xoxb- Bot Token kullanın.

---

5.8. Jira​

Jira düğümü, Jira projelerindeki issue, proje, board, sprint, yorum ve worklog işlemlerinin SkyStudio iş akışlarında kullanılmasını sağlar.

Bağlantı Kurulumu ve Yönetimi​

1. Uygulama Bağlantıları ekranını açın.
2. Yeni Bağlantı seçeneğine tıklayın.
3. Sağlayıcı olarak Jira seçin.
4. Bağlantı bilgilerini girin.

Temel bilgiler:

Alan	Açıklama
Bağlantı adı	Prod Jira, Test Jira gibi açıklayıcı ad
Jira Cloud alan adı	sirketiniz.atlassian.net
E-posta	Atlassian hesabınızın e-posta adresi
API Token	Atlassian API Token

API Token Oluşturma​

1. Atlassian hesabınıza giriş yapın.
2. Account Settings / Manage Account bölümüne gidin.
3. Security sekmesini açın.
4. API Tokens bölümüne gidin.
5. Create API Token seçeneğine tıklayın.
6. Token'a açıklayıcı bir ad verin.
7. Geçerlilik süresini belirleyin.
8. Token'ı oluşturun.
9. Oluşturulan token'ı hemen kopyalayın.

Token daha sonra tekrar tam olarak görüntülenemeyebileceği için güvenli şekilde saklanmalıdır.

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

Jira düğümünü çalışma alanına ekledikten sonra Uygulama Bağlantıları alanından oluşturduğunuz Jira bağlantısını seçin.

Aynı bağlantı birden fazla iş akışında kullanılabilir.

Operasyonlar​

Jira 14 operasyon sunar:

• Issue Getir
• Issue Ara (JQL)
• Jira AI Asistan
• Issue Oluştur
• Issue Durumunu Değiştir
• Issue Geçişlerini Getir
• Projeleri Listele
• Proje Getir
• Board'ları Listele
• Sprint Issue'larını Getir
• Yorumları Getir
• Yorum Ekle
• Worklog'ları Getir
• Worklog Ekle

Issue Ara (JQL)​

JQL kullanılarak issue'lar filtrelenebilir.

Örnekler:

• 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

Issue Oluştur​

Temel alanlar:

• Project Key
• Summary
• Issue Type
• Description
• Assignee Account ID
• Priority
• Labels

Issue Type; Bug, Task, Story veya Epic gibi Jira'da tanımlanmış bir değer olabilir.

Issue Durumunu Değiştir​

Bir issue'nun durumunu değiştirmek için Transition ID gerekir.

Transition ID bilinmiyorsa önce Issue Geçişlerini Getir operasyonunu çalıştırın.

Worklog Ekle​

Temel parametreler:

• Issue Key
• Time Spent
• Comment
• Started At

Time Spent örnekleri:

• 2h 30m
• 1d
• 45m

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

• 404 Issue not found: Issue Key'i kontrol edin.
• 400 Invalid JQL: JQL sorgusunu kontrol edin.
• 403 Forbidden: Kullanıcının proje izinlerini kontrol edin.
• Transition not found: Geçerli Transition ID'leri yeniden listeleyin.

---

5.9. Confluence​

Confluence düğümü, SkyStudio iş akışlarının Atlassian Confluence içeriğiyle çalışmasını sağlar.

Confluence alanları, sayfaları, alt sayfaları, blog içerikleri ve sayfa geçmişi iş akışlarında kullanılabilir.

Bağlantı Kurulumu ve Yönetimi​

1. Uygulama Bağlantıları bölümüne gidin.
2. Yeni Bağlantı Ekle seçeneğine tıklayın.
3. Sağlayıcı olarak Confluence seçin.
4. Aşağıdaki bilgileri girin:

• Bağlantı adı
• Confluence Cloud alan adı
• Atlassian e-posta adresi
• API Token

Cloud domain örneği:

sirketim.atlassian.net

API Token Oluşturma​

1. Atlassian hesabının Security/API Token bölümünü açın.
2. Create API Token seçeneğine tıklayın.
3. Token'a açıklayıcı bir etiket verin.
4. Token'ı oluşturun.
5. Değeri hemen kopyalayarak SkyStudio bağlantısına ekleyin.

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

Confluence düğümünü çalışma alanına ekledikten sonra Uygulama Bağlantıları alanından oluşturduğunuz bağlantıyı seçin.

Operasyonlar​

Confluence yedi operasyon sunar:

• Alanları Listele
• Confluence AI Asistan
• Sayfaları Listele
• Sayfa İçeriğini Getir
• Alt Sayfaları Getir
• Sayfa Tarihçesini Getir
• Blog Sayfalarını Getir

Sayfaları Listele​

Belirli bir Confluence Space içerisindeki sayfaları listeler.

Kullanılabilecek alanlar arasında:

• Space Key
• Expand Fields
• Get All
• Limit
• File Path

bulunur.

Sayfa İçeriğini Getir​

Page ID kullanılarak belirli bir sayfanın içeriği alınabilir.

Body Format seçenekleri:

• storage
• view
• export_view

Page ID, Confluence sayfasının URL'sindeki /pages/ bölümünden sonraki sayısal değerdir.

Kullanım Notları​

Bu bağlantı yapısı Confluence Cloud / Atlassian Cloud için tasarlanmıştır.

Confluence Server API yapısı farklı olabilir.

Büyük sayfa içeriklerinin LLM'e gönderilmeden önce filtrelenmesi veya kısaltılması önerilebilir.

---

5.10. Notion​

Notion düğümü, SkyStudio iş akışlarının Notion çalışma alanıyla çalışmasını sağlar.

Sayfa ve database kayıtları okunabilir, yeni sayfa oluşturulabilir, mevcut sayfalara içerik eklenebilir ve Notion verileri doğal dilde sorgulanabilir.

Internal Integration Oluşturma​

1. Notion Integration yönetim ekranını açın.
2. Yeni bir Internal Integration oluşturun.
3. Integration'a açıklayıcı bir ad verin.
4. Kullanılacak workspace'i seçin.
5. Integration'ı oluşturun.
6. Oluşturulan Internal Integration Token değerini kopyalayın.

Sayfa ve Database Erişimi​

Token oluşturmak tek başına yeterli değildir.

Integration'ın erişmesini istediğiniz sayfa ve database'ler ilgili integration ile paylaşılmalıdır.

Paylaşılmayan kaynaklar SkyStudio tarafından görüntülenemez.

SkyStudio'ya Bağlantı Ekleme​

1. Uygulama Bağlantıları bölümüne gidin.
2. Yeni Notion bağlantısı oluşturun.
3. Internal Integration Token değerini girin.
4. Bağlantıyı kaydedin.
5. Notion düğümündeki Uygulama Bağlantıları alanından bağlantıyı seçin.

Kullanım Alanları​

Notion düğümü:

• Sayfaları listeleme
• Sayfa bilgilerini alma
• Sayfa içeriğini okuma
• Database'leri listeleme
• Yeni sayfa oluşturma
• Sayfaya içerik ekleme
• AI destekli Notion sorguları

için kullanılabilir.

Kullanım Notları​

Sayfa oluşturma işleminde parent türü database seçilirse içerik database içerisinde bir kayıt olarak oluşturulur.

Parent türü page seçilirse mevcut sayfanın altında alt sayfa oluşturulur.

---

5.11. HubSpot​

HubSpot düğümü, SkyStudio iş akışlarının HubSpot CRM verileriyle çalışmasını sağlar.

Kişi, şirket ve deal kayıtları sorgulanabilir ve CRM verileri iş akışlarında kullanılabilir.

Private App Oluşturma​

1. HubSpot hesabınıza giriş yapın.
2. Settings bölümüne gidin.
3. Integrations → Private Apps bölümünü açın.
4. Yeni bir Private App oluşturun.
5. Uygulamaya açıklayıcı bir ad verin.
6. Kullanılacak CRM verileri için gerekli scope'ları ekleyin.
7. Uygulamayı oluşturun.
8. Oluşturulan Access Token değerini kopyalayın.

Örneğin kişi, deal ve şirket okumak için ilgili CRM read scope'larının tanımlanması gerekir.

SkyStudio'ya Bağlantı Ekleme​

1. SkyStudio Uygulama Bağlantıları bölümünü açın.
2. Yeni Bağlantı oluşturun.
3. Sağlayıcı olarak HubSpot seçin.
4. Bağlantıya açıklayıcı bir ad verin.
5. Private App Access Token değerini ekleyin.
6. Bağlantıyı kaydedin.

Farklı HubSpot portalları için ayrı bağlantılar oluşturulabilir.

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

HubSpot düğümünü çalışma alanına ekledikten sonra sağ paneldeki Uygulama Bağlantıları alanından bağlantıyı seçin.

Kullanım Alanları​

HubSpot düğümü özellikle:

• Contact kayıtları
• Company kayıtları
• Deal kayıtları
• CRM filtreleri
• AI destekli CRM sorguları

için kullanılabilir.

Kullanım Notları​

İhtiyaç duyulan property alanlarının açıkça belirtilmesi önerilir.

Çok büyük CRM veri setlerinde otomatik sayfalama işlem süresini artırabilir. Gerektiğinde Limit kullanılmalıdır.

Private App Token değişirse SkyStudio bağlantısı da güncellenmelidir.

---

5.12. Fireflies​

Fireflies düğümü, SkyStudio iş akışlarının Fireflies.ai toplantı kayıt ve transkript platformuyla çalışmasını sağlar.

Toplantı transkriptlerine, özetlere ve aksiyon maddelerine erişilebilir; transkriptlerde arama yapılabilir ve desteklenen durumlarda ses dosyaları işlenebilir.

API Key Alma​

1. Fireflies hesabınıza giriş yapın.
2. Hesap veya entegrasyon ayarlarından API bölümüne gidin.
3. Fireflies API Key oluşturun veya mevcut API Key'i görüntüleyin.
4. API Key'i kopyalayın.

SkyStudio'ya Bağlantı Ekleme​

1. Uygulama Bağlantıları bölümünü açın.
2. Yeni Bağlantı oluşturun.
3. Sağlayıcı olarak Fireflies seçin.
4. API Key'i ilgili alana ekleyin.
5. Bağlantıyı kaydedin.

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

Fireflies düğümünü çalışma alanına ekledikten sonra Uygulama Bağlantıları alanından oluşturduğunuz Fireflies bağlantısını seçin.

Kullanım Alanları​

Fireflies düğümü:

• Toplantıları listeleme
• Transkriptleri okuma
• Toplantı özetlerini alma
• Aksiyon maddelerini alma
• Transkriptlerde arama
• Toplantı kayıtlarını işleme

gibi senaryolarda kullanılabilir.

Kullanım Notları​

Fireflies planına bağlı olarak API erişimi sınırlı olabilir.

API Key değiştirilirse SkyStudio bağlantısındaki anahtar da güncellenmelidir.

---

5.13. GitHub​

GitHub düğümü, SkyStudio iş akışlarının GitHub repository'leriyle çalışmasını sağlar.

Repository, issue, pull request, commit, branch, dosya, GitHub Actions ve release işlemleri iş akışlarına dahil edilebilir.

Personal Access Token Oluşturma​

GitHub bağlantısı için Personal Access Token kullanılır.

1. GitHub hesabınıza giriş yapın.
2. Profil menüsünden Settings bölümüne gidin.
3. Developer Settings bölümünü açın.
4. Personal Access Token bölümüne gidin.
5. Yeni token oluşturun.
6. Kullanılacak repository ve operasyonlara uygun izinleri tanımlayın.
7. Token'ı oluşturun.
8. Oluşturulan token'ı hemen kopyalayın.

OAuth veya App Registration gerekmez.

SkyStudio'ya Bağlantı Ekleme​

Bağlantıda temel olarak:

• Personal Access Token
• Default Owner

bilgileri kullanılır.

Farklı organizasyonlar için ayrı bağlantılar oluşturabilirsiniz.

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

GitHub düğümünü çalışma alanına ekledikten sonra sağ paneldeki Uygulama Bağlantıları alanından bağlantıyı seçin.

Operasyonlar​

Kaynak dokümana göre GitHub 15 operasyon sunar:

• Repository Listele
• Issue Listele
• Pull Request Listele
• Workflow Tetikle
• GitHub AI Asistan
• Repository Detayı
• Issue Oluştur
• Issue Güncelle
• Yorum Ekle
• Commit Listele
• Branch Listele
• Dosya İçeriği Getir
• Dosya Oluştur / Güncelle
• Release Listele
• Release Oluştur

Kullanım Notları​

Default Owner, operasyon içerisinde Owner belirtilmediğinde varsayılan değer olarak kullanılabilir.

Labels ve Assignees gibi CSV alanlarına değerler virgülle ayrılarak girilebilir.

Örneğin:

bug,wontfix

GitHub token'ı yenilenirse SkyStudio bağlantısı da güncellenmelidir.

---

5.14. Cursor​

Cursor düğümü, SkyStudio iş akışlarının Cursor AI kod editörü platformuyla çalışmasını sağlar.

Cursor ekip üyeleri, kullanım verileri, harcama bilgileri ve analitik verileri iş akışlarında kullanılabilir.

API Key Alma​

1. Cursor uygulamasını veya hesap yönetim ekranını açın.
2. API Key bölümüne gidin.
3. Yeni bir API Key oluşturun.
4. Anahtarı kopyalayın.

SkyStudio'ya Bağlantı Ekleme​

1. Uygulama Bağlantıları bölümünü açın.
2. Yeni Bağlantı oluşturun.
3. Sağlayıcı olarak Cursor seçin.
4. API Key'i ekleyin.
5. Bağlantıyı kaydedin.

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

Cursor düğümünü çalışma alanına ekledikten sonra Uygulama Bağlantıları alanından oluşturduğunuz bağlantıyı seçin.

Kullanım Alanları​

Cursor düğümü:

• Ekip üyelerini listeleme
• Kullanım verilerini görüntüleme
• Harcama bilgilerini sorgulama
• Analitik raporlar alma
• Cursor AI Asistan üzerinden doğal dil sorguları gerçekleştirme

için kullanılabilir.

Kullanım Notları​

Kullanım veya harcama sorgularında tarih aralığı belirtilmezse büyük miktarda geçmiş veri dönebilir.

Büyük ekiplerde sayfalama ve tarih filtreleri kullanılması önerilir.

API Key yenilenirse SkyStudio bağlantısının da güncellenmesi gerekir.

---

5.15. Artifact​

Artifact düğümü, SkyStudio iş akışlarında görsel ve interaktif çıktı üretmek için kullanılır.

İş akışındaki veriler ve verilen talimatlar kullanılarak HTML sayfaları, grafikler ve benzeri görsel çıktılar oluşturulabilir.

Bağlantı Kurulumu​

Artifact düğümü harici bir uygulama bağlantısı gerektirmez.

Düğüm doğrudan çalışma alanına eklenerek kullanılabilir.

Operasyonlar​

Artifact düğümü dört operasyon sunar.

Öne çıkan operasyonlar arasında:

• Generate HTML Page
• Generate Chart

bulunur.

Generate HTML Page, verilen prompt ve veriyi kullanarak AI destekli HTML sayfası oluşturur.

Generate Chart, verilen veri ve talimata göre grafik üretir.

Kullanım​

Önceki düğümlerin çıktıları Artifact düğümüne parametre olarak bağlanabilir.

Örneğin veri analizi sonucunda oluşturulan bir veri seti Artifact düğümü üzerinden kullanıcıya görsel bir rapor olarak sunulabilir.

Kullanım Notları​

Artifact operasyonlarının çıktıları SkyStudio'nun Artifact görüntüleme bileşeninde render edilir ve kullanıcıya interaktif olarak sunulur.

---

5.16. Form Builder​

Form Builder düğümü, SkyStudio iş akışlarında kullanıcıdan yapılandırılmış veri toplamak için interaktif formlar oluşturur.

Belirlenen koşul karşılandığında form kullanıcıya gösterilir. Kullanıcı formu tamamladıktan sonra yanıtlar iş akışının sonraki adımlarında kullanılabilir.

Bağlantı Kurulumu​

Form Builder harici servis bağlantısı gerektirmez.

Düğüm doğrudan iş akışına eklenir ve tüm yapılandırma sağ panel üzerinden gerçekleştirilir.

Form Yapılandırması​

Form Builder tek bir temel işlem gerçekleştirir:

Form gösterme ve kullanıcı girdisi toplama

Form içerisinde farklı alan türleri kullanılabilir:

• Metin
• Uzun metin
• Sayı
• Tarih
• Seçim
• Onay kutusu

Yeni alan eklemek için + Alan Ekle seçeneği kullanılır.

Alanlar gerektiğinde sürükle-bırak yöntemiyle yeniden sıralanabilir.

Form Gösterme Koşulu​

Formun kullanıcıya hangi durumda gösterileceği doğal dilde tanımlanabilir.

Sistem bu açıklamayı değerlendirerek uygun koşul oluştuğunda formu tetikleyebilir.

Form Yanıtlarını Kullanma​

Kullanıcının doldurduğu alanların değerleri Form Builder düğümünün çıktısından alınarak sonraki düğümlerde kullanılabilir.

Bu veriler:

• If-Else koşullarına
• LLM düğümlerine
• Jira veya CRM düğümlerine
• Mesajlaşma düğümlerine
• Veri işleme adımlarına

aktarılabilir.

Kullanım Notları​

Her Form Builder için benzersiz bir Form ID tanımlanmalıdır.

Aynı iş akışında birden fazla Form Builder kullanılabilir ancak Form ID değerleri birbirinden farklı olmalıdır.

Form alanlarının çıktı sırası, form içerisinde tanımlanan alan sırasını takip eder. Alanların sırası değiştirildiğinde sonraki düğümlerde kullanılan index referanslarının da kontrol edilmesi gerekir.

Çok uzun formların kullanıcı deneyimini zorlaştırmaması için büyük formların birden fazla adıma bölünmesi önerilir.