LinkedIn
Instagram
WhatsApp
Telgraf
Google Takvim
Slack Topluluğuna Katılınİnşa etmek Çoklu sağlayıcılı e-posta API'si Gmail, Outlook ve IMAP ile çalışan entegrasyon, geliştirme ekipleri için en çok zaman alan zorluklardan biridir. Her sağlayıcı kendi OAuth akışını, hız sınırlarını ve veri modelini sunar. birleşik e-posta API'si tek bir REST arayüzünde tüm bunları soyutlar - yani tek bir entegrasyon yazarsınız ve kullanıcılarınızın güvendiği her büyük gelen kutusu için kapsama alanı elde edersiniz.
Neler öğreneceksiniz
E-posta API'si Kılavuzu
Gmail, Outlook ve IMAP'in tek bir birleşik REST API altında nasıl birlikte çalıştığını öğrenin.
Geliştiricilerin Neden Çok Sağlayıcılı E-posta API'sine İhtiyacı Var
Çoğu SaaS ürünü, son kullanıcıları adına e-posta okumak veya göndermek zorunda kalır. Sorun konsept değil, uygulamadır. Gmail, Google OAuth 2.0 ile Gmail API'sini kullanır. Outlook, kendi belirteç yaşam döngüsüyle Microsoft Graph'ı kullanır. IMAP tabanlı sağlayıcılar her biri biraz farklı davranır. Üç ayrı entegrasyon oluşturup sürdürmek, temel ürününüze harcanması gereken mühendislik döngülerini tüketir. Özellikle IMAP hesaplarıyla uğraşıyorsanız, IMAP API kılavuzu ek karmaşıklığı ele almaktadır. A birleşik e-posta API'si tüm sağlayıcıya özgü karmaşıklığı tek bir arayüzün ardında toplayarak çözmek - bu temel vaadidir Çoklu sağlayıcılı e-posta API'si teknik bir başvuruda bulunmak için tam teknik referansa e-posta gönderme API'si Gmail, Outlook ve IMAP üzerinden arama yapmayı, bunun için özel rehberimize bakın.
Bu 3 e-posta sağlayıcısı kapalı
Tek bir birleşik API, Gmail, Outlook ve IMAP'i aynı arayüze uyarlar. Bir kullanıcı farklı bir sağlayıcı bağladığında kodunuz asla değişmez.
Herhangi bir Gmail veya Google Workspace hesabını Google OAuth 2.0 aracılığıyla bağlayın. Uygulamanızda doğrudan Gmail API kimlik bilgisine gerek kalmadan Unipile katmanı üzerinden gerçek zamanlı olarak iş parçacıkları gönderin, okuyun, arayın ve senkronize edin.
Tek bir sağlayıcı kimliği altında kişisel Outlook hesaplarını, Microsoft 365'i ve Exchange Online'ı destekler. Microsoft OAuth, Unipile tarafından yönetilir - entegrasyonunuz kiracı yapılandırmaları boyunca kararlı kalır.
Yahoo, Fastmail, ProtonMail Bridge, özel kurumsal sunucular gibi IMAP üzerinden erişilebilen herhangi bir posta kutusu, Gmail ve Outlook için kullanılan API yüzeyi aracılığıyla anında erişilebilir hale gelir.
Unipil vs kendin inşa etmek
DIY'nin aslında maliyeti nedir Çoklu sağlayıcılı e-posta API'si entegrasyon? En iyi olduğumuz alanlarda dürüst karşılaştırma. İşte bu yüzden ekipler giderek daha fazla şunları tercih ediyor: birleşik e-posta API'si Her sağlayıcı entegrasyonunu sıfırdan inşa etmek yerine Unipile gibi.
Nasıl bütünleşme çalışıyor
Unipile ile ilk e-posta hesabınızı bağlamak dört adım sürer. Gmail, Outlook veya kullanıcının sahip olduğu fark etmeksizin aynı akış çalışır. IMAP hesabı - uygulama kodunuz baştan sona aynı kalır. Birleşik bir e-posta API'sinin pratik gücü budur: bir kez yazın, üç sağlayıcıyı da kapsayın.
Arka ucu, kısa ömürlü barındırılan bir kimlik doğrulama URL'si oluşturmak için Unipile API'sini çağırır. Kullanıcıyı bu URL'ye yönlendirin - Unipile sağlayıcı seçim ekranını sunar ve sizin adınıza tam OAuth akışını yönetir.
// POST /api/v1/hosted/hesaplar/bagla const rez = bekliyor fetch('https://api5.unipile.com:13515/api/v1/hosted/accounts/link', , method: 'POST', başlıklar: { 'X-API-ANAHTARI'process.env.UNIPILE_API_KEY, 'Content-Type': 'application/json' }, gövde: JSON.stringify({ tip: 'E-POSTA', sağlayıcılar_filtresi: ['Google', 'MİCROSOFT', 'IMAP'], başarı_yönlendirme_url: 'https://sizinyapiniz.com/auth/basari' }) }); const { url } = bekliyor res.json(); // kullanıcıyı `url`'ye yönlendir
Kullanıcı OAuth'u tamamladıktan sonra Unipile, uç noktanıza (veya yönlendirme URL'nize hesap kimliğini ekler) bir webhook ateşler. Bu hesap kimliğini saklayın - bu, sağlayıcıdan bağımsız olarak bağlantılı hesaba kalıcı referansınızdır.
{
"olay": "hesap.bağlandı",
"hesap_kimliği": "acc_01HXYZ...",
"sağlayıcı": "GOOGLE",
"e-posta": "alice@gmail.com"
}
Hesap kimliğini e-postaları listelemek, aramak ve almak için kullanın. Bu, birleşik e-posta API'si İşlemde: Hesap Gmail, Outlook veya IMAP olsa da yanıt şeması aynıdır - ayrıştırma mantığınız sağlayıcıya göre hiçbir zaman dallanmaz.
// GET /api/v1/emails?account_id=acc_01HXYZ... const emails = bekliyor fetch( `https://api5.unipile.com:13515/api/v1/ emails?account_id=${accountId}&limit=20`, { başlıklar: { 'X-API-ANAHTARI'process.env.UNIPILE_API_KEY } } ).sonra(r => r.json()); // Gmail, Outlook, IMAP için aynı yanıt şekli: // { kimlik, konu, kimden, kime, tarih, gövde, ekler }
Tek bir POST uç noktası, hesaptaki sağlayıcıya bakılmaksızın e-posta gönderir - bu, ... tam gücüdür Çoklu sağlayıcılı e-posta API'si. Hesap kimliğini, alıcıyı, konuyu ve gövdeyi geçirin - Unipile, uygun olduğu şekilde Gmail API, Microsoft Graph veya SMTP üzerinden yönlendirir. Bu, birleşik e-posta API'si en somut haliyle: bir uç nokta, üç sağlayıcı, kodunuzda sıfır dallanma.
// POST /api/v1/emails/gönder bekliyor fetch('https://api5.unipile.com:13515/api/v1/emails/send', , method: 'POST', başlıklar: { 'X-API-ANAHTARI'process.env.UNIPILE_API_KEY, 'Content-Type': 'application/json' }, gövde: JSON.stringify({ account_id: 'acc_01HXYZ...', için: [{ e-posta: 'bob@example.com' }], konu: 'Unipile'dan merhaba', vücut: 'Gmail, Outlook ve IMAP genelinde çalışır.
' }) });
Nasıl sağlayıcı soyutlaması çalışıyor
Tek birleştirilmiş e-posta API'si, uygulamanız ile üç temel sağlayıcı protokol arasına oturur - farklı OAuth akışlarını, veri şemalarını ve hız sınırlama modellerini tek bir tutarlı arayüze çevirir.
Gmail, belirli bir jeton yenileme döngüsüyle Google OAuth 2.0 kullanır ve e-postaları etiketlerle birlikte konu merkezli bir modelde döndürür. Outlook, farklı bir OAuth kiracı modeliyle Microsoft Graph kullanır ve e-postaları klasörlerle birlikte bireysel mesaj nesneleri olarak döndürür. IMAP sunucularının her birinin kendi bağlantı parametreleri, kimlik doğrulama yöntemleri ve yetenek kümeleri vardır.
Unipile'ın birleşik e-posta API'si hepsini tek bir REST arayüzünde normalleştirir. Kodunuz çağırır /api/v1/emails ve altta yatan hesap Gmail, Outlook veya IMAP hesabı olsun veya olmasın, aynı şekilde biçimlendirilmiş yanıt nesneleri alır. Aynı şey gönderme, ek işleme, webhook olayları ve hesap yaşam döngüsü yönetimi için de geçerlidir.
Bu, temel mühendislik faydasıdır Çoklu sağlayıcılı e-posta API'si model: karmaşıklık, uygulama kodunuzda değil, altyapı katmanında emilir. Google OAuth kapsam gereksinimlerini değiştirdiğinde veya Microsoft Graph API dijitalleştirme güncellemeleri yaptığında, Unipile yukarı akış değişikliğini ele alır - entegrasyonunuz bozulmadan kalır.
Güvenlik ve uygunluk
Uygulamanız kullanıcılar adına e-posta işlerken güvenlik isteğe bağlı değildir. Birleşik e-posta API katmanı kimlik bilgilerini, verileri ve uyumluluk yükümlülüklerini şu şekilde yönetir.
Unipile, OAuth belirteçlerini sizin adınıza depolar ve yeniler. Uygulamanız asla ham kimlik bilgileriyle çalışmaz; yalnızca opak hesap kimlikleriyle çalışırsınız. Belirteç rotasyonu, sona erme algılama ve yeniden kimlik doğrulama akışları tamamen altyapı katmanında yönetilir.
Tüm veriler aktarım halindeyken TLS 1.3 kullanır. Saklanan kimlik bilgileri, bekleyen verilerde AES-256 ile şifrelenir. Birleştirilmiş e-posta API'si aracılığıyla alınan e-posta içerikleri bellekte işlenir ve entegrasyonunuzun açıkça talep ettiği durumlar dışında kalıcı hale getirilmez.
Unipile, SOC 2 Tip II sertifikasına sahiptir (Ekim 2025). Bağımsız denetçiler, platformun güvenliğini, kullanılabilirliğini ve gizliliğini doğrulamıştır. Denetim raporları, üretim kullanımı için çok sağlayıcılı e-posta API'sini değerlendiren kurumsal müşteriler için talep üzerine mevcuttur.
Tüm planlar için veri işleme sözleşmeleri mevcuttur. Veri yerelleştirme gereksinimleri olan müşterilere AB veri barındırma seçeneği sunulmaktadır. API aracılığıyla silme hakkı desteklenmektedir: bağlantılı bir hesabı silmek, ilişkili tüm belirteçleri ve önbelleğe alınmış verileri kaldırır.
Google Cloud Uygulama Güvenliği Değerlendirmesi. Gmail OAuth kapsamları dahil olmak üzere Google kullanıcı verilerine erişen uygulamalar için güvenlik denetimlerini doğrular. Unipile üzerinde geliştirilen uygulamalar bu sertifikayı devralır.
Kesintisiz çalışma ve olay geçmişi, status.unipile.com adresinde kamuya açık olarak mevcuttur. Tüm API değişiklikleri, kullanım dışı bırakma bildirimlerini içeren bir sürüm politikası izler. Sessiz hata düzeltmeleri yoktur: entegrasyonunuz kararlı, belgelenmiş bir sözleşme ile korunmaktadır.
Elleçleme kenar durumlar sağlayıcılar arasında
Her üretim e-postası entegrasyonu sağlayıcıya özel uç durumlarla karşılaşır. İşler karmaşıklaştığında, kendi yaptığın yaklaşımın birleşik bir e-posta API'si kullanmaya kıyasla nasıl olduğunu burada bulabilirsin.
| Senaryo | Kendi Yap Kendin Yaklaşımı | UniPile yaklaşımı |
|---|---|---|
| Gmail hız sınırı günlük 250 kota birimi ücretsiz katman |
Hesap başına manuel kota takibi; izlenmezse istekler sessizce başarısız olur | Otomatik olarak halledildi Sıralama yerleşik, uygulamanıza hiçbir başarısız istek yansımadı |
| OAuth belirteç süresi doluyor | Her sağlayıcı için ayrı yenileme mantığı uygulayın; Google ve Microsoft arasında belirteç döndürme farklılık gösterir | Otomatik yenileme Tüm sağlayıcılarda sıfır kesinti süresiyle belirteç yönetimi |
| IMAP bağlantısı kesiliyor | Sunucu yapılandırmasına göre özel yeniden bağlanma mantığı; zaman aşımları farklı IMAP uygulamalarında değişiklik gösterir | Bağlantı havuzu yönetiliyor Unipile altyapısı tarafından sürdürülen kalıcı bağlantılar |
| Ek boyutu sınırları Gmail 25MB, Outlook 150MB, IMAP değişir |
Sağlayıcı başına dallanma kodu; her sağlayıcının limitini takip etmeli ve değiştiğinde güncellemelidir | Birleşik doğrulama Sağlayıcıdan bağımsız boyut doğrulama; hataların tutarlı bir şemada döndürülmesi |
| Sağlayıcı API değişiklikleri | Görev nöbeti sorumluluğunuz; Google ve Microsoft sınırlı bildirimle bozucu değişiklikler getiriyor | Unipile ekibi tarafından halledildi Altyapı düzeyinde yukarı akış değişiklikleri emildi; entegrasyonunuz stabil kalır |
Gmail hız sınırı
günlük 250 kota birimi ücretsiz katmanHesap başına manuel kota takibi; izlenmezse istekler sessizce başarısız olur
Sütun kılavuzu, her bir uç noktayı kapsar birleşik e-posta API'si derinlemesine - kimlik doğrulama akışları, ek yönetimi, klasör eşitleme, arama filtreleri ve webhook kurulumu. Üretim düzeyinde bir e-posta entegrasyonu oluşturmak için ihtiyacınız olan her şey.
Yaygın kullanım örnekleri
A birleşik e-posta API'si geniş bir ürün kategorisi yelpazesi için temel altyapıdır. Bir Çoklu sağlayıcılı e-posta API'si, ekipler Unipile ile en sık kullanılan kalıpları daha hızlı özellikler gönderir ve daha fazla kullanıcıya hizmet verirler - hangi gelen kutusu sağlayıcısını kullandıklarına bakılmaksızın.
Tüm müşteri e-postalarını CRM kayıtlarınıza otomatik olarak çekin. Satış temsilcileri, sekmeleri değiştirmeden veya manuel olarak iletmeden tüm konuşma geçmişini görür.
Kullanıcılarınızın gerçek gelen kutularından kişiselleştirilmiş takip dizileri gönderin - paylaşılan bir gönderim alanı değil - eşzamanlı olarak Gmail ve Outlook hesapları üzerinden.
İşe alım uzmanları iş e-postalarını bağlar ve ATS'niz her aday konuşmasını otomatik olarak günlüğe kaydeder. Gerçek Outlook veya Gmail hesapları üzerinden yönlendirilen, doğrudan ATS arayüzünden yanıt verin.
Birden çok ekip hesabından gelen e-postaları birleştiren bir paylaşımlı gelen kutusu veya destek masası oluşturun. Tek bir API ile desteklenen tek bir arayüz aracılığıyla rota, ata ve yanıtla.
E-posta zincirlerini bir LLM'ye besleyerek taslak yanıtlar, özetler veya eylem öğeleri oluşturun. Unipile normalleştirilmiş zincir verilerini sağlar; yapay zeka katmanınız ise akıl yürütmeyi yapar.
Herhangi bir sağlayıcıdan gelen yeni e-postalardan kodsuz iş akışlarını tetikleyin. Her gelen ileti için bir webhook tetiklenir - otomasyon platformunuz yoklamaya gerek kalmadan geri kalanını halleder.
Bu kalıpların her biri Gmail, Outlook ve IMAP'te çalışır uygulamanızda sağlayıcıya özgü hiçbir kod olmadan. Unipile, farklılıkları normalleştirerek ürün mantığınızı temiz tutar ve kullanıcılarınız tercih ettikleri gelen kutusunu bağlayabilir. Her uç nokta için eksiksiz bir kılavuz için şuraya başvurun Birleşik e-posta API kılavuzu.
Sıkça Sorulan sorular
Bir geliştiricinin çok sağlayıcılı bir e-posta API'si entegre etmeden önce sorduğu her şey.
id, konu, itibaren, için, Tarihve vücut sağlayıcıdan bağımsız olarak aynı yapıya sahiptir. Ayrıştırma mantığınızın, veritabanı modellerinizin ve sonraki işlemelerinizin sağlayıcı türüne göre dallanması gerekmez.
Gmail, Outlook ve IMAP hesaplarını tek bir API üzerinden bağlayın. OAuth karmaşası, şema eşleştirmesi veya bakım gerektiren sorgulama altyapısı yok. Kredi kartı gerekmeden 7 günlük ücretsiz deneme süresiyle başlayın.
TR 
EN 
FR 
ES 
DE 
IT 
BR 
NL 
PL