E-posta Gönder API: Kullanıcıdan Gönder Gmail, Outlook ve IMAP Hesaplar
Çoğu e-posta API'si, sahip olduğunuz paylaşılan bir alan adından gönderim yapar. Unipile'ın gönderim e-posta API'si farklıdır: tam OAuth2, kimlik bilgisi saklama olmaksızın ve her sağlayıcı için tek bir birleşik uç nokta ile kullanıcılarınızın kendi Gmail, Outlook ve IMAP hesaplarından gönderim yapar. SaaS'ınız gerçek kişiler adına programlı olarak e-posta göndermesi gerektiğinde, işi yapan entegrasyon budur.
Kullanıcılarınız Adına E-posta Gönderen Bir E-posta Gönderme API'si
"E-posta gönderme API'si" aramalarının çoğu işlemsel sağlayıcılara yönlendirilir. Bu öyle değil. Unipile, kullanıcı hesaplarına yönelik bir e-posta API'sidir: kullanıcılarınızın gerçek Gmail veya Outlook hesaplarına bağlanır ve onların kimlikleri ve teslim edilebilirlik bilgileriyle, kendi adlarına gönderim yapar.
Geliştiricilerin Kullanıcı Hesapları E-posta API'si Üzerine Neden Oluşturduğu
Ürününüzün gerçek kişilerden (noreply@ adresi olmayan) programatik olarak e-posta göndermesi gerektiğinde, benimsenmeyi sağlayan senaryolar bunlardır.
Satış temsilcilerinin kendi Gmail veya Outlook hesaplarından takip e-postaları gönderin. Daha yüksek yanıt oranları, gerçek gönderen kimliği, alan adı ısınması gerekmez. Potansiyel müşteriler genel bir takma ad yerine gerçek bir isim görür.
Destek görevlilerinin doğrudan kendi posta kutularından yanıt vermesine izin verin. Müşteriler, bir destek@ takma adından ziyade gerçek bir kişinin adını ve e-posta adresini görür. Güven oluşturur, çözüm hızını artırır.
İşe alım uzmanının kendi hesabından kişiselleştirilmiş e-postalarla adaylara ulaşın. Soğuk etki alanı yok, spam filtresi riski yok, ısınma süresi yok. E-posta kişisel bir mesaj gibi gelen kutusuna ulaşır, çünkü öyledir.
Gmail, Outlook ve IMAP'tan E-posta Gönderin: Tek Bir API
Unipile'ın e-posta gönderme API'si, sağlayıcı katmanını tamamen soyutlar. Kullanıcınızın hesabı Gmail, Outlook, Microsoft 365, Exchange Online veya herhangi bir IMAP uyumlu posta kutusu olsa da API çağrısı aynıdır. Entegrasyonu bir kez yazarsınız ve her sağlayıcı sorunsuz çalışır.
gmail.gönder: minimum izin ayak izi Mail.Gönder: yetkilendirilmiş veya uygulama düzeyinde API Üzerinden E-posta Gönderme: Adım Adım Entegrasyon
Hesap bağlamadan ilk e-postanızı programlı olarak göndermeye kadar, işte tüm akış. Bu kılavuz Gmail ve Outlook'u kapsar; IMAP adımları aynıdır, yalnızca hesap türü farklıdır.
Unipile kontrol panelinde kaydolun. Her çalışma alanına bir API anahtarı verilir. Tüm istekler, API anahtarınızla doğrulanır. X-API-ANAHTAR header. Sizin tarafınızda OAuth kurulumu yok: Unipile sağlayıcı kimlik doğrulamasından sorumludur.
API aracılığıyla bir barındırılan kimlik doğrulama bağlantısı oluşturun. Kullanıcı buna tıkladığında, sağlayıcısı için standart OAuth2 onay ekranından geçer. Unipile belirteçleri güvenli bir şekilde depolar ve bir account_id. Kimlik bilgilerine asla dokunmazsınız.
"tip":"MICROSOFT". IMAP için, "tip":"IMAP". Aynı barındırılan akış, üç sağlayıcının tümünü işler.Kullanıcı OAuth2'yi tamamladıktan sonra, Unipile uç noktanıza bir webhook gönderir. account_id. Veritabanınıza kaydedin: Bu, o kullanıcı için her e-posta gönderme API çağrısında kullanacağınız anahtar olacaktır.
POST'a /api/v1/emails ile account_id. E-posta, kullanıcının kendi gönder düğmesine basmış gibi, kullanıcının gerçek Gmail veya Outlook gelen kutusundan çıkar. Uç nokta, bağlı hesap Gmail, Outlook veya IMAP olsa da aynıdır.
"cc", "Gizli", "yanıtla"ve "ekler" aynı yüke.Gmail, Outlook ve IMAP'ten e-posta göndermeye hazır mısınız?
API anahtarınız bekliyor. 10 dakikadan kısa sürede geliştirmeye başlayın.
Tüm Sağlayıcılarda E-posta Göndermek İçin Tek Birleşik Uç Nokta
Çoklu sağlayıcı entegrasyonlarındaki en büyük sürtünme, her bir e-posta hizmeti için ayrı kod yollarını sürdürmektir. Unipile bunu ortadan kaldırır. Bağlı hesap Gmail, Outlook veya IMAP olsa da, her zaman aynı uç noktaya aynı yükle çağrı yaparsınız. Soyutlama katmanı, sağlayıcıya özgü protokolleri, jeton yenilemelerini ve arka planda oran sınırı farklılıklarını yönetir.
Gmail ve Outlook için ayrı kod yolları yok. Tek bir entegrasyon bugün üç sağlayıcının tümünü ve Unipile'ın ekleyeği gelecekteki her şeyi kapsar.
OAuth2 erişim belirteçleri süresi dolar. Unipile bunları şeffaf bir şekilde yeniler. Kodunuz belirteç yaşam döngüsünü asla yönetmez; API'yi çağırın ve gönderin.
Her kullanıcı kendi hesabını bağlar. Her kullanıcı için bir account_id yönetiyorsunuz; gerisini Unipile halleder. Sağlayıcı başına SDK karmaşası yok.
API, sağlayıcıdan bağımsız olarak aynı JSON yapısını döndürür. Tek bir şema ayrıştırın, tek bir hata işleyici oluşturun, daha hızlı teslim edin.
Kullanıcılarınız adına geniş ölçekte e-posta göndermeniz mi gerekiyor? Nasıl yapılacağına dair tam rehberi okuyun kullanıcılarınız adına e-posta gönderin, Unipile'ın her şeyi denetlenebilir tutmak için kullandığı uyumluluk ve onay modeli dahil.
Tüm E-posta Gönderme API'ları, Düzenlenmiş
Tek bir entegrasyonla Gmail, Outlook ve IMAP genelinde hesaplara bağlanmak, göndermek ve yanıtlamak, gelen kutunuzu yönetmek ve olayları dinlemek için kullanabileceğiniz tüm uç noktalar.
Gönder & Yanıtla
4 mevcut uç noktalar
Hesap Kurulumu
3 mevcut uç noktalar
E-postaları Yönet
5 mevcut uç noktalar
Webhooks
2 mevcut etkinlikler
Kimlik doğrulama akışlarını, webhook kurulumunu, e-posta okuma ve gönderme, ekleri ve tam sağlayıcı karşılaştırmasını kapsar; üretim için hazır bir e-posta gönderme API entegrasyonu oluşturmak için ihtiyacınız olan her şey.
E-posta Gönder API Entegrasyonunuz İçin Kimlik Doğrulama ve Güvenlik
Kullanıcı e-posta kimlik bilgilerini yönetmek, herhangi bir SaaS entegrasyonunun en yüksek riskli kısımlarından biridir. Unipile'ın mimarisi, OAuth2 belirteçlerini asla doğrudan saklamayacak veya iletmeyecek şekilde tasarlanmıştır; bu sayede risk alanı minimumda kalır ve uyumluluk yönetilebilir seviyede tutulur.
Unipile, OAuth2 izin URL'sini oluşturur, yetkilendirme kodunu toplar ve erişim ve yenileme belirteçlerini kendi şifreli kasasında saklar. Arkaminiz yalnızca bir account_id. Hammadde belirteci yok, şifre yok, kimlik bilgisi kayması yok.
Gmail OAuth2 jetonları 1 saat sonra süresi doluyor. Microsoft jetonları 1 saat sonra (erişim) veya 90 gün sonra (yenileme) süresi doluyor. Unipile, süresi dolmadan önce otomatik olarak yeniler. E-posta gönderme API çağrılarınız hiçbir zaman geçersiz bir jeton nedeniyle başarısız olmaz.
Sadece gönderim entegrasyonu için Unipile yalnızca gerekli kapsamları ister: gmail.gönder Gmail ve Mail.Gönder Outlook için. Bu, en az ayrıcalık ilkesini izler ve kullanıcı verilerinizin saldırı yüzeyini azaltır.
Unipile'ın uç noktanıza gönderdiği her webhook, webhook gizlinize karşı doğrulayabileceğiniz bir imza üst bilgisi içerir. Bu, sisteminizdeki eylemleri tetiklemeye çalışan üçüncü tarafların olay yüklerini taklit edememesini sağlar.
Unipile'ın altyapısı SOC 2 Tip II sertifikalıdır. Denetlenen kontroller erişim yönetimi, depolanan ve aktarılan verilerin şifrelenmesi, olay müdahalesi ve kullanılabilirliği kapsar. Bu, SaaS müşterilerinizin e-posta kimlik bilgilerini nasıl ele aldığınızı sorduğunda satıcı güvenlik incelemelerinden geçmeyi kolaylaştırır.
Güvenli e-posta API'sini öğreninUnipile, Google'ın hassas Gmail API kapsamlarına erişen uygulamalar için gerektirdiği güvenlik standardı olan CASA Tier 2'ye sahiptir. Değerlendirme, yetkili bir laboratuvar tarafından yapılır ve veri işleme, erişim kontrolleri ve güvenli geliştirme uygulamalarını kapsar. Gmail gönderme kapsamlarına üretim erişimini sürdürmek için gereklidir.
Tüm Sağlayıcılarda Tam E-posta API Özellik Kapsamı
Tek bir entegrasyonla Gmail, Outlook ve IMAP sağlayıcıları genelindeki tüm önemli e-posta işlemlerine erişim sağlarsınız. Kullanıcınızın hangi hesabı bağladığına bakılmaksızın aynı uç nokta, aynı veri yapısı, aynı yanıt formatı.
| Özellik | Gmail | Outlook / M365 | IMAP / SMTP |
|---|---|---|---|
| Gönderme | |||
| Kullanıcı hesabından e-posta gönder | ✓ | ✓ | ✓ |
| Ekleriyle gönder | ✓ | ✓ | ✓ |
| Mevcut başlıkta yanıtla | ✓ | ✓ | ✓ |
| CC ve BCC alıcıları | ✓ | ✓ | ✓ |
| HTML vücut içeriği | ✓ | ✓ | ✓ |
| Satır içi resimler (CID gömme) | ✓ | ✓ | ✓ |
| Günlük gönderme limiti (yaklaşık) | Günde ~500 | ~10.000 / gün | Sunucuya bağımlı |
| Okuma ve Senkronizasyon | |||
| E-postaları listele ve oku | ✓ | ✓ | ✓ |
| Konu / konuşma görünümü | ✓ | ✓ | ✓ |
| Gerçek zamanlı web kancaları (yeni e-posta, okundu, gönderildi) | ✓ | ✓ | ✓ |
| Artımlı delta senkronizasyonu | ✓ | ✓ | ✓ |
| Etiket ve klasör yönetimi | ✓Etiketler | ✓Klasörler | ✓Klasörler |
| Kimlik Doğrulama ve Güvenlik | |||
| OAuth2 (şifre depolama yok) | ✓ | ✓ | Uygulama şifresi |
| Otomatik jeton yenileme | ✓ | ✓ | ✓ |
| SOC 2 Tip II / CASA Seviye 2 | ✓ | ✓ | ✓ |
E-posta Gönderme API Entegrasyonu Oluştururken Yapılan Yaygın Hatalar
Geliştiricilerin bir kullanıcı hesabı e-postası gönderme API'sini entegre ederken karşılaştığı sorunların çoğu küçük bir kategori kümesine girer. İşte başlamadan önce bilmeniz gerekenler.
Gmail kişisel hesapları günde yaklaşık 500 e-posta ile sınırlıdır. Outlook hesaplarının limitleri daha yüksektir ancak ani yüklenmelerde yine de kısıtlanabilir. Bu limitlerin aşılması, sağlayıcı tarafından 429 hatalarına veya geçici hesap askıya alınmasına neden olur.
Kullanıcılar, Google veya Microsoft hesap ayarlarından istedikleri zaman erişimi iptal edebilir. Bu durumda, Unipile bir sonraki API çağrısında o hesap için bir hata döndürecektir. Uygulamanız bunu düzgün bir şekilde ele almazsa, bu durum sessiz e-posta gönderme hatalarına yol açar.
account.disconnected webhook olayı ve kullanıcıyı hesabını yeniden bağlaması için uyar.Geçerli bir OAuth2 belirtecine sahip olsa bile, bir kullanıcının hesabından onların bilgisi olmadan e-posta göndermek Google ve Microsoft'un kullanım politikalarını ve çoğu yargı alanındaki spam yasalarını ihlal eder. OAuth2 izin ekranı, uygulamanızın ne yapacağını açıkça açıklamalıdır.
Erişim belirteçlerini kendiniz depolarsanız ve bir veri ihlalinde bunlar açığa çıkarsa, bir saldırganın bağlı tüm e-posta hesaplarına tam erişimi olur. Bu, özellikle GDPR kapsamında kritik bir güvenlik ve uyumluluk riskidir.
account_id; Unipile, tokenları SOC 2 sertifikalı kasasında saklar. Veritabanınız asla ham bir OAuth2 beliracına dokunmaz.SMTP doğrudan sunucu erişimi, kimlik bilgileri yönetimi, TLS yapılandırması ve iade yönetimi gerektirir. Bir REST e-posta gönderme API'si tüm bunları soyutlar. Her iki yaklaşımı aynı kod tabanında birleştirmek, fayda sağlamadan karmaşıklık katar.
Sıkça Sorulan Sorular
E-posta gönderme API'si hakkında bilmeniz gereken her şey.
account_id webhook aracılığıyla. Ardından POST isteği yaparsınız /api/v1/emails o account_id ve mesaj yükünüz ile. E-posta onların gerçek Gmail adresinden gönderilir. Sizin tarafınızdan herhangi bir Gmail API anahtarı kurulumu gerekmez.Mail.Gönder yetki devri. Unipile, jeton yenilemesini otomatik olarak halleder.https://www.googleapis.com/auth/gmail.send. Bu, e-posta göndermeye olanak tanır ancak mesajları okuma, değiştirme veya silme erişimi vermez. Unipile'ı kullanırken bu kapsamı kendiniz yapılandırmazsınız; barındırılan kimlik doğrulama akışı bunu halleder. Tamamen e-posta gönderme API'si kullanım durumu için, gmail.gönder yeterlidir.POST /api/v1/emails uç nokta Gmail, Outlook ve IMAP hesaplarını işler. Sağlayıcı, şu şekilde belirlenir: account_id yük içinde; belirtmenize gerek yok. Gönderme mantığınızı bir kez yazın ve kullanıcınızın hangi e-posta sağlayıcısını bağladığına bakılmaksızın çalışacaktır.Hala sorularınız mı var? Ekibimiz yardım etmek için burada.
İlk Gmail, Outlook veya IMAP hesabınızı bağlayın ve 30 dakikadan kısa sürede ilk e-postanızı programlı olarak gönderin. Kimlik bilgisi depolama yok, sizin tarafınızda OAuth2 kurulumu yok, sağlayıcı başına SDK yok. Bir hesap kimliği, bir REST uç noktası, tüm sağlayıcılar.