Bağlan ve Eşitle Outlook 365 API aracılığıyla posta kutuları
Uygulamanıza Outlook E-posta API'sini kullanarak güçlü e-posta özellikleri ekleyin. OAuth akışlarını kendiniz yönetmeden, Microsoft Graph tarafından desteklenen tek bir REST arayüzü üzerinden Outlook ve Microsoft 365 e-postalarını okuyun, gönderin, senkronize edin ve bunlara tepki verin.
const response = bekliyor fetch(
`https://${DSN}/api/v1/emails`,
{
headers: {
'X-API-ANAHTARI': apiAnahtar,
'hesap_kimliği'outlookHesapKimliği
}
}
);
const e-postalar = bekliyor cevap.json();
// emails.items, Outlook mesajları dizisi
// Outlook, Gmail ve IMAP için çalışırOutlook E-posta API'si nedir?
Bu Outlook E-posta API'si Geliştiricilere Outlook ve Microsoft 365 posta kutusu verilerine programlı erişim sağlayan RESTful bir arayüzdür. Üzerine kurulu Microsoft Graph, uygulamanızın Outlook veya Exchange Online hesaplarındaki e-postaları OAuth 2.0 kullanarak, güvenli ve kullanıcı tarafından yetkilendirilmiş kimlik doğrulama ile okumasını, göndermesini, düzenlemesini ve senkronize etmesini sağlar. Geliştiriciler, kullanıcı kimlik bilgilerinin ifşa edilmesine gerek kalmadan e-posta istemcileri, CRM senkronizasyon motorları, ATS araçları ve pazarlama otomasyonu oluşturmak için Outlook E-posta API'sini entegre eder.
Neden Outlook E-posta API'sini Uygulamanıza Entegre Etmelisiniz?
Uygulamanıza Outlook E-posta API'sini entegre etmek, kullanıcılarınıza sekmeler arasında geçiş yapmadan veya manuel olarak kopyalayıp yapıştırmadan, ürününüzün içinden doğrudan Microsoft 365 gelen kutularına erişim imkanı sunar. İşte ekiplerin en sık kullandığı dört temel yetenek.
Microsoft Outlook CRM Çözümünüz İçin API'si
Outlook konuşmalarını satış süreçlerine ve müşteri kayıtlarına senkronize edin
Aday Takip Sistemleri İçin Outlook E-postalarını Senkronize Et
İşe alım platformları ve İK yazılımları için Microsoft Graph API
Outreach Tools için Outlook API'sini senkronize et
Microsoft Graph ile çok kanallı satış etkileşim platformlarına güç verin
Outlook E-posta API'sini sosyal yazılımınıza entegre etmek, satış ekiplerine her müşteri adayı etkileşimi için tek bir doğru kaynağı sunar. Sohbetler senkronize kalır, takip e-postaları otomatik olarak gönderilir ve etkileşim verileri doğrudan panolarınıza aktarılır.
Outlook E-posta API'si için Microsoft OAuth Kurulumu
Microsoft OAuth BelgeleriVarsayılan olarak entegrasyonunuz Unipile'ın OAuth kimlik bilgilerini kullanır. Bir kimlik bilgisi almak için tamamen markasız deneyim Son kullanıcılar Outlook veya Microsoft 365 posta kutularını bağladığında, kendi uygulamanızı şuraya kaydedin: Microsoft Entra ID. Uyun Aşağıda 7 adım vardır kaydı oluşturmak, izinleri yapılandırmak ve Unipile çalışma alanınızdaki Outlook E-posta API'sine bağlamak için.
Microsoft Entra ID hesabı oluşturun
Eğer henüz yoksa, ücretsiz bir tane oluştur Microsoft Entra ID account (eski adıyla Azure Active Directory). Bu, Outlook E-posta API entegrasyonunuzu destekleyen OAuth uygulamasını kaydettiğiniz yönetici portalınızdır.
Azure portal'da yeni bir uygulama kaydedin
Giriş yapmak portal.azure.com, açık Microsoft Entra ID, ve tıkla Yeni kayıt.
- Uygulamanızın adını girin: Bu ad, son kullanıcılara gösterilen Microsoft OAuth onay penceresinde görünür.
- Desteklenen hesap türleri: İki iş Microsoft 365 ve kişisel Outlook posta kutusunu bağlayabilmek için "Herhangi bir kuruluş dizini (Herhangi bir Microsoft Entra Kimliği, Çok kiracılı) ve kişisel Microsoft hesaplarındaki hesapları" seçin.


Yönlendirme URI'leri ekle
Aç Kimlik Doğrulama panel ve tıkla URI ekle Web bölümünün altında. Ekle 2 yönlendirme URI'si Unipile DSN'inizi kullanarak (mevcut) Unipile Gösterge Tablosu, sağ üst köşe):
https://{{YOUR_DSN_less_port}}/api/v1/hosted/microsoft_auth_request_callback/port{{YOUR_PORT}}
Microsoft Graph izinlerini yapılandırın
Git API izinleri > İzin ekle > Microsoft Graph, sonra aşağıdakileri ekleyin Devredilmiş izinler Outlook E-posta API'si için:
Takvim özellikleri için ayrıca Calendars.ReadWrite, Calendars.Read, Calendars.Read.Shared ve Calendars.ReadWrite.Shared'ı ekleyin ve bunları Unipile Dashboard kapsam ayarlarınızda etkinleştirin.



Bir istemci gizli anahtarı oluştur
Açık Sertifikalar ve gizli bilgiler, tıklayın Yeni istemci gizli anahtarı. Gizleme açıklama ver ve son kullanma tarihi belirle 730 gün (24 ay), ardından "Ekle"ye tıklayın.



Uygulamanızı Unipile Panosu'na bağlayın
Aç Unipile Gösterge Tablosu ve ...'ya git Ayarlar > Microsoft OAuth.
- Yapıştır Uygulama (İstemci) Kimliği Azure Genel Bakış sayfasından.
- Yapıştır gizli değer Sertifikalar ve sırları sayfasından.
- Tıkla Kaydet.

Bağlantıyı test et
Unipile Kontrol Paneli'nden, özel OAuth kimlik bilgilerinizin uçtan uca çalıştığını doğrulamak için yeni bir Microsoft hesabı bağlantısı tetikleyin. Sizin Uygulama adı Microsoft onay istemindeki Unipile varsayılanları yerine marka yerleşimi.

8
Doğrulanmış yayıncı olun
Üretim için önerilir - onay ekranındaki "doğrulanmamış" uyarısını kaldırır
Yayıncı doğrulaması ile OAuth onay isteminde mavi bir onay işareti görünür. Doğrulaması olmadan, iş Microsoft 365 hesapları, kayıt dönüşümünü olumsuz etkileyen "doğrulanmamış yayıncı" uyarısı görebilir.
Adım 1: Microsoft İş Ortağı Ağı'na katılın
- Kaydol partner.microsoft.com ve seçin Microsoft Yapay Zeka Bulut İş Ortağı Programı.
- Bir iş hesabına ihtiyacınız varsa, Yeni bir kiracı oluştur ilk.
Adım 2: Alan adınızı doğrulayın
dosya oluştur microsoft-kimlik-ilişkilendirme.json ve şurada barındırın:
Adım 3: Partner Küresel Hesabınızın (PGA) kimliğini bağlayın
- PGA Kimliğinizi şuradan bulun: Ortak Merkezi.
- Azure portalında şuraya gidin Uygulama kayıtları > Uygulamanız > Markalama ve özellikler, PGA kimliğini girin ve kaydedin.
Tam ayrıntılar için, şuraya bakınız: Microsoft Publisher Doğrulama belgeleri.
9
Yönetici onayı gerekli"
Son kullanıcılar Microsoft 365 yöneticilerinden bir onay engeli gördüğünde
Bir son kullanıcı Outlook posta kutusunu bağlarken "Yönetici onayı gerekiyor" görüyorsa, kiracı düzeyinde gerekli onay verilmemiştir. Çözmek için iki yol:
Yöntem 1: Microsoft Entra içinde yönetici onay isteği
Bir Microsoft 365 yöneticisi bekleyen yönetici onay isteğini gözden geçirir ve onaylar. Yönetici onay isteklerini gözden geçirme hakkında Microsoft belgeleri.
Yöntem 2: Yönetici olarak ve kiracı genelinde onay ile OAuth oturumu açma
- Yönetici, uygulamanızdan OAuth oturum açma akışını başlatıyor.
- Microsoft yetkilendirmesi sırasında yönetici işaretlemelidir "Kuruluşunuz adına onay".
- Bu, kiracıdaki tüm kullanıcılar için onay verir ve gelecekteki herhangi bir Outlook E-posta API bağlantısı için istemi engeller.
tam ayrıntılar-da Microsoft rıza sorun giderme kılavuzu.
Outlook E-posta API Özellikleri ile Verimliliği Artırın
E-posta yönetimi, otomatik iş akışları ve gerçek zamanlı senkronizasyon sayesinde kullanıcılerınızın üretkenliğini Outlook E-posta API özelliklerinden faydalanarak artırın, böylece onlar en önemli konulara odaklanabilirler.
POSTA /api/v1/emails { "hesap_kimliği": "acc_outlook_...", "için": [{"tanımlayıcı": "lead@acme.com"}], "konu": "Hızlı giriş", "vücut": "Merhaba {{first_name}}..." }
// Yeni e-posta olayı uç noktanıza teslim edildi { "olay": "posta.alındı", "hesap_kimliği": "acc_outlook_...", "e_posta_kimliği": "em_8FdK2...", "dan": "sarah@acme.com", "zaman damgası": "2026-05-18T09:42:11Z" }
Outlook, Gmail ve IMAP'i Karşılaştırın
| Özellik |
|
|
|
|---|---|---|---|
| Hesap Bağlantısı | |||
| Hosted Auth | |||
| Özel Kimlik Doğrulama | |||
| OAuth | |||
| Kimlik Bilgileri | |||
| Gönder / Al | |||
| E-posta Gönder / Yanıtla | |||
| E-postaları Listele | |||
| E-posta Taslağı Oluştur | |||
| Organize Et | |||
| E-posta Sil | |||
| E-postayı Taşı | |||
| Klasörleri Listele | |||
| Klasör Al | |||
| Webhooks | |||
| Yeni E-posta | |||
| Açılma ve tıklama takibi | |||
Bugün Outlook E-posta API entegrasyonunuzu oluşturun
Ücretsiz deneme dahildir - kredi kartı gerekmez. İlk Outlook hesabınızı 5 dakikadan kısa sürede bağlayın.
Outlook E-posta API Kod Örnekleri: Node.js, Python ve cURL
Aşağıdaki örnekler, Unipile'ın birleştirilmiş Outlook E-posta API uç noktasına çağrı yapar. Tek bir API anahtarı, tek bir temel URL - kodunuzu değiştirmeden Outlook, Gmail ve IMAP için çalışır. Değiştirin SENİN_DSN ve SENIN_API_ANAHTARIN Unipile Pano'nuzdaki değerlerle.
// Unipile Outlook E-posta API'si aracılığıyla bağlı bir Outlook hesabından e-postaları oku
const axios = require('axios');
const DSN = 'api1.unipile.com:13211';
const API_ANAHTARI = 'SENİN_API_ANAHTARIN';
const ACC_ID = 'OUTLOOK_HESAP_KODU'; // OAuth'tan sonra POST /accounts'dan
async function Outlook E-postalarını Listele() {
const Res = bekliyor axios.olsun(
`https://\${DSN}/api/v1/emails`,
{
headers: {
'X-API-ANAHTARI'API_ANAHTARI,
'hesap_kimliği': ACC_ID
}
}
);
konsol.log(res.data.items); // Outlook mesajlarının dizisi
}
// Outlook E-posta API'si aracılığıyla e-posta gönderin
async function outlookEpostaGönder() {
bekliyor axios.POST(
`https://\${DSN}/api/v1/emails`,
{
account_idACC_ID,
için: [{ display_name: 'Alice', tanımlayıcı: 'alice@contoso.com' }],
konu: 'Outlook E-posta API'sinden Merhaba',
vücut: 'Unipile Outlook E-posta API'si aracılığıyla gönderildi.
'
},
{ başlıklar: { 'X-API-ANAHTARI'API_ANAHTARI } }
);
}# Unipile Outlook E-posta API'si aracılığıyla e-postaları okuyun ve gönderin
İthalat istekleri
DSN = "api1.unipile.com:13211"
API_ANAHTARI = "YOUR_API_KEY"
ACC_ID = "OUTLOOK_HESAP_KİMLİĞİ"
ÜST BILGILER = {
"X-API-ANAHTAR"API_ANAHTARI,
"hesap_kimliği"ACC_ID,
}
# Outlook e-postalarını listele
fonksiyon e-postaları_listele():
r = istemler.olsun(
https://{DSN}/api/v1/emails",
başlıklar=ÜST BILGILER
)
r.raisen_for_status()
return r.json()["eşyalar"]
# Outlook E-posta API'si aracılığıyla gönder
fonksiyon e-posta gönder(alıcı_adresi, konu, gövde):
r = istemler.POST(
https://{DSN}/api/v1/emails",
başlıklar={"X-API-ANAHTAR"API_ANAHTARI:,
json={
"hesap_kimliği"ACC_ID,
"için": [{"tanımlayıcı": hedef_adres},
"konu": konu,
"vücut"gövde
}
)
r.raisen_for_status()
return r.json()# Bağlı Outlook hesabındaki e-postaları listele
kıvrıl -s -X GET \
"https://api1.unipile.com:13211/api/v1/emails" \
-H "X-API-ANAHTARI: SENIN_API_ANAHTARIN" \
-H "hesap_kimliği: OUTLOOK_HESAP_KİMLİĞİ" \
| jq '.items[] | {id, subject, from, date}'
# Outlook E-posta API'si aracılığıyla e-posta gönder
kıvrıl -s -X POST \
"https://api1.unipile.com:13211/api/v1/emails" \
-H "X-API-ANAHTARI: SENIN_API_ANAHTARIN" \
-H "İçerik-Türü: uygulama/json" \
-d '{
"account_id": "OUTLOOK_HESAP_ID",
"kime": [{"tanımlayıcı": "alice@contoso.com"}],
"konu": "Outlook E-posta API'den Merhaba",
"gövde"Unipile üzerinden gönderildi.
"
}'Yerel Microsoft Graph'a Karşı Birleşik Outlook E-posta API'si (Unipile)
Microsoft Graph üzerine doğrudan inşa etmek yerine Unipile'ın akıcı Outlook E-posta API entegrasyonundan yararlanmanın açık avantajlarını keşfedin. Gelişmiş kimlik bilgileri yönetimiyle güvenliği artırmak, Outlook ve diğer e-posta platformlarıyla sorunsuz entegrasyonu sağlamak ve OAuth akışlarını sürdürmenin ek yükünü azaltmak için Barındırılan Kimlik Doğrulama'yı (Hosted Auth) kullanın.
| Boyut | Yerel Microsoft Graph API | Unipile Outlook E-posta API |
|---|---|---|
| Entegrasyon kapsamı | Yalnızca Outlook / Exchange Online | Outlook + Gmail + IMAP, aynı kod |
| OAuth akışı kurulumu | Azure Uygulama Kaydı + kiracı başına belirteç yönetimi | Bir barındırılan kimlik doğrulama bağlantısı, markasız OAuth sayfası, sıfır belirteç kodu |
| Belirteç yenileme | Kodunuz her 60 dakikada bir (erişim belirteci ömrü) yenilenmelidir. | Unipile, bağlı tüm hesaplar için yenilemeyi otomatik olarak halleder |
| Webhook yenileme | Abonelikler 4.230 dakika sonra sona eriyor, yenileme işlemini sona ermeden önce yapmalısınız | Unipile, Graph aboneliklerini otomatik olarak yeniler |
| Kısılma işlemi yönetimi | 429 hata kodu yeniden deneme mantığı ve üssel geri çekilme manuel olarak uygulanmalı | Dahili yeniden deneme ve hız sınırı yönetimi |
| İlk e-postaya kadar geçen süre | 2-5 gün (Azure kurulumu + OAuth + jeton mantığı + hata yönetimi) | 2 saatten az (bu kılavuzu izleyin) |
| Exchange Online sürümü kapatılıyor | EWS'den Ekim 2026 son tarihinden önce Graph'a geçilmelidir | Unipile zaten Graph kullanıyor, geçiş şeffaf |
| Destek | Microsoft belgeleri + forumlar | Canlı teknik destek + talep üzerine kurucu görüşmesi |
Tek Bağlantılı Barındırılan Kimlik Doğrulama vs Tam OAuth Akışı
Unipile'ın Barındırılan Kimlik Doğrulaması, e-posta sağlayıcılarının tespitini otomatikleştirir ve kimlik doğrulamasını yönetir. Bu, ilk kurulumun karmaşıklığını önemli ölçüde azaltarak geliştirme sürelerini hızlandırır ve bakımı düşürür. OAuth E-posta API kılavuzu
Tutarlı Güncellemeler ve Bakım
Düzenli güncellemeler ve titiz bakımla önde olun. Unipile Outlook E-posta API'si, Microsoft Graph değişikliklerini takip etmek ve en yüksek performansı sunmak için sürekli olarak geliştirilmektedir, böylece Microsoft API'sini güncellediğinde bile entegrasyonunuz çalışır. MS Graph entegrasyon kılavuzu
Destek ekibimiz, Outlook E-posta API entegrasyonunun her aşamasında, başlangıçtan uygulamadan sonraki desteğe kadar ek bir ücret talep etmeden size rehberlik eder. Geliştiriciler İçin E-posta API'si
Outlook E-posta API'si ile Geliştirirken Sık Yapılan Hatalar
Microsoft Outlook API'si güçlüdür ancak üretimde entegrasyonunuzu bozabilecek birkaç bariz olmayan kısıtlaması vardır. İşte en yaygın 6 tuzak ve bunlardan nasıl kaçınılır.
Outlook E-posta API Entegrasyonları için Güvenlik ve Uyumluluk
Gelişmiş güvenlik protokolleriyle verilerinizin güvenliğini sağlayın. Unipile Outlook E-posta API'si, e-postalarınızın ve hassas bilgilerinizin korunmasını garanti eder - SOC 2 Tip II sertifikası ve tam GDPR uyumluluğu ile.
Sıkça Sorulan Sorular
Unipile ile Outlook E-posta API, Microsoft Outlook API ve Outlook 365 API entegrasyonu hakkında en sık sorulan soruların yanıtları.
graph.microsoft.com/v1.0/benim/mesajlar, bir Azure AD OAuth 2.0 bearer belirteci ile kimliği doğrulanmış. Unipile bunu, Gmail ve IMAP için de çalışan basit, sağlayıcıdan bağımsız bir arayüze sarar.Mail.ReadWrite, Mail.Gönder ve Mail.Read yetkileri devredin, (3) erişim belirteci almak için yetkilendirme kodu akışını uygulayın. Unipile ile tüm bu adımları atlarsınız. Kullanıcılarınız için tek bağlantılı bir OAuth sayfası oluşturmak üzere Barındırılan Kimlik Doğrulamayı kullanın. Tamamını görün OAuth E-posta API kılavuzu ve Microsoft Graph OAuth kılavuzu.Siz de beğenebilirsiniz
Unipile API ile E-postaları Alma
E-postaları programlı olarak yönetmek ve almak kritik bir beceridir. İster iş otomasyonu, ister müşteri desteği veya pazarlama amaçları için olsun, e-postaları almak için bir E-posta API'sinin nasıl kullanılacağını anlamak işlemleri kolaylaştırabilir ve verimliliği artırabilir. Bu kılavuz size temel konularda yol gösterecek...
Yazılımınız için E-posta API'si Nasıl Alınır?
Birden fazla e-posta hizmetini uygulamanıza sorunsuz bir şekilde dahil etmede sayısız avantajın kilidini açmak için bir geçit sunduğundan, bir API'yi entegre etmenin avantajlarını keşfedin.E-posta API'si nedir? E-posta API'si (Uygulama Programlama Arayüzü), geliştiricilerin...
Google OAuth Doğrulaması ve Gmail API Kimlik Bilgileri (2026)
Gmail API Doğrulanmamış Uygulama Uyarısı Uygulamanız Google OAuth uygulama doğrulamasından geçmeden önce, yetkilendirmeye çalışan her kullanıcı bir uyarı ekranı görür. Google ayrıca doğrulanmamış harici uygulamalar için katı bir 100 kullanıcı sınırı uygular. İşte...


