Bu rehberde: Microsoft 365 (Exchange Online) veya Outlook.com posta kutunuzu tek tıkla bağlarsınız. Müşteri adaylarına giden her e-posta bu kutudan çıkar, Gönderilmiş Öğeler'de görünür; adayın yanıtı birkaç dakika içinde Gelen Kutusu'na ve adayın kaydına düşer.
⏱ 5 dakika (platformun Microsoft uygulaması kayıtlıysa)
Kimlik kartı
| Alan | Değer |
|---|---|
| Sağlayıcı anahtarı | OUTLOOK |
| Kategori | Mesajlaşma (müşteri adayı e-posta kutusu) |
| Kimlik doğrulama | Microsoft ile oturum açma (OAuth 2.0 + PKCE, Microsoft Graph) |
| Kapsam | Proje bazlı (bir bağlantı = bir posta kutusu) |
| Webhook | Hayır – gelen kutusu 2 dakikada bir okunur |
| Yetenekler | E-posta gönderme, yanıt / geri dönme / otomatik yanıt takibi |
| Kullanan kutular | E-posta gönder, Mesaj gönder (kanal: e-posta), Toplu mesaj, Kampanyalar |
| Kullanan ajanlar | İlk Temas Ajanı (send_email, takip e-postaları), Gelen Kutusu yanıtları |
Ne işe yarar?
- Gönderim: Ajanların ve iş akışlarının müşteri adaylarına yazdığı e-postalar sizin adresinizden (
Satış <satis@markaniz.com>) gider. Microsoft her e-postaya kendi Message-ID'sini verir; OrqLabs bu kimliği saklar. - Yazışma zinciri: Takip e-postaları ilk e-postanın konusunu (
Re: …) veIn-Reply-To/Referencesbaşlıklarını taşır; aday aynı zinciri görür. - Yanıt takibi: Gelen Kutusu'na düşen yeni postalar okunur ve adaya eşlenir (önce yanıtladığı e-postanın kimliğiyle, yoksa gönderen adresle). Eşleşen yanıt Gelen Kutusu'nda konuşma olarak açılır, aday Yanıtladı olur, planlı takipler durur.
- Otomatik ayıklama: Geri dönen e-postalar (bounce) adayı "e-posta geri döndü" olarak işaretler; "listeden çıkar / unsubscribe" yanıtı adayı abonelikten çıkarır; otomatik yanıtlar (izindeyim vb.) yalnızca etkinlik olarak kaydedilir.
- Yasal altbilgi: Her ticari e-postaya gönderici bilgileri ve tek tıkla abonelikten çıkma bağlantısı eklenir.
Adayla eşleşmeyen e-postalar hiç saklanmaz; OrqLabs postalarınızı silmez, taşımaz ve okundu olarak işaretlemez.
Ön koşullar
- Exchange Online posta kutusu olan bir Microsoft 365 hesabı (iş/okul) veya bir Outlook.com / Hotmail hesabı. Şirket içi (on-premises) Exchange posta kutuları Microsoft Graph ile çalışmaz.
- Kuruluşunuzda kullanıcı onayı kapalıysa Microsoft 365 yöneticinizin uygulamaya yönetici onayı vermesi.
- Gönderen alan adında SPF, DKIM ve DMARC kayıtları (Microsoft 365 alan adlarında DKIM'i Defender portalından açın).
Adım adım kurulum
A) OrqLabs'ta bağlama
- Entegrasyonlar → Outlook / Microsoft 365 → Bağla → ① Proje seçin.
- ② Bağla → Microsoft hesabınızı seçin → istenen izinleri onaylayın.
- Geri dönüşte kart Outlook / Microsoft 365 – satis@markaniz.com adıyla görünür.
- Bağlantıyı test et: posta kutusu adresi görünür.
- Kendinizi müşteri adayı olarak ekleyip E-posta gönder kutusuyla bir test e-postası gönderin, sonra bu e-postayı yanıtlayın: birkaç dakika içinde yanıt Gelen Kutusu'nda görünür.
Bir projede hem Outlook hem SMTP bağlıysa adaya giden e-postalar için kutuda hesabı seçebilirsiniz; seçilmezse projenin ilk bağlanan e-posta hesabı kullanılır.
B) Platform yöneticisi: Azure (Microsoft Entra ID) uygulama kaydı
Bu adımlar OrqLabs'ı işleten taraf tarafından bir kez yapılır.
- entra.microsoft.com → Applications → App registrations → New registration.
- Name:
OrqLabs. Supported account types: Accounts in any organizational directory (Any Microsoft Entra ID tenant – Multitenant) and personal Microsoft accounts. - Redirect URI → platform Web →
https://api.orqlabs.com/api/v1/integrations/oauth/outlook/callback→ Register. - Overview sayfasındaki Application (client) ID →
MICROSOFT_CLIENT_ID. - Certificates & secrets → Client secrets → New client secret → Value →
MICROSOFT_CLIENT_SECRET. Gizli anahtarın bitiş tarihini takvime yazın; süresi dolmadan yenisini oluşturup ortam değişkenini güncelleyin. - API permissions → Add a permission → Microsoft Graph → Delegated permissions:
offline_access,User.Read,Mail.Send,Mail.ReadWrite→ Add permissions. - Branding & properties: yayıncı alan adını (publisher domain) doğrulayın ve mümkünse Publisher verification yapın. Doğrulanmamış çok kiracılı uygulamalara birçok kuruluşta kullanıcılar onay veremez.
- API sunucusunu
MICROSOFT_CLIENT_IDveMICROSOFT_CLIENT_SECRETile yeniden başlatın; kart Bağla düğmesiyle açılır.
İzinler ve kapsamlar
| Kapsam | Neden gerekli |
|---|---|
offline_access | Yenileme anahtarı: oturum yeniden açılmadan e-posta göndermek ve gelen kutusunu okumak |
User.Read | Posta kutusu adresi ve adı (kartta görünen hesap) |
Mail.Send | E-postanın sizin adınıza gönderilmesi |
Mail.ReadWrite | Gönderilecek e-postanın taslak olarak hazırlanması (Message-ID için) ve gelen kutusundaki yeni postaların okunması |
Sınırlar
- Microsoft 365 posta kutusu başına günde 10.000 alıcı ve dakikada 30 e-posta sınırı uygular. OrqLabs ayrıca posta kutusu başına günlük 50 müşteri adayı e-postası sınırı koyar; aşan e-postalar ertesi güne ertelenir, kaybolmaz.
- İlk bağlantıda geçmiş gelen kutusu okunmaz; yalnızca bağlantıdan sonra gelen postalar işlenir.
- Gelen kutusu kuralı (rule) ile başka klasöre taşınan yanıtlar görülmez; yanıtların Gelen Kutusu'nda kalmasını sağlayın.
Sık karşılaşılan hatalar
| Hata | Olası neden | Çözüm |
|---|---|---|
AADSTS65001 / "Need admin approval" | Kuruluşta kullanıcı onayı kapalı | Microsoft 365 yöneticisi Enterprise applications → OrqLabs → Permissions → Grant admin consent ile onay vermeli |
CONFIG – MailboxNotEnabledForRESTAPI | Hesabın Exchange Online posta kutusu yok (lisans yok / şirket içi Exchange) | Exchange Online lisanslı bir hesapla bağlayın |
AUTH – invalid_grant | Parola değişti, oturum iptal edildi veya izin geri alındı | Kartta Yeniden yetkilendir |
RATE_LIMIT – ErrorExceededMessageLimit | Microsoft'un günlük gönderim sınırı aşıldı | Gönderim hacmini düşürün; ertesi gün otomatik devam eder |
| Yanıt Gelen Kutusu'na düşmüyor | Yanıt başka klasöre taşındı veya adayın adresi farklı | Gelen kutusu kurallarını kontrol edin; adayın e-posta adresini doğrulayın |