Başla

Sorunsuz Yazılım Entegrasyonu için E-posta Senkronizasyon API'si

Unipile - E-posta Senkronizasyon API Kahramanı
E-posta Senkronizasyon API'si - 2026 Kılavuzu

E-posta Senkronizasyon API'si: E-posta Senkronizasyonu SaaS Ürünleri İçin Nasıl Çalışır

Kullanıcıların gelen kutularını gerçek zamanlı olarak senkronize eden SaaS özellikleri oluşturun. Webhook'lar, OAuth akışları ve tam klasör erişimi dahil olmak üzere tek bir e-posta senkronizasyon API'si aracılığıyla Gmail, Outlook ve IMAP'i bağlayın.

Ücretsiz senkronize etmeye başla Belgelere göz atın
sync-emails.js
const UnipileClient = require('@unipile/node-sdk'); const müşteri = yeni UnipileClient({ dsn: process.env.UNIPILE_DSN, token: process.env.UNIPILE_TOKEN }); // Bağlı hesaptan eşitlenmiş e-postaları al const e-postalar = bekliyor client.email.E-postaları listele({ account_id: 'acc_gmail_xyz', Klasör: 'GELEN KUTUSU', Limit: 50 }); Gerçek Zamanlı: webhook kaydet bekliyor müşteri.webkanca.create({ url 'https://uygulamam.com/webhooks/email', etkinlikler: ['e-posta.yeni', 'e-posta.oku'] });
Gmail, Outlook ve IMAP genelinde birleşik eşitleme
Destekler Gmail Görünüm IMAP
Tanım

E-posta Senkronizasyon API'si nedir?

Bir e-posta senkronizasyon API'si uygulamanızın bir kullanıcının gelen kutusunu sürekli olarak yansıtmasını sağlayan programatik bir arayüzdür. Yeni mesajları okur, durum değişikliklerini (okundu/okunmadı, taşındı, silindi) izler ve klasör yapısını yansıtır. Kullanıcının verileri manuel olarak dışa aktarmasına gerek kalmadan çalışır. Yalnızca gönderme API'lerinin aksine, bir e-posta senkronizasyon API'si Ürününüze gelen kutusunun canlı, iki yönlü bir kopyasını tutar.

Protokol düzeyinde, her sağlayıcı kendi senkronizasyon ilkelini sunar: Gmail şunu kullanır tarih.liste with a tarihKimliği imleç, Microsoft Graph, delta sorgularını şu şekilde kullanır: /mesajlar/delta uç nokta ve standart IMAP sunucuları destekler BOŞTA push bildirimleri için komut. A birleşik e-posta senkronizasyon API'si Unipile'ın bu üç protokolü tek bir uç noktanın arkasına soyutlaması gibi, ekibiniz senkronizasyon mantığını bir kez yazar ve tüm sağlayıcılara gönderir.

Bir CRM, satış etkileşim aracı, AI e-posta yardımcısı veya canlı gelen kutusu verisine ihtiyaç duyan herhangi bir SaaS oluşturuyorsanız, e-posta senkronizasyon API'si temeldir. İşlemsel e-postalar (şifre sıfırlama, makbuzlar) göndermek için ise bu farklı bir kategoridir - bakınız tam e-posta API kılavuzumuz.

Gerçek zamanlı gelen kutusu yansıtma
Gmail, Outlook ve IMAP
OAuth 2.0 + jeton yenileme
Yeni e-postalar için webhooklar
Klasör + etiket senkronizasyonu
Kavramlar

E-posta Senkronizasyonu ve E-posta Gönderme: Neden Farklılık Önemlidir

Geliştiriciler sıklıkla e-posta senkronizasyon API'lerini işlem e-postası API'leriyle karıştırırlar. Bunlar zıt amaçlara hizmet eder. Yanlış kategoriyi seçmek mimarinizi haftalarca geriye götürür.

Ne inşa ediyorsunuz
E-posta Senkronizasyon API'si

Kullanıcının mevcut posta kutusunu okur ve uygulamanıza yansıtır. Kullanıcının hesabına erişim izni vermesini (OAuth veya IMAP kimlik bilgileri) gerektirir. Uygulamanız, gelen kutularının ikincil bir okuyucusu olur.

  • Gelen ve giden iletileri okur
  • Okunan/okunmayan izler, etiketler, klasörler
  • Yeni e-postalar için Webhook bildirimleri
  • Tam iş parçacığı ve ekli dosya erişimi
  • Delta senkronizasyon - yalnızca değişiklikleri getirir

    • Kullanım Alanları: CRM'ler, satış etkileşim araçları, yapay zeka e-posta yardımcıları, yardım masaları, e-posta arşivleme, gelen kutusu analizleri.

    Farklı kategori
    İşlemsel E-posta API'si

    E-postaları kendi alan adınızdan sistem tarafından oluşturulmuş olarak gönderin. Kullanıcı yetkilendirmesi gerekmez. Kullanıcı yerine gönderen olarak kimlik doğrulaması yaparsınız (API anahtarı). Örnekler: SendGrid, Mailgun, Resend, Amazon SES.

  • Yalnızca dışarıya (parola sıfırlamaları, makbuzlar)
  • API anahtarı ile kimlik doğrulandı, OAuth ile değil
  • Teslimat oranına ve SPF/DKIM'e odaklanıldı
  • Gelen kutusu okuma erişimi yok
  • Kullanıcı tarafında OAuth onayı gerekmez

    • Unipile bu kategoride DEĞİLDİR. Unipile, senkronizasyon tarafıdır - OAuth aracılığıyla kullanıcı gelen kutularını okur ve yansıtır.

    Kullanım Örnekleri

    E-posta Senkronizasyon API'sine Kimin İhtiyacı Var?

    Gelen e-postaları görüntülemesi, analiz etmesi veya bunlara göre işlem yapması gereken herhangi bir SaaS ürünü, bir e-posta senkronizasyon API'sine dayanır. İşte üretimde gördüğümüz en yaygın beş kullanım örneği.

    CRM E-posta Senkronizasyonu

    Gelen ve giden tüm e-postaları otomatik olarak doğru kişi kaydına kaydedin. Satış temsilcilerinin e-postaları kopyalayıp yapıştırmasına gerek kalmaz; CRM gerçek zamanlı kayıt sistemi haline gelir. Manuel BCC iletme gerekmez.

    E-posta API rehberi
    Satış Etkileşimi

    Yanıt oranlarını izleyin, mesai dışı yanıtları algılayın ve gelen kutusu olaylarına göre takip sıralarını tetikleyin. Bir e-posta senkronizasyon API'si, sıralarınıza potansiyel müşterinin gelen kutusunda neler olup bittiği konusunda gerçek zamanlı farkındalık kazandırır.

    Programlı olarak e-posta gönder
    Yapay Zekâ E-posta Temsilcileri

    E-posta akışı canlı olarak bir LLM temsilcisine beslenir. Bu temsilci yanıtlar taslağı oluşturur, gelen iletileri kategorilere ayırır, eylem maddelerini çıkarır veya destek taleplerini yönlendirir. Temsilcinin tek seferlik bir dışa aktarma yerine sürekli bir senkronizasyon akışına ihtiyacı vardır. Gerçek zamanlı bir e-posta senkronizasyon API'si zorunludur.

    E-postaları programatik olarak oku
    Yardım Masası Entegrasyonu

    Müşteri e-postalarını, tüm ileti dizisi bağlamını ve eklerini dahil ederek otomatik olarak destek taleplerine dönüştürün. Acente yanıt verdiğinde talep durumunu geri senkronize edin, böylece müşterinin gelen kutusu çözüm ileti dizisini yansıtır.

    E-posta API sağlayıcılarını karşılaştırın
    E-posta Arşivleme

    Uyumluluk, yasal inceleme veya analiz için gelen ve giden tüm e-postaları yakalayın. Bir e-posta senkronizasyon API'si, posta sunucusuna doğrudan dokunmadan tüm kurumsal iletişimlerin sorgulanabilir bir arşivini oluşturmanıza olanak tanır.

    Ücretsiz E-posta API Katmanı
    Gelen Kutusu Analitiği

    Bir ekibin birbirine bağlı hesaplarında e-posta hacmini, yanıt sürelerini, iletişim kalıplarını ve duyarlılığı analiz edin. Pazarlama, operasyon ve finans ekipleri, iletişim kalitesini ölçmek ve darboğazları tespit etmek için gelen kutusu analizlerini kullanır.

    E-posta API tam kılavuzu
    Motor Kaputunun Altında

    E-posta Senkronizasyonu Nasıl Çalışır: OAuth, Delta Sync ve Webhook'lar

    E-posta senkronizasyon API'si bir okuma uç noktasından daha fazlasıdır. Kullanıcıları kimlik doğrulaması yapan, token güncelliğini koruyan, posta kutusu durumunu izleyen ve değişiklikleri neredeyse gerçek zamanlı olarak sunan durum bilgili bir işlem hattıdır. Her katmanda olanlar şunlardır.

    1
    OAuth 2.0 Yetkilendirme Akışı

    Kullanıcı uygulamanızda "Gelen kutunuzu bağlayın"ı tıklar. Uygulamanızın istediği kapsamları onayladıkları Google veya Microsoft'un onay ekranına yönlendirilirler. Gmail için bu demektir gmail.yalnızcaoku veya gmail.değiştir; Outlook için şu anlama gelir Mail.Read veya Mail.ReadWrite. Onaydan sonra, uygulamanız bir erişim belirteci (Google için 1 saat, Microsoft için 1 saat geçerli) ve bir yenileme jetonu (uzun ömürlü). IMAP hesapları, sağlayıcının yapılandırmasına bağlı olarak kullanıcı adı + parola veya OAuth kullanır.

    2
    İlk Posta Kutusu Anlık Görüntüsü

    İlk senkronizasyonda, e-posta senkronizasyon API'si tam bir geriye dönük doldurma yapar: klasör listesini getirir (KUTU İÇİ, Gönderildi, Taslaklar, özel etiketler) ve yapılandırılabilir bir geçmiş derinliğine kadar en son mesajları çeker. Gmail için bu şunları kullanır kullanıcıların mesaj listesi sayfalama ile. Microsoft Graph için, GET /benim/mesajlarım. IMAP için, bir şey çıkarır GELEN KUTUSU SEÇİN ardından bir ÇEK aralık. Anlık görüntü veritabanınıza ileti kimlikleri ve dahil olmak üzere temel durumunu verir konu grupları.

    3
    Delta Sync - Yalnızca Değişenleri Al

    İlk anlık görüntüsünden sonra, tam posta kutusunu tekrar tekrar sorgulamak kota israfına ve uygulamanızın yavaşlamasına neden olur. Delta senkronizasyonu çözümdür. Gmail şunları sağlar tarihKimliği imleç: çağırıyorsun kullanıcıların.geçmişi.listesi son bilinenle tarihKimliği ve yalnızca o noktadan bu yana olan değişiklikleri (yeni iletiler, etiket değişiklikleri, silinenler) alırsınız. Microsoft Graph kullanır GET /benim/mesajlarım/delta with a $deltaBelirteci. IMAP kullanır UID ÇEKME with a DEĞİŞİLDİ değiştirici (CONDSTORE uzantısı). Bu delta senkronizasyonu Yüksek hacimli posta kutuları için bile desen API çağrılarını minimumda tutar.

    4
    Token Yenileme ve Oturum Sürdürme

    Erişim jetonları süresi doluyor. E-posta senkronizasyon altyapınız algılamalıdır 401 Yetkisiz Yanıt olarak, yeni bir erişim belirteci almak için yenileme belirtecini Google veya Microsoft'tan kullanın ve başarısız isteği yeniden deneyin. Bunun kullanıcı oturumunu kesintiye uğratmadan şeffaf bir şekilde gerçekleşmesi gerekir. Yenileme belirteçlerinin kendileri de kullanıcı tarafından, bir yönetici ilkesi tarafından veya 6 aylık hareketsizliğin ardından (Google) iptal edilebilir, bu nedenle sisteminizin iptali algılaması ve kullanıcıyı yeniden yetkilendirmeye teşvik etmesi gerekir.

    5
    Gerçek Zamanlı Bildirimler İçin Webhook'lar

    Zamanlanmış anketleme gecikmeye neden olur - 30 saniyelik anket, e-postaların 30 saniyeye kadar eski olabileceği anlamına gelir. Gerçek zamanlı gelen kutusu özellikleri için e-posta senkronizasyon API'si şunu desteklemelidir bildirimler. Gmail, Google Cloud Pub/Sub kullanır: bir konu kaydeder ve Gmail her yeni bildirim gönderdiğinde yayına tarihKimliği geliştirmeleri. Microsoft Graph, değişiklik bildirimlerini şuralarda kullanır /me/mailFolders/inbox/messages Tek bir birleşik e-posta senkronizasyon API'si (Unipile gibi) bunları tek bir webhook olayına dönüştürür. e-posta.yeni teslimat noktasına sağlayıcıdan bağımsız olarak teslim edilir.

    Unipile - Yerel E-posta Senkronizasyon API'leri
    Sağlayıcı Derinlemesine İnceleme

    Yerel E-posta Senkronizasyon API'leri: Gmail, Microsoft Graph ve IMAP

    Üç e-posta sağlayıcısının her biri farklı bir senkronizasyon ilkelini ortaya çıkarır. Farklılıkları anlamak, çoklu sağlayıcı bir e-posta senkronizasyon API'sinin neden günler yerine aylar sürdüğünü anlamanızı sağlar.

    Gmail logosu Gmail - geçmişi.liste + Pub/Sub Google Workspace ve kişisel hesaplar

    Gmail'in senkronizasyon modeli, etrafında oluşturulmuştur tarihKimliği imleç. İlk senkronizasyonunuzdan sonra, sonraki her çağrı kullanıcıların.geçmişi.listesi en son bildiğinizden bu yana yalnızca değişiklikleri döndürür tarihKimliği - yeni mesajlar, etiket eklemeleri, etiket çıkarmaları ve silme işlemleri.

    İçin Gerçek zamanlı anlık bildirim, Gmail, bir Google Cloud Pub/Sub konusu ayarlamanızı ve aramaya yönlendirmenizi gerektirir kullanıcılar.izle kaydetmek için. Gmail daha sonra (yeni bir anahtar içeren) bir bildirim yayınlar tarihKimliğiposta kutusu her değiştiğinde konunuza. İşçiniz konuya abone olur ve şunu çağırır tarih.liste gerçek değişiklikleri almak için.

    Oran limitleri: Proje başına günde 1 milyar kota birimi, kullanıcı başına limitlerle. kullanıcılar.mesajlar.al 5 birim tutar; kullanıcıların.geçmişi.listesi 2 birim tutar. Çok kiracılı bir uygulama için kota yönetimi tam zamanlı bir endişe haline gelir. Bkz. e-posta API kılavuzu daha fazla.

    gmail-delta-sync.py
    itibaren googleapiclient.discovery İthalat inşa etmek historyId imlecini kullanarak # Delta senkronizasyonu fonksiyon değişiklikleri al(servis, geçmiş_id): sonuç = service.users().history().list( kullanıcıId='ben', başlangıçTarihId=tarih_id, GeçmişTürleri=[ 'mesajEklendi', 'mesajSilindi', 'etiketEklendi' ] ).yürüt() return sonuç.al('tarih', [])
    Outlook ve Microsoft 365 logosu Outlook / Microsoft 365 - Grafik delta sorguları Kişisel Outlook ve Exchange Online / M365

    Microsoft Graph kullanır delta sorguları üzerinde /benim/mesajlarım/delta endpoint. İlk çağrı tam bir sayfa mesaj artı bir @odata.deltaLink. Subsequent calls to that delta link return only changed messages since the previous call - new, modified, and deleted items.

    İçin Gerçek zamanlı anlık bildirim, Microsoft Graph, webhook'lar aracılığıyla değişiklik bildirimlerini destekler. Bir abonelik kaydedersiniz /me/mailFolders/inbox/messages with a bildirimUrl. Microsoft gönderiyor bir POSTA Mesajlar değiştiğinde URL'nize. Abonelikler her 4230 dakikada bir (yaklaşık 3 gün) yenilenmelidir, aksi takdirde süresi dolacaktır.

    Not: Bu, hem kişisel Outlook hesaplarını hem de Microsoft 365 / Exchange Online'ı kapsar - aynı Graph API'sini kullanırlar. Bkz. Microsoft Graph e-posta entegrasyon kılavuzu uygulama kaydı ve yönetici onayı hakkında ayrıntılı bilgi için.

    graph-delta-sync.js
    // Microsoft Graph değişiklik eşitleme async function deltaMesajlarıGetir(istemci, deltaBağlantı) { const url = deltaBağlantı || '/ben/mesajlar/delta'; const Res = bekliyor müşteri .api(url) .seç('kimlik,konu,kimden,alındığıTarihi') .olsun(); return { mesajlar: res.değer, sonrakiDelta: res['@odata.deltaLink'] }; }
    IMAP logosu IMAP - IDLE komutu + UID FETCH Herhangi bir posta sunucusu için evrensel yedekleme

    IMAP (RFC 3501), modern senkronizasyon API'lerinden on yıllarca önce ortaya çıktı. Klasör bazında sıra numaraları ve UID'ler. Delta senkronizasyonu için, GÜNÜNMAĞAZASI eklenti (RFC 7162) ekler MODSEQ her mesaja değer vererek, yalnızca mesajları şu şekilde alabilmeniz MODSEQ daha yüksek bilinenden bilinen değeriniz aracılığıyla UID AL GETİR * (BAYRAKLAR) (MODSEQ'DEN BU YANA DEĞİŞENLER).

    İçin Gerçek zamanlı anlık bildirim, IMAP, şunları destekler BOŞTA komut (RFC 2177). İstemciniz gönderir BOŞTA ve sunucu gönderir VARDIR veya SİLME klasör değiştiğinde yanıtlar - yoklama gerekmez. Çoğu IMAP sunucusu IDLE'yi destekler; bağlantılar zaman aşımlarını önlemek için her 29 dakikada bir yenilenmelidir.

    IMAP, Google veya Microsoft tarafından yönetilmeyen herhangi bir posta sunucusunu (şirket içi Exchange, ProtonMail, Zoho, Fastmail ve özel alan adları gibi) kapsadığı için kritiktir. Bkz. IMAP entegrasyon kılavuzu tam bir uygulama adım adım kılavuzu için.

    imap-idle-sync.js
    const Imap = require('imap'); const imap = yeni Imap({ ana bilgisayar, port: 993, tls: true }); imap.bir kez('hazır', () => { imap.açıkKutu('GELEN KUTUSU', true, () => { imap.on('posta', (yeniSayaç) => { // BOŞTA itme: yeni e-posta geldi YeniMesajlarıGetir(yeniNum); }); }); });
    Unipile - E-posta API Özellik Kapsamı
    API Yetenekleri

    Sağlayıcıya Göre E-posta API Özellikleri Kapsamı

    Tek bir Unipile entegrasyonu, Gmail, Outlook ve IMAP sağlayıcılarındaki tüm e-posta işlemlerine erişmenizi sağlar. Tam entegrasyon kılavuzunu okumak için herhangi bir sağlayıcı başlığına tıklayın.

    Özellik Gmail Outlook / M365 IMAP / SMTP
    Kimlik Doğrulama
    OAuth2 (şifre depolama yok) ✓ ✓ Uygulama şifresi
    Hosted kimlik doğrulama / onay akışı ✓ ✓ ✓
    Otomatik jeton yenileme ✓ ✓ ✓
    E-posta İşlemleri
    Kullanıcı hesabından e-posta gönder ✓ ✓ ✓
    E-postaları Oku ve Listele ✓ ✓ ✓
    Ekleriyle gönder ✓ ✓ ✓
    Mevcut başlıkta yanıtla ✓ ✓ ✓
    Taslak yönetimi ✓ ✓ ✓
    Etiketler / Klasörler ✓Etiketler ✓Klasörler ✓Klasörler
    Günlük gönderme limiti (yaklaşık) Günde ~500 ~10.000 / gün Sunucuya bağımlı
    Senkronizasyon ve Etkinlikler
    Gerçek zamanlı web kancaları ✓ ✓ ✓
    Artımlı delta senkronizasyonu ✓ ✓ ✓
    İş parçacığı gruplama ✓ ✓ ✓
    SOC 2 Tip II / CASA Seviye 2 ✓ ✓ ✓
    Sağlayıcı entegrasyon kılavuzları
    Gmail
    Gmail Entegrasyon kılavuzunu oku
    Görünüm
    Outlook / M365 Entegrasyon kılavuzunu oku
    IMAP
    IMAP / SMTP Entegrasyon kılavuzunu oku
    Kimlik Doğrulama
    OAuth2 (şifre depolama yok)
    GmailGmail
    ✓
    GörünümOutlook / M365
    ✓
    IMAPIMAP / SMTP
    Uygulama şifresi
    Hosted kimlik doğrulama / onay akışı
    GmailGmail
    ✓
    GörünümOutlook / M365
    ✓
    IMAPIMAP / SMTP
    ✓
    Otomatik jeton yenileme
    GmailGmail
    ✓
    GörünümOutlook / M365
    ✓
    IMAPIMAP / SMTP
    ✓
    E-posta İşlemleri
    Kullanıcı hesabından e-posta gönder
    GmailGmail
    ✓
    GörünümOutlook / M365
    ✓
    IMAPIMAP / SMTP
    ✓
    E-postaları Oku ve Listele
    GmailGmail
    ✓
    GörünümOutlook / M365
    ✓
    IMAPIMAP / SMTP
    ✓
    Ekleriyle gönder
    GmailGmail
    ✓
    GörünümOutlook / M365
    ✓
    IMAPIMAP / SMTP
    ✓
    Mevcut başlıkta yanıtla
    GmailGmail
    ✓
    GörünümOutlook / M365
    ✓
    IMAPIMAP / SMTP
    ✓
    Taslak yönetimi
    GmailGmail
    ✓
    GörünümOutlook / M365
    ✓
    IMAPIMAP / SMTP
    ✓
    Etiketler / Klasörler
    GmailGmail
    ✓Etiketler
    GörünümOutlook / M365
    ✓Klasörler
    IMAPIMAP / SMTP
    ✓Klasörler
    Günlük gönderme limiti (yaklaşık)
    GmailGmail
    Günde ~500
    GörünümOutlook / M365
    ~10.000 / gün
    IMAPIMAP / SMTP
    Sunucuya bağımlı
    Senkronizasyon ve Etkinlikler
    Gerçek zamanlı web kancaları
    GmailGmail
    ✓
    GörünümOutlook / M365
    ✓
    IMAPIMAP / SMTP
    ✓
    Artımlı delta senkronizasyonu
    GmailGmail
    ✓
    GörünümOutlook / M365
    ✓
    IMAPIMAP / SMTP
    ✓
    İş parçacığı gruplama
    GmailGmail
    ✓
    GörünümOutlook / M365
    ✓
    IMAPIMAP / SMTP
    ✓
    SOC 2 Tip II / CASA Seviye 2
    GmailGmail
    ✓
    GörünümOutlook / M365
    ✓
    IMAPIMAP / SMTP
    ✓
    Ücretsiz deneyin

    Gmail + Graph + IMAP gibi standart yöntemlerden kaçının. Tek bir e-posta senkronizasyon API'si hepsini kapsar.

    Unipile'ın birleşik e-posta senkronizasyon API'si, tek bir uç nokta aracılığıyla Gmail, Outlook ve IMAP'a bağlanır. OAuth akışları, jeton yenileme, delta senkronizasyon ve web kancaları - hepsi sizin için halledilir. Ücretsiz başlar, kredi kartı gerekmez.

    Ücretsiz başlayın Belgeleri oku
    Kredi kartı yok
    Ücretsiz e-posta API katmanı mevcut
    5 dakikada çalışır durumda
    Mühendislik Gerçekliği

    E-posta Senkronizasyonunun Ölçeklendikçe Gizlenen Karmaşıklığı

    Onay-kavramı e-posta senkronizasyon API'si oluşturmak bir hafta sonu sürer. Üretimde 1.000 bağlı hesapla güvenilir bir tane oluşturmak ise aylar alır. İşte size kimsenin önceden söylemediği şeyler.

    Oran Limiti Yönetimi

    Gmail kullanıcı başına kota (250 kota birimi/saniye) ve proje başına günlük limitler uygular. Microsoft Graph, uygulamaya göre 10 dakikada 10.000 istekte kısıtlama uygular. Tarifeli olarak senkronize edilen 500 bağlı hesapla, üssel geri çekilme, titreşim ve hesap başına kuyruk izolasyonu olan dağıtılmış bir hız sınırlayıcıya ihtiyacınız vardır. Tek bir hesaptan yapılan bir ani yüklenme, diğer tüm hesapların kotalarını tüketebilir.

    Ölçekte Jeton Yenileme

    Her bağlantılı hesabın geçerlilik süresi dolan bir erişim jetonu vardır. 1.000 hesapta, yoğun senkronizasyon pencereleri sırasında düzinelerce eşzamanlı jeton yenilemesi beklenebilir. Tek bir başarısız yenileme, senkronizasyon döngülerinin atlanmasına neden olur. Yenileme jetonlarının geçerlilik süresi dolduğunda kullanıcıları yeniden yetkilendirmeye yönlendirmek için yeniden deneme mantığına, iptal algılamaya ve uyarı hattına sahip özel bir jeton yaşam döngüsü hizmetine ihtiyacınız vardır.

    Klasör ve Etiket Karmaşıklığı

    Gmail etiketleri kullanır (bir ileti aynı anda birden fazla etikete sahip olabilir). Outlook klasörleri kullanır (hiyerarşik, taşıma işlemleriyle). IMAP klasörleri de kullanır ancak isim alanları sunucu satıcısına göre değişir. Bunları uygulamanız için tutarlı bir klasör modeline normalleştirmek, satıcıya özgü eşleme mantığı gerektirir. Uç durumlar arasında paylaşılan posta kutuları, yetkilendirilmiş erişim ve Gmail'in "Tüm Postalar" ile "Gelen Kutusu" arasındaki ayrımı yer alır.

    Ek Dosya Saklama ve Akış

    E-posta ekleri büyük olabilir. Binlerce hesabın her biri için senkronize edilen e-postaların eklerini getirmek ve depolamak, hem bant genişliği hem de depolama maliyetleri açısından hızla artar. Yalnızca isteğe bağlı olarak ekleri indiren, yinelenen depolama sağlayan ve bunları ürününüzden sunmak için bir CDN katmanı kullanan bir akış hattına ihtiyacınız var. MIME ayrıştırmanın kendisi hatalara neden olur - çok parçalı e-postalar,quoted-printable kodlaması ve satır içi ekler her biri özel işlem gerektirir.

    İplik Yeniden Yapılandırma

    Gmail konuşmaları tarafından threadId - sunucu taraflı bir kavramdır. IMAP'in yerel iş parçacığı yoktur; iş parçacıklarını yeniden oluşturmak için Referanslar ve Yanıt-Kime başlıklar (RFC 5322). Outlook'un Sohbet Kimliği. Sağlayıcılar arası başlıkların normalleştirilmesi - özellikle sağlayıcılar arası yanıtlarda - konu normalleştirmesi ve mesaj kimliği zincirlerine dayalı yedekleme sezgisel yöntemleri gerektirir.

    Webhook Güvenilirliği ve Yeniden Teslimat

    Gmail Pub/Sub bildirimleri garanti edilmez; kesinti sırasında kaçırılan mesajlar yeniden gönderilmez. Microsoft Graph webhook abonelikleri sona erer ve yenilenmesi gerekir. Bir anlık ileti bildirimi sırasında webhook alıcınız çevrimdışı olursa, olayı kaçırırsınız ve yoklama yöntemine geri dönersiniz. Üretim düzeyinde bir e-posta senkronizasyon API'si, webhook kullanılabilirliğinden bağımsız olarak delta senkronizasyon imleciyle kaçırılan olayları periyodik olarak yakalayan bir uzlaştırma döngüsüne ihtiyaç duyar.

    Mimari Karşılaştırması

    3 E-posta Senkronizasyon Mimarisi Karşılaştırması

    E-posta senkronizasyon özellikleri oluşturan ekipler genellikle üç uygulama modelini değerlendirir. İşte her birinin yapım çabasından devam eden bakım maliyetine kadar dürüst bir karşılaştırması.

    Kendin Yap
    Doğrudan Sağlayıcı Entegrasyonu
    Gmail API + Microsoft Graph + IMAP - ayrı ayrı
    Yapım süresi 3-6 ay
    Sağlananlar kapsamı 1 sprint başına
    OAuth / belirteç yönetimi 3x kod tabanı
    Webhook işleme 3 farklı sistem
    Devam eden bakım Yüksek (API değişiklikleri)
    Maliyet modeli Mühendislik zamanı
    En iyi: Altyapıya 6 aydan fazla yatırım yapmaya hazır ve tam kontrol isteyen ekipler için.
    Kendi Kendine Barındırılan
    Kendi Kendine Barındırılan IMAP Katmanı
    Kendi posta proxy'nizi çalıştırın (Dovecot / Cyrus / özel)
    Yapım süresi 2-4 ay
    Sağlananlar kapsamı Yalnızca IMAP (genel)
    OAuth / belirteç yönetimi Yalnızca IMAP kimlik bilgileri
    Webhook işleme IDLE tabanlı, özel
    Devam eden bakım Orta
    Maliyet modeli Altyapı + mühendislik
    En iyi]: Kullanıcıları özel olarak IMAP uyumlu sunucularda olan ve Google veya Microsoft OAuth gerektirmeyen ekipler için.
    Tavsiye edilir
    Birleşik E-posta Senkronizasyon API'si
    Unipile - Gmail, Outlook ve IMAP için tek API
    Yapım süresi 1-3 gün
    Sağlananlar kapsamı Gmail + Outlook + IMAP
    OAuth / belirteç yönetimi Unipile Tarafından İşlem Yapıldı
    Webhook işleme Birleşik olay modeli
    Devam eden bakım Düşük
    Maliyet modeli Bağlı hesap başına
    En iyi olduğu alanlar: E-posta senkronizasyonunu hızlı bir şekilde kullanıma sunmak isteyen ve sağlayıcıya özel altyapı yönetmek istemeyen SaaS ekipleri.
    Hızlı Başlangıç

    Unipile'ın Birleşik E-posta Senkronizasyon API'si ile E-postaları Senkronize Edin

    Unipile'ın e-posta senkronizasyon API'si, Gmail, Outlook ve IMAP'ı tek bir birleşik arabirim üzerinden kapsar. OAuth akışları, jeton yenileme, delta senkronizasyonu ve webhook teslimatı sizin için yönetilir; ekibiniz altyapıyı değil, özelliği kullanıma sunar.

    1
    Bir Unipile hesabı oluştur

    Kaydol dashboard.unipile.com. Ücretsiz e-posta API katmanı, kredi kartı gerektirmeden tüm sağlayıcılara erişim imkanı sunar. DSN'inizi (Veri Kaynağı Adı) ve API belirtecinizi hemen alırsınız.

    2
    Bir kullanıcının e-posta hesabını bağlayın

    Gmail veya Outlook hesabınıza erişim yetkisi vermek için Unipile'ın barındırdığı OAuth akışını kullanın. IMAP için kimlik bilgilerini toplayın ve şunlara iletin POST /hesaplar. Unipile, OAuth yönlendirmesini, belirteç değişimini ele alır ve yenileme belirtecini güvenli bir şekilde saklar.

    3
    Senkronize edilmiş e-postaları listele

    Ara GET /emails ile account_id bağlı hesabın. Unipile, Gmail'in delta senkronizasyonunu çalıştırır. tarih.liste, Microsoft Graph'ın delta uç noktası veya IMAP'in GÜNÜNMAĞAZASI - her zaman sağlayıcıdan bağımsız olarak aynı normalleştirilmiş JSON yanıtını alırsınız.

    4
    Gerçek zamanlı senkronizasyon için bir webhook kaydedin

    E-postanız Unipile'ın webhook API'sine uç nokta URL'nizi gönderin. Birleştirilmiş herhangi bir hesapta (Gmail, Outlook veya IMAP) yeni bir e-posta geldiğinde Unipile, normalleştirilmiş bir e-posta.yeni URL'nize olay. Publication/Subscription kurulumu yok, Grafik abonelik yenileme yok, BOŞTA bağlantı yönetimi yok. Aşağıdakileri görün e-posta API kılavuzu tam etkinlik referansı için.

    5
    Tüm e-posta içeriğini ve eklerini oku

    Ara GET /e-postalar/{id} tam ileti gövdesini (HTML ve düz metin), başlıkları, MIME parçalarını ve ek başvurularını almak için. Ekler imzalı URL'ler aracılığıyla sunulur - ham MIME verilerini kendiniz saklamak zorunda kalmazsınız. Bkz E-postaları programlı olarak oku örnekler için.

    unipile-email-sync.js
    const axios = require('axios'); const DSN = process.env.UNIPILE_DSN; const TOKEN = process.env.UNIPILE_TOKEN; const api = axios.create({ temelURL: `https://${DSN}/api/v1`, headers: { 'X-API-ANAHTARI': TOKEN } }); // Adım 3 - Senkronize edilmiş e-postaları listele async function E-postaları listele(hesapKimliği) { const { veri } = bekliyor api.olsun('/e-postalar', { params: { account_id: accountKimliği, Klasör: 'GELEN KUTUSU', Limit: 20 } }); return data.öğeler; } // Adım 4 - Web kancası kaydı async function webhook kaydetme() { bekliyor api.POST('/webhooks', { url 'https://yourapp.com/api/email-olayları', etkinlikler: ['e-posta.yeni', 'eğitim.güncellendi'] }); } // Adım 5 - Tam e-posta içeriğini al async function E-postayıAl(emailKimliği) { const { veri } = bekliyor api.olsun(`/emails/${emailId}`); return veri; }
    Gmail, Outlook ve IMAP ile çalışır - aynı kod
    Unipile E-posta Senkronizasyon API'si

    Her sağlayıcı için aynı e-posta senkronizasyon hattını yeniden oluşturmayı bırakın.

    Gmail, Outlook ve IMAP'i tek bir e-posta senkronizasyon API'si aracılığıyla bağlayın. Gerçek zamanlı webhook'lar, delta senkronizasyonu ve OAuth token yönetimi - hepsi halledildi. Ekibiniz ürününüze odaklanır, altyapıya değil.

    Ücretsiz başlayın Kredi kartı gerekmez Ücretsiz e-posta API katmanini görün
    Unipile - Gerçek Zamanlı E-posta Senkronizasyon Karşılaştırması
    Gerçek Zamanlı Opsiyonlar

    Gerçek Zamanlı E-posta Senkronizasyonu: Webhook'lar vs Yoklama vs IMAP IDLE

    E-posta senkronizasyon API'niz için yanlış gerçek zamanlı mekanizmayı seçmek gecikmeye neden olur, kotayı tüketir veya uygulama çökmeleri sırasında kör bırakır. Üç yaklaşımın doğrudan bir karşılaştırması aşağıdadır.

    Yaklaşım Nasıl çalışır Gecikme En iyisi Karmaşıklık
    Web kancaları (push) Sağlayıcı, bir posta kutusu değiştiğinde uç noktanıza HTTP POST gönderir. Gmail Pub/Sub kullanır; Microsoft Graph değişiklik bildirimlerini kullanır. 5 yaş altı Gmail, Outlook, Unipile gibi birleşik API'lar Orta abonelik yönetimi gerekli
    Anket (planlanmış) Çalışanın sağlayıcı API'sinizi zamanlanmış olarak (30 saniyede bir, 1 dakikada bir, 5 dakikada bir) arar ve bir delta imleci kullanarak değişiklikleri getirir. 30'lar-5dk Tüm sağlayıcılar, basit kurulumlar Düşük - ancak büyük ölçekte kota gerektiren
    IMAP IDLE (uzun yoklama) Müşteriniz sunucuya IDLE komutu gönderir; sunucu yeni e-posta geldiğinde EXISTS bildirimleri gönderir. Bağlantı 29 dakikaya kadar açık tutulur. 1 yaş altı Yalnızca IMAP sunucuları Yüksek - posta kutusu başına bir TCP bağlantısı
    Web kancaları (push)
    Nasıl çalışır Sağlayıcı, bir posta kutusu değiştiğinde uç noktanıza HTTP POST gönderir. Gmail Pub/Sub kullanır; Microsoft Graph değişiklik bildirimlerini kullanır.
    Gecikme 5 yaş altı
    En iyisi Gmail, Outlook, Unipile gibi birleşik API'lar
    Karmaşıklık Ortaabonelik yönetimi gerekli
    Anket (planlanmış)
    Nasıl çalışır Çalışanın sağlayıcı API'sinizi zamanlanmış olarak (30 saniyede bir, 1 dakikada bir, 5 dakikada bir) arar ve bir delta imleci kullanarak değişiklikleri getirir.
    Gecikme 30'lar-5dk
    En iyisi Tüm sağlayıcılar, basit kurulumlar
    Karmaşıklık Düşükama ölçekte kota yoğun
    IMAP IDLE (uzun yoklama)
    Nasıl çalışır Müşteriniz sunucuya IDLE komutu gönderir; sunucu yeni e-posta geldiğinde EXISTS bildirimleri gönderir. Bağlantı 29 dakikaya kadar açık tutulur.
    Gecikme 1 yaş altı
    En iyisi Yalnızca IMAP sunucuları
    Karmaşıklık Yüksekposta kutusu başına bir TCP bağlantısı

    Üretim tavsiyesi: Webhook'ları birincil gerçek zamanlı mekanizman olarak kullan ve kesintiler sırasında kaçırılan olayları yakalamak için bir delta-sync yoklama yedeklemesi (her 5 dakikada bir) çalıştır. Unipile'ın e-posta eşitleme API'si ile her ikisi de tek seferde yapılandırılır - birleşik e-posta.yeni webhook, hesap Gmail, Outlook veya IMAP olsa da tetiklenir ve bir arka plan uzlaştırma döngüsü kaçırılan olayları otomatik olarak halleder.

    Güvenlik ve Uyumluluk

    E-posta Senkronizasyon API'leri için Güvenlik ve Uyumluluk

    Kullanıcı gelen kutularına erişim, önemli güvenlik ve yasal yükümlülükler doğurur. E-posta senkronizasyon API uygulamanızın üretime geçmeden önce ele alması gerekenler şunlardır:.

    OAuth Kapsamları - En Az Yetki

    Uygulamanızın ihtiyaç duyduğu kapsamları isteyin. Salt okunur e-posta senkronizasyonu için gmail.yalnızcaoku yerine gmail.değiştir. Microsoft Graph için, istek Mail.Read yerine Mail.ReadWrite. Google'ın CASA doğrulaması (100'den fazla kullanıcıya sahip uygulamalar için gereklidir) istediğiniz kapsamları yakından inceler - aşırı kapsam onayı geciktirir.

    Belirteç Depolama - Yedeklemede Şifreleme

    OAuth yenileme jetonları, tam posta kutusu erişimi sağlayan uzun ömürlü kimlik bilgileridir. Depolanırken şifrelenmeli (minimum AES-256) ve asla günlüğe kaydedilmemelidir. Jeton şifreleme anahtarlarınızı periyodik olarak döndürün. Bir yenileme jetonunun tehlikeye atılması, bağlı e-posta hesabı için bir şifre tehlikesiyle eşdeğerdir.

    GDPR ve Veri Yerleşimi

    AB kullanıcılarından senkronize edilen e-posta içeriği GDPR kapsamında kişisel veridir. İşleme için yasal bir dayanağa (genellikle OAuth yoluyla kullanıcının açık rızası), e-posta senkronizasyon API sağlayıcınızla bir veri işleme sözleşmesine ve net bir veri saklama politikasına ihtiyacınız vardır. Altyapınız ABD merkezliyse, AB verileri için SCC'lere veya eşdeğer bir transfer mekanizmasına sahip olduğunuzdan emin olun.

    Google CASA Doğrulaması

    100'den fazla kullanıcısı olan Gmail OAuth kapsamlarını kullanan herhangi bir uygulama, Google'ın CASA (Bulut Uygulama Güvenliği Değerlendirmesi). Bu, uygulamanızın kodunu, altyapısını ve OAuth kapsamı gerekçesini içeren bir güvenlik incelemesidir. Süreç 4-8 hafta sürer. Erken başlayın - CASA'dan başarısız olmak, geçene kadar tüm kullanıcılar için Gmail erişimini kaybetmek anlamına gelir.

    Webhook İmza Doğrulaması

    E-posta senkronizasyon API'nizden gelen webhook yüklerinin imzasını her zaman doğrulayın. İmzasız veya usulüne uygun doğrulanmamış bir webhook, uygulamanıza sahte e-posta olayları enjekte etmek için taklit edilebilir. Unipile, tüm webhook teslimatlarını HMAC-SHA256 ile imzalar. X-Unipile-İmza Herhangi bir olayı işlemden önce başlık.

    Denetim Kayıtları

    Uygulamanızın senkronize e-posta verileri üzerinde gerçekleştirdiği her eylemi günlüğe kaydedin: kimlerin hangi mesajlara eriştiği, ne zaman ve bu verilerle ne yapıldığı. Denetim günlükleri, SOC 2 Tip II uyumluluğu için gereklidir ve genellikle kurumsal müşterilerin güvenlik incelemeleri sırasında ilk sordukları şeydir. Günlükleri en az 90 gün, ideal olarak 1 yıl boyunca saklayın.

    Yaygın Tuzaklar

    E-posta Senkronizasyon API'si Oluştururken Sık Yapılan Hatalar

    E-posta senkronizasyonu API uygulamalarındaki en sık gördüğümüz hatalar ve mimari yanlışlıklar bunlardır. Hepsi, en başta doğru tasarım seçimleriyle önlenebilir.

    1
    Token yenileme hatalarını zarif bir şekilde ele almama

    Yenileme jetonu süresi dolduğunda veya iptal edildiğinde, basit bir uygulama senkronizasyon işlemini sessizce hatayla durdurur. Kullanıcı, güncel olmayan verileri fark edene kadar gelen kutusunun senkronize olmayı bıraktığını bilmez. Düzelt: Uygulamada iptal algılama katmanı oluşturalım geçersiz_hibe hata verir, bağlantılı hesabı yeniden yetkilendirme gerektirdiğini işaretler ve ürününüzün bildirim sistemi aracılığıyla kullanıcıyı bilgilendirir.

    2
    Çok agresif sorgulama ve hız sınırlarına ulaşma

    Her 10 saniyede bir 200 bağlı hesap arasında yoklama yapmak, projeye özel Gmail kotasını saatler içinde tüketir. Microsoft Graph geri dönmeye başlıyor 429 Çok Fazla Talep. Sonuç, sadece engellenmeyi tetikleyen hesaplar için değil, tüm hesaplar için sessiz senkronizasyon hatalarıdır. Düzelt: birincil mekanizma olarak webhook'ları kullanın, 5 dakikalık yoklama ile yedekleyin ve tüm işlemlerde hesap başına hız sınırlaması uygulayın, üstel geri çekilme ile 429 Yanıtlar.

    3
    AyarBırakılsın

    Ham MIME büyük, sorgulaması zor ve okurken ayrıştırılması maliyetlidir. Ekleri olan tek bir e-posta yüzlerce kilobayt olabilir. Düzelt: Verilerin alınması sırasında MIME'yi ayrıştırın: HTML gövdesini, yedek düz metni, başlıkları ve ek metavertiklerini ayrı ayrı çıkarın. Ek dosyalarını ana veritabanınızda değil, nesne depolama alanında (S3 veya benzeri) saklayın. Bu önlem tek başına, tipik kurumsal posta kutuları için depolama maliyetlerinizi -80 oranında azaltır.

    4
    Sağlayıcılar arası e-posta iş parçacığı eksikliği

    Gmail'in threadId Yalnızca Gmail içinde çalışır. Uygulamanız bir Gmail hesabı ve bir Outlook hesabı arasında uzanan bir ileti dizisi gösterirse (örneğin, farklı bir posta kutusundan gönderilen bir yanıt), yerel iş parçacığı kimlikleri işe yaramaz. Düzelt: çapraz sağlayıcı bir iş parçacığı motoru oluşturun Mesaj Kimliği, Yanıt-Kimeve Referanslar başlıklar. Bu üstbilgilerin eksik olduğu e-postalar için yedek olarak konu satırlarını normalleştirin (Re:/Fwd: öneklerini kaldırın).

    5
    Yeniden başlatmada senkronizasyon imlecini kaybetme

    Delta sync, kaydedilmiş bir işaretleyiciye dayanır: Gmail'in tarihKimliği, Microsoft Graph'in deltaBağlantı, IMAP MODSEQ. Senkronizasyon işçiniz yeniden başlatılırsa ve imleç yalnızca bellekte saklanıyorsa, değişiklik akışındaki konumunuzu kaybedersiniz. Bir sonraki senkronizasyon sıfırdan başlar, tüm geçmiş mesajları yineler veya boşlukları atlar. Düzelt: Veritabanınıza imleci her başarılı senkronizasyon devrinden sonra, işlenmiş değişikliklerin son grubuna atomik olarak kalıcı hale getirin.

    6
    Gönderilen ve alınan e-postalar arasındaki ayrımı göz ardı ederek

    E-posta kullanımı için tam bir iletişim zaman çizelgesi oluşturmak amacıyla hem gelen (alınan) hem de giden (gönderilen) e-postalara ihtiyacınız vardır. Gmail'in INBOX etiketi yalnızca alınan postaları kapsar; ayrıca şunlara da ihtiyaç duyarsınız GÖNDERİLDİ. Microsoft Graph, sorgulama gerektirir Gönderilmiş Öğeler klasörü ayrı ayrı. IMAP seçmeyi gerektirir Gönderildi klasörü açıkça. Düzelt: Hesap kurulumunda yalnızca GELEN KUTUSU değil, ilgili tüm klasörleri senkronize edin ve sağlayıcıya özgü klasör adlarını veri modelinizde normalleştirilmiş türlere eşleyin.

    SSS

    E-posta Senkronizasyon API'leri Hakkında Sıkça Sorulan Sorular

    Bir geliştirici ilk kez e-posta senkronizasyon API'sini uygularken en sık sorduğu sorular.

    1
    E-posta senkronizasyon API'si nedir?
    +
    Bir e-posta senkronizasyon API'si e-postalarınızı uygulamanıza sürekli olarak yansıtan programatik bir arayüzdür. Gelen ve giden iletileri okur, durum değişikliklerini (okundu/okunmamış, klasör taşıma, silme) izler ve yeni e-postalar geldiğinde webhook'lar aracılığıyla gerçek zamanlı bildirimler sağlar. İşlemsel bir e-posta API'sının (sistem e-postaları gönderen) aksine, bir e-posta eşitleme API'si, kullanıcının OAuth aracılığıyla mevcut gelen kutusuna erişim yetkisi vermesini gerektirir.
    2
    E-posta senkronizasyon API'si ile işlemsel e-posta API'si arasındaki fark nedir?
    +
    Bir e-posta senkronizasyon API'si, OAuth kullanarak kullanıcının mevcut posta kutusunu (Gmail, Outlook, IMAP) uygulamanıza okur ve yansıtır. İşlemsel bir e-posta API'si (SendGrid veya Mailgun gibi), API anahtarı kullanarak kendi alan adınızdan sistem tarafından oluşturulan e-postalar gönderir ve kullanıcı gelen kutusuna erişmez. Bunlar zıt amaçlara hizmet eder ve tamamen farklı pazarları hedefler. Unipile, e-posta senkronizasyonu kategorisindedir - işlemsel bir gönderici değildir.
    3
    Unipile'ın e-posta senkronizasyon API'ı hangi e-posta sağlayıcılarını destekliyor?
    +
    Unipile'in e-posta senkronizasyon API'si üç sağlayıcıyı destekler: Gmail (Google), Outlook / Microsoft 365 (Microsoft Graph - hem kişisel Outlook hem de kurumsal M365 / Exchange Online'ı kapsar), ve IMAP (kurumsal Exchange, ProtonMail, Zoho, Fastmail ve özel alan adları dahil olmak üzere herhangi bir posta sunucusunu kapsar). Her üçüne de aynı birleşik API uç noktası aracılığıyla erişilebilir.
    4
    E-posta senkronizasyon API'sında delta eşitleme nasıl çalışır?
    +
    Delta senkronizasyonu, her yoklamada tüm iletileri yeniden getirmek yerine, postanın değişiklik akışındaki son bilinen konumdan bu yana yapılan değişiklikleri almak anlamına gelir. Gmail kullanır tarihKimliği imleç ile kullanıcıların.geçmişi.listesi uç noktası. Microsoft Graph kullanır bir deltaBağlantı tarafından döndürülen /mesajlar/delta endpoint. IMAP kullanır MODSEQ CONDSTORE uzantısından gelen değer. Birleşik bir e-posta senkronizasyon API'si, bu üç farklı mekanizmayı tek bir tutarlı arayüzün arkasında normalleştirir.
    5
    E-posta senkronizasyonu için yoklama (polling) ile webhook'lar arasındaki fark nedir?
    +
    Polling, işçinizin yeni mesajları kontrol etmek için belirli bir zaman aralığında (her 30 saniyede bir, 1 dakikada bir vb.) e-posta API'sini aramasını ifade eder. Web kancaları (webhooks) ise itme tabanlıdır: sağlayıcı (veya birleşik API), yeni bir e-posta geldiğinde hemen uç noktanıza bir HTTP POST gönderir. Web kancaları, anlık (5 saniyenin altında gecikmeyle) senkronizasyon sağlarken, polling aralığınız kadar bir gecikme getirir. Üretim ortamında en iyi desen, birincil olarak web kancaları ve kaçırılan olaylar için bir yedek olarak delta-senkronizasyon polling kullanmaktır.
    6
    Unipile ile e-posta senkronizasyonunu ayarlamak ne kadar sürer?
    +
    Çoğu geliştirici bir çalışma e-posta senkronizasyonu tek bir gün içinde çalışan entegrasyon. Ana adımlar şunlardır: bir Unipile hesabı oluşturun (ücretsiz, kredi kartı gerekmez), kullanıcının Gmail veya Outlook hesabını bağlamasına izin vermek için barındırılan OAuth akışını kullanın, çağırın GET /emails ile account_id senkronize edilmiş mesajları almak ve gerçek zamanlı bildirimler için bir webhook uç noktası kaydetmek e-posta.yeni Olaylar. Unipile, OAuth, jeton yenileme, delta senkronizasyonu ve webhook teslimini otomatik olarak yönetir.
    7
    E-posta senkronizasyonu için hangi OAuth kapsamlarına ihtiyacım var?
    +
    Gmail salt okunur eşitleme için istek gmail.yalnızcaoku. Mesajları okundu olarak işaretlemeniz veya taşımanız gerekiyorsa, lütfen gmail.değiştir. Microsoft Graph için, istek Mail.Read salt okunur erişim veya Mail.ReadWrite Tam erişim için. Uygulamanızın aslında ihtiyaç duyduğu minimum kapsamı her zaman isteyin - Google'ın CASA doğrulaması (100'den fazla kullanıcıya sahip uygulamalar için gereklidir) kapsam gerekçesini yakından inceler ve aşırı kapsam onayınızı geciktirebilir.
    8
    Ücretsiz bir e-posta senkronizasyon API katmanı mevcut mu?
    +
    Evet. Unipile sunuyor bir ücretsiz e-posta API katmanı kredi kartına gerek kalmadan üç sağlayıcıya (Gmail, Outlook, IMAP) da erişim sağlar. Ücretsiz katman, küçük sayıda bağlı hesapla geliştirme, test etme ve erken üretim için uygundur. Mevcut limitler için Unipile fiyatlandırma sayfasına veya ücretsiz e-posta API belgelerine bakın.
    9
    E-posta senkronizasyon API'nizde süresi dolmuş OAuth belirteçlerini nasıl ele alırım?
    +
    Erişim jetonları süresi dolar (genellikle hem Google hem de Microsoft için 1 saattir). Senkronizasyon altyapınız algılamalıdır 401 Yetkisiz yanıtlar, yeni bir erişim belirteci almak için saklanan yenileme belirtecini kullanır ve başarısız olan isteği şeffaf bir şekilde yeniden dener. Yenileme belirteçleri de iptal edilebilir. İptal algılandığındageçersiz_hibe hata), hesabı yeniden yetkilendirme gerektiği şeklinde işaretleyin ve kullanıcıyı bilgilendirin. Unipile, bağlı hesaplar için tüm token yaşam döngüsü yönetimini otomatik olarak halleder.
    10
    IMAP IDLE, e-posta hesabınızda bir değişiklik (yeni e-posta, okundu olarak işaretlenme vb.) olduğunda sunucunun istemciye bildirim göndermesini sağlayan bir IMAP komutudur. Bu, istemcinin sunucuyu sürekli sorgulaması gerekmediği için daha verimli bir yöntemdir ve bu sayede e-postalarınız neredeyse gerçek zamanlı olarak eşitlenir.
    +
    IMAP IDLE (RFC 2177), bir IMAP oturumunu anlık bildirim moduna sokan bir komuttur: istemcinizin tekrar tekrar yoklama yapması yerine, sunucu istenmeyen VARDIR Yeni mesajlar geldiğinde bildirimler alır. Bu, sürekli yoklama yapmadan neredeyse gerçek zamanlı gelen kutusu senkronizasyonuna (1 saniyeden az gecikme) olanak tanır. IDLE bağlantıları, sunucu zaman aşımlarını önlemek için her 29 dakikada bir yenilenmelidir. IDLE, kurumsal Exchange, IMAP aracılığıyla Gmail ve IMAP aracılığıyla Outlook dahil olmak üzere çoğu modern posta sunucusu gibi onu destekleyen herhangi bir IMAP sunucusuyla çalışır.
    tr_TRTR
    en_USEN fr_FRFR es_ESES de_DEDE it_ITIT pt_BRBR nl_NLNL pl_PLPL tr_TRTR