Outlook Mail Node

Outlook Node Dokümantasyonu

Outlook node'u, 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 node'unu 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 node'unu canvas'a ekleyin.
2. Node'a tıklayarak sağ paneli açın.
3. Operasyon seçin (Mail Gönder veya Mail Ara).
4. Sağ panelin alt kısmındaki 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ı Node'a Atama

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

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

---

Operasyonlar

Outlook node'u 2 operasyon sunmaktadır:

Operasyon	Açıklama
Mail Gönder	Outlook üzerinden yeni e-posta oluşturur ve gönderir
Mail Ara	Outlook gelen kutusunda gelişmiş arama ve filtreleme yapar

---

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

Parametre	Zorunlu	Açıklama
Connection	Evet	Kullanılacak Outlook bağlantısı
To	Evet	Alıcı e-posta adresi (birden fazla için virgülle ayırın)
Subject	Evet	E-postanın konu satırı
Body	Evet	E-postanın içeriği (düz metin veya HTML)
CC	Hayır	Kopyaya eklenecek e-posta adresleri
BCC	Hayır	Gizli kopyaya eklenecek e-posta adresleri

Kullanım Örneği

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

• To: yonetici@sirket.com
• Subject: Haftalık Satış Raporu - {{tarih}}
• 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

Parametre	Zorunlu	Açıklama
Connection	Evet	Kullanılacak Outlook bağlantısı
Search Query	Evet	Arama sorgusu (örn. fatura, from:ahmet@sirket.com)
Folder	Hayır	Aranacak klasör (örn. Inbox, Sent Items)
Limit	Hayır	Döndürülecek maksimum e-posta sayısı

Arama Sorgusu Örnekleri

Arama Örneği	Açıklama
fatura	Konusunda veya içeriğinde "fatura" geçen mailler
from:ahmet@sirket.com	Belirli bir göndericiden gelen mailler
subject:toplantı	Konusunda "toplantı" geçen mailler
hasAttachment:true	Eki olan mailler

Ö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..."
    }
  ]
}

---

Hızlı Başlangıç Örnekleri

Örnek 1: Otomatik Rapor E-postası

Her hafta pazartesi satış raporunu yöneticiye gönderen workflow:

Schedule (Her Pazartesi 08:00) → HubSpot (Fırsatları Getir) → LLM (özetle) → Mail Gönder

Mail Gönder ayarları:

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

---

Örnek 2: Fatura Takip Sistemi

Gelen kutusundaki fatura maillerini bulup Notion'a kaydeden workflow:

Schedule (Her gün) → Mail Ara → LLM (fatura bilgisini çıkar) → Sayfa Oluştur (Notion)

Mail Ara ayarları:

• Search Query: subject:fatura
• Folder: Inbox
• Limit: 10

---

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

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

Schedule (Her 30 dakika) → 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: {{mail.from}}
• Subject: Re: {{mail.subject}}
• Body: {{llm.output}}

---

Örnek 4: Form Sonuçlarını E-postayla İletme

Kullanıcının doldurduğu formu ilgili departmana e-posta olarak ileten workflow:

Form Builder → LLM (form özetle) → Mail Gönder

Mail Gönder ayarları:

• To: ik@sirket.com
• Subject: Yeni Başvuru: {{form.isim}}
• Body: {{llm.output}}

---

Sık Karşılaşılan Hatalar

Hata	Olası Neden	Çözüm
Microsoft Outlook Bağlantısı Gerekli	OAuth yetkilendirmesi yapılmamış	Node panelindeki Microsoft Outlook'a Bağlan butonuna tıklayın ve giriş yapın
401 Unauthorized	OAuth token'ı süresi dolmuş	Uygulama Bağlantıları sayfasından bağlantıyı yenileyip tekrar yetkilendirin
403 Forbidden	Hesabın gönderme izni yok	Microsoft 365 yöneticisinden gerekli izinlerin verildiğini kontrol edin
Mail gönderilemiyor	Alıcı adresi geçersiz	To alanındaki e-posta adresinin doğru formatta olduğunu kontrol edin
Boş arama sonucu	Arama sorgusu eşleşen mail bulamadı	Search Query değerini ve Folder seçimini kontrol edin

---

Notlar

• Outlook node'u Microsoft OAuth 2.0 ile yetkilendirilir; şifre veya API anahtarı gerekmez.
• OAuth token'ı belirli aralıklarla otomatik yenilenir. Uzun süre kullanılmayan bağlantılarda yeniden yetkilendirme gerekebilir.
• Mail Gönder operasyonunda Body alanına HTML içerik girilebilir; böylece biçimlendirilmiş e-postalar gönderilebilir.
• Mail Ara operasyonu yalnızca bağlı hesabın erişebildiği klasörleri tarar. Paylaşımlı posta kutularına erişim için Microsoft 365 yöneticisinden yetki gerekebilir.
• Kurumsal Microsoft 365 hesaplarında IT politikaları üçüncü taraf uygulama bağlantılarını kısıtlıyor olabilir; sorun yaşarsanız IT departmanınıza danışın.