LinkedIn
Instagram
WhatsApp
Telgraf
Google Takvim
Slack Topluluğuna KatılınSaaS Erişiminizi Verin Kullanıcı Gelen Kutuları E-posta API'si aracılığıyla
SaaS için bir e-posta API'si, ürününüzün kullanıcıların Gmail, Outlook veya IMAP hesaplarından doğrudan şifrelerine dokunmadan e-posta okumasını, göndermesini ve senkronize etmesini sağlar. Birleşik bir OAuth temeli üzerine CRM entegrasyonları, satış araçları, yardım masaları ve yapay zeka asistanları oluşturun.
İthalat { UnipileClient } itibaren 'unipile-node-sdk';
const müşteri = yeni UnipileClient('SENIN_DSN', 'SENIN_TOKENIN');
// Kullanıcının gelen kutusunu bağla
const bağlantı = bekliyor müşteri.hesap.create({
tip: 'google',
yönlendirme_url 'https://app.com/cb'
});
// Son 50 e-postayı getir
const { öğeler } = bekliyor client.email.TümüSorgula({
account_id: 'kullanıcı_hesabı_kimliği',
Limit: 50
});
// Kullanıcının adresinden gönder
bekliyor client.email.gönder({
account_id: 'kullanıcı_hesabı_kimliği',
kime: [{ tanımlayıcı: 'lead@co.com' }],
Konu: 'Takip',
body: 'Merhaba, kontrol ediyorum...'
});
E-posta API'si SaaS için nedir?
Çoğu geliştirici "e-posta API'si" dendiğinde, kendi alan adınızdan işlemsel e-postalar (makbuzlar, bildirimler, sihirli bağlantılar) göndermek için SendGrid veya Mailgun gibi hizmetleri düşünür. Bu tamamen farklı bir pazardır. SaaS için bir e-posta API'si, temelden farklı bir sorunu çözer: ürününüzün kullanıcılarınızın kendi e-posta hesaplarına programatik erişimini sağlamak.
Bir E-posta API'si Ürünlerinizin kullanıcıların e-posta sağlayıcılarıyla (Gmail, Outlook veya IMAP) OAuth aracılığıyla kimlik doğrulaması yapmasını, ardından parolaları saklamadan veya sağlayıcıya özgü tuhaflıkları yönetmeden, tek bir entegrasyon aracılığıyla kendi adlarına e-postaları okumasını, göndermesini, senkronize etmesini ve aramasını sağlayan bir dizi HTTP uç noktasıdır.
E-posta gönderir alanınızdan kullanıcılarınıza. Parola sıfırlamaları, faturalar, bildirimler ve pazarlama kampanyaları için kullanılır. Ürününüz gönderici adresi kontrol eder.
SaaS'ınıza erişim sağlar kullanıcılarınızın gelen kutuları OAuth aracılığıyla. Ürününüz, kullanıcıların Gmail, Outlook veya IMAP hesaplarından kendi adına e-posta okur, gönderir ve eşitler.
E-posta API'leri ile Neler SaaS Ürünü Olarak Geliştirilebilir?
E-postalara kullanıcıların işlem yapmasını gerektiren veya e-postaların veri modelinize akması gereken herhangi bir ürün, kullanıcı senkronizasyonlu bir e-posta API'si için adaydır. İşte Unipile ile geliştiricilerin en sık kullandığı beş yaygın senaryo.
Satış temsilcisi ile bir kişi arasında değiş tokuş edilen her e-postayı otomatik olarak yakalayın. Manuel kayıt yok, kaçırılan etkileşim noktası yok. CRM'niz kullanıcı eylemi gerektirmeden güncel kalır.
Her temsilcinin kendi Gmail veya Outlook adresinden, paylaşılan bir gönderim alanından değil, çok adımlı ulaşım dizileri yürütün. Yanıtlar temsilcinin gerçek gelen kutusuna gelir ve otomatik olarak algılanır.
Birden çok ekip gelen kutusundan destek e-postalarını birleştirilmiş bir bilet kuyruğuna çekin. Yardım masası arayüzünüzden gönderilen yanıtlar, aracının kendi bağlantılı hesabından gönderilir, bu da teslim edilebilirliği korur.
Yapay zeka ürününüze kullanıcının tüm e-posta geçmişine erişim izni verin. Kullanıcının gerçek gelen kutusu verilerinden yararlanarak ileti dizilerini özetleyin, yanıt taslakları oluşturun, yapılacakları çıkarın veya potansiyel müşterileri sınıflandırın.
Kullanıcıların gelen kutularını otomasyonları tetiklemek için bağlamasına izin verin - e-postalardan görevler oluşturun, fatura verilerini çıkarın, ekleri depolama alanına yönlendirin veya e-postayı Slack, Notion veya kendi iş akışı motorunuzla köprüleyin.
İşe alım uzmanlarının gelen kutularını ATS'nize bağlayın. Aday e-postalarını iş başvurularıyla otomatik olarak ilişkilendirin, yanıt oranlarını izleyin ve işe alım uzmanlarının platformunuzdan ayrılmadan bağlantılı hesaplarından doğrudan yanıt vermelerine olanak tanıyın.
SaaS için Üretim E-posta API'sinin Desteklemesi Gerekenler
Güvenilir bir e-posta entegrasyonu oluşturmak, yalnızca bir REST uç noktasına çağırmaktan daha fazlasıdır. Ciddi bir SaaS e-posta API entegrasyonunun kapsanması gereken altı yetenek ve her birinde gizlenen karmaşıklık işte burada.
Her kullanıcı, ayrı bir OAuth onayıyla kendi gelen kutusunu bağlar. SaaS'ınız görev yapar adına her kimlik doğrulanmış kullanıcı - tek bir paylaşılan hizmet hesabı aracılığıyla değil. Google ve Microsoft, OAuth tokenlerini büyük ölçekte verebilmeniz için uygulama doğrulaması gerektirir.
Kullanıcılarınızın Gmail, Outlook (kişisel ve Microsoft 365) ve IMAP tabanlı gelen kutuları olacak. SaaS için sağlam bir e-posta API'si bu üç sağlayıcıyı normalleştirerek tek birleşik yanıt biçimi ürün mantığınız sağlayıcıdan bağımsız kalır.
Birkaç dakikada bir yoklama yapmak kırılgandır ve yavaştır. Üretim SaaS gerektirir webhook bildirimleri Yeni e-postalar geldiğinde veya mesaj durumu değiştiğinde. Gmail Pub/Sub kullanır, Microsoft Graph abonelikleri kullanır - API katmanınız her ikisini de tek bir olay biçimine soyutlamalıdır.
E-posta istemcileri mesajları iş parçacıklarına göre gruplandırır. E-posta API'niz şunu sunmalıdır: tutarlı iş parçacığı tanımlayıcısı sağlayıcılar arasında, bu sayede yanıtları iş parçacığı içinde verebilir, konuşmaları daraltabilir ve ham Message-ID başlıklarını kendiniz ayrıştırmadan dışa dönük bir dizinin yanıt alıp almadığını tespit edebilirsiniz.
Ekleri okumak, MIME parçalarını çözmek, satır içi görüntüleri işlemek ve sağlayıcıya özgü API'ler aracılığıyla ikili veri bloklarını indirmek anlamına gelir. Uç nokta size izin vermelidir Kimliğe göre ekleri al her istekte tam mesaj gövdesini yeniden indirmeden.
E-posta verileri hassastır. Entegrasyonunuz gerektirir durgun haldeki belirteç şifrelemesi, kapsamlı OAuth izinleri (yalnızca ihtiyacınız olanı isteyin), denetim günlükleri ve GDPR silme hakkı taleplerini ve SOC 2 Tip II denetimlerini karşılamak için belgelenmiş bir veri silme yolu.
Kendi E-posta API Entegrasyonunuzu Oluşturmanın Gizli Maliyetleri
Gmail API, Microsoft Graph ve IMAP kütüphaneleri ücretsizdir ve iyi belgelenmiştir. Öyleyse neden çoğu SaaS ekibi inşa maliyetini 3-5 kat hafife alıyor? Çünkü karmaşıklık ilk entegrasyonda değildir - sonrasında gelen her şeydedir.
Temel profil dışındaki Gmail kapsamlarını isteyen uygulamalar geçmelidir Google'ın CASA Seviye 2 güvenlik değerlendirmesi 100'den fazla test kullanıcısına hizmet vermeye başlamadan önce. Bu süreçte bir üçüncü taraf güvenlik laboratuvarı devreye giriyor, 4-8 hafta sürüyor ve kapsamına bağlı olarak 14.000-17.500 TL'ye mal oluyor.
Microsoft gerektirir yayıncı doğrulaması Daha yüksek ayrıcalıklı Grafik API kapsamlarını isteyen uygulamalar için. Olmadan, her kullanıcı OAuth onay ekranı sırasında kırmızı bir uyarı bandı görür - B2B SaaS kayıt akışları için önemli bir dönüşüm engelleyicidir.
Vahşi doğada yüzlerce IMAP sunucu uygulaması bulunmaktadır. Her birinin kendine has tuhaflıkları vardır: standart dışı klasör adları, bozuk IDLE desteği, TLS sertifikası uç durumları, bağlantı zaman aşımı davranışı ve sunucuya özel kimlik doğrulama akışları. Ulaştığınız her kurumsal müşteri yeni bir uç durum ortaya çıkarabilir Bu da onların takımını engelliyor.
OAuth jetonları süresi dolar. Yenileme jetonları kullanıcı tarafından veya sağlayıcı politikası tarafından iptal edilebilir. Ölçekte, binlerce bağlı hesap için belirteç yaşam döngüsünü yönetme Üç sağlayıcı arasında, güvenilir bir arka plan işi, hata bildirimleri ve zarif bir yeniden kimlik doğrulama kullanıcı deneyimi akışı gerektirir.
Google ve Microsoft API yüzeylerini kullanımdan kaldırır ve günceller. Gmail Temel Kimlik Doğrulaması kaldırıldı. Microsoft eski Exchange uç noktalarını kullanımdan kaldırdı. Üç sağlayıcının değişiklik günlüklerine ayak uydurmak mühendislik ekibinizin tamamen üstlendiği devam eden bir bakım yüküdür.
E-posta verileri, GDPR ve SOC 2 Type II kapsamındadır. Belgelenmiş veri akışlarına, durağan ve geçici durumdaki şifrelemeye, jeton depolama politikalarına ve doğrulanabilir bir silme işlemine ihtiyacınız var. Bunu sıfırdan bir SaaS denetimi için yapmak haftalar sürebilir ve yasal inceleme gerektirir.
SaaS için Şirket İçi Geliştirme vs. E-posta Toplama API'si
Prodüksiyon ölçeğinde önem taşıyan her boyutta, kendi üç sağlayıcılı e-posta entegrasyonunuzu kurmanın, SaaS için birleşik bir e-posta API'si kullanmaya kıyasla nasıl olduğunu öğrenin.
| Yetenek | Şirket içi geliştirme | Unipile E-posta API |
|---|---|---|
| Gmail OAuth entegrasyonu | Kılavuz - CASA Seviye 2 gerekli |
Dahil - CASA Seviye 2 sertifikalı |
| Outlook / Microsoft 365 OAuth | Manuel - yayıncı doğrulaması gerekli |
Dahil - doğrulanmış yayıncı |
| IMAP desteği | Kendini oluştur - ölçekte uç durumlar |
Tamamen soyutlanmış - tüm sunucu tuhaflıkları ele alındı |
| Birleşik yanıt biçimi | Normalleştirmek için 3 ayrı veri modeli |
Tüm sağlayıcılar için tek şema |
| Gerçek zamanlı web kancaları | Yayın/Abone Ol + Grafik abonelikleri - sağlayıcı başına ayrı kurulum |
Tüm sağlayıcılar için tek bir webhook uç noktası |
| OAuth belirteç yenileme | Arka plan işiniz - hata yönetimi gerekli |
Otomatik yönetildi |
| İleti dizisi ve konuşma modeli | Sağlayıcıya özel - özel normalleştirme gerekli |
Tüm sağlayıcılarda tutarlı iş parçacığı kimlikleri |
| Ekler API | MIME ayrıştırma - sağlayıcıya göre ayrı ayrı oluştur |
Ek Kimliği ile Getir - sağlayıcıdan bağımsız |
| GDPR veri silme | Sorumluluğunuz - özel denetim izi |
Belgelenmiş silme yolu - GDPR uyumlu |
| SOC 2 Tip II kapsamı | Kendi denetimlerinizi kapsama alın |
SOC 2 Tip II sertifikalı |
| İlk e-posta senkronizasyonuna kadar geçen süre | 4-6 ay (üç sağlayıcı da) |
1 günden az |
| Devam eden bakım | Ekibiniz tüm sağlayıcı API değişikliklerini takip eder |
Unipile tarafından yönetilir - sıfır sağlayıcı bakımı |
Unipile'nin SaaS İçin Tek Bir Entegrasyonda E-posta API'sini Nasıl Sunduğu
Unipile, özel olarak kullanıcı senkronizasyon pazarı için tasarlanmış SaaS'lara yönelik birleşik bir e-posta API'sidir. Tek bir uç nokta kümesi Gmail, Outlook ve IMAP'ı kapsar; OAuth, web kancaları, iş parçacığı, ekler ve uyumluluk sizin için halledilir. İşte her sağlayıcının entegrasyonunun arka planda nasıl göründüğü.
Unipile kullanır Google OAuth 2.0 Gerekli minimum kapsamları istemek için. Platform CASA Seviye 2 sertifikalıdır, bu nedenle uygulamanız kendi değerlendirmesinden geçmeden doğrulanmış statü kazanır.
Unipile bağlanır Microsoft Graph API Microsoft Kimlik Platformu'nu kullanarak. Bu, hem kişisel Outlook hesaplarını hem de kurumsal Microsoft 365 kiracılarını tek bir OAuth akışı aracılığıyla kapsar.
Yahoo, Fastmail, özel kurumsal sunucular veya başka herhangi bir sağlayıcıdaki kullanıcılar için Unipile şunlar aracılığıyla bağlanır: IMAP. Tüm sunucuya özgü tuhaflıklar, TLS uç durumları ve klasör adlandırma farklılıkları kodunuzdan soyutlanmıştır.
account_id. Bunu kullanıcı kaydınıza karşı saklayın. Sonraki tüm e-posta çağrıları bu kimliğe atıfta bulunur - veritabanınızda jeton veya sır yok.GET /emails mesajları listelemek için, POST /e-postalar göndermek, ve GET /e-postalar/:id/ekler Dosyalar için. Her üç sağlayıcı için de aynı uç noktalar.SaaS'ınızda Kullanıcı E-postalarını Senkronize Edin: Tam Kod Örneği
Üç dil, bir desen. Bir kullanıcı gelen kutusunu bağlayın, e-postalarını alın ve kendi adreslerinden gönderin - hepsi Unipile birleşik e-posta API'si aracılığıyla. Aynı kod Gmail, Outlook ve IMAP ile bağlanan hesaplarda çalışır.
İthalat { UnipileClient } itibaren 'unipile-node-sdk';
const müşteri = yeni UnipileClient('SENIN_DSN', 'SENİN_JETONU');
// Adım 1: Kullanıcınız için barındırılan bir OAuth bağlantısı oluşturun
const authLink = bekliyor müşteri.hesap.create({
tip: 'Google', // veya 'microsoft' veya 'imap'
yönlendirme_url'si 'https://yourapp.com/callback'
});
// Kullanıcınızı OAuth onayını tamamlamak için authLink.url adresine yönlendirin
// Adım 2: Bağlı bir hesap için en son 50 e-postayı listeleyin
const { Öğeler: e-postalar } = bekliyor client.email.Tümünü al({
account_id: 'HESAP_KİMLİĞİ',
Limit: 50
});
e-postalar.her biri için(e-posta => {
konsol.log(email.konu, email.gonderen_katilimci.tanımlayıcı);
});
// Adım 3: Kullanıcının kendi adresinden gönder
bekliyor client.email.gönder({
account_id: 'HESAP_KİMLİĞİ',
kime: [{ tanımlayıcı: 'lead@company.com', görünen_ad: 'İhtimal' }],
Konu: 'Görüşmemizin devamı olarak',
body: 'Selam, sadece haberleşmek istedim...
'
});
// Adım 4: Gerçek zamanlı yeni e-posta etkinlikleri için bir webhook kaydedin
bekliyor müşteri.webkanca.create({
url 'https://uygulamam.com/webhooks/email',
etkinlikler: ['e-posta.alındı', 'e-posta gönderildi']
});İthalat istekleri
TABAN "https://api9.unipile.com:13234/api/v1"
TOKEN = "SENİN_TOKENIN"
BAŞLIKLAR = {"X-API-ANAHTAR"JETON, "İçerik-Türü": "application/json"}
# 1. Adım: Kullanıcınız için barındırılan bir kimlik doğrulama bağlantısı oluşturun
resp = requests.POST(f"{BASE}/hosted/accounts/link", json={
"tip": "Google",
"yönlendirme_url": "https://uygulamam.com/geri"
}, başlıklar=BAŞLIKLAR)
auth_url = resp.json()["url"]
# 2. Adım: En son 50 e-postayı al
e-postalar = istekler.olsun({TEMEL}/e-postalar", params={
"hesap_kimliği": "HESAP_KİMLİĞİ",
"sınır": 50
}, HEADERS).json()["eşyalar"]
için e-posta içinde e-postalar
print(e-posta"konu"], e-posta["katılımcıdan"]["tanımlayıcı"])
# 3. Adım: Kullanıcının kendi adresinden gönder
istemler.POST({TEMEL}/e-postalar", json={
"hesap_kimliği": "HESAP_KİMLİĞİ",
"için": [{"tanımlayıcı": "lead@company.com"}],
"konu": "Takipteyim",
"vücut": "Selam, sadece bir yoklama yapmak istedim...
"
}, başlıklar=BAŞLIKLAR)# 1. Adım: Barındırılan kimlik doğrulama bağlantısı oluşturun
kıvrıl -X POST \
"https://api9.unipile.com:13234/api/v1/hosted/accounts/link" \
-H "X-API-ANAHTARI: SENIN_DOĞRULAMA_BELİRTEÇİN" \
-H "İçerik-Türü: uygulama/json" \
-d '{"tip":"google","yonlendirme_url":"https://yourapp.com/callback"}'
# 2. Adım: En son gelen 50 e-postayı listele
kıvrıl -G
"https://api9.unipile.com:13234/api/v1/tumail" \
-H "X-API-ANAHTARI: SENIN_DOĞRULAMA_BELİRTEÇİN" \
--data-urlencode "hesap_kimliği=HESAP_KİMLİĞİ" \
--data-urlencode "limit=50"
# 3. Adım: Kullanıcının kendi adresinden gönder
kıvrıl -X POST \
"https://api9.unipile.com:13234/api/v1/tumail" \
-H "X-API-ANAHTARI: SENIN_DOĞRULAMA_BELİRTEÇİN" \
-H "İçerik-Türü: uygulama/json" \
-d '{"account_id":"HESAP_KODU","to":[{"identifier":"lead@company.com"}],"subject":"Takip","body":"Merhaba...
"}'Unipile OAuth URL'sini oluşturur. Kullanıcınız tıklar, onay verir ve uygulamanıza geri yönlendirilir. OAuth belirteçlerini asla doğrudan işlemezsiniz.
GET /emails ve POST /e-postalar Gmail, Outlook ve IMAP için aynı şekilde çalışır. Değiştir account_id diğer her şey aynı kalır.
Tek bir URL kaydedin. Unipile, Gmail Pub/Sub bildirimlerini, Microsoft Graph değişiklik olaylarını ve IMAP IDLE sinyallerini tek bir birleşik olay yüküne normalleştirir.
Sıkça Sorulan Sorular
E-posta API'sini kullanıcı gelen kutusu senkronizasyonu için değerlendiren SaaS kurucuları ve mühendislerinden sıkça sorulan sorular.
TR 
EN 
FR 
ES 
DE 
IT 
BR 
NL 
PL