Başla

Kullanıcı Adına E-posta Gönder API

E-posta API'si

E-posta API'sinde "Send on Behalf" Ne Anlama Geliyor?

Bir kullanıcı adına e-posta göndermek, uygulamanızın iletileri paylaşılan işlemsel bir göndericiden değil, kullanıcının kendi posta kutusundan göndermesi anlamına gelir. Alıcı, "Kimden" alanında kullanıcının gerçek e-posta adresini görür. Bu, kullanıcıları için e-posta yöneten herhangi bir SaaS ürününün temelini oluşturur.

Neler öğreneceksiniz

OAuth 2.0 hibeleri izne nasıl gönderilir
Gmail, Outlook ve IMAP desteği
Hisse senedi bazlı vs. işlem bazlı e-posta API'leri
Unipile birleşik API'si aracılığıyla gönderme
CRM, yapay zeka asistanı ve destek kullanım senaryoları
Yasal uyumluluk ve kullanıcı izinleri
Unipile E-posta API'sini deneyin Belgeleri oku
Kullanıcının posta kutusundan gönderildi Gerçek "Kimden" adresi
Unipile E-posta API
Adına Gönder POSTA
POSTA /api/v1/emails
200 TAMAM
GET /api/v1/emailler/{id}
200 TAMAM
GET /api/v1/hesaplar/{id}
200 TAMAM
JSON yükü
{ "hesap_kimliği": "kullanıcı_abc123", "için": [{ "tanımlayıcı": "prospect@acme.com" }], "konu": "Takipteyim", "vücut": "Merhaba Sarah..." }
OAuth 2.0 ile güvence altına alınmış Kullanıcı izin veriyor
E-posta entegrasyonu mu kuruyorsunuz?

Oku bizim E-posta API'si Kılavuzu - OAuth akışları, senkronizasyon, gönderme ve sağlayıcı karşılaştırması.

SaaS Ürünlerinin Sizin Adınıza E-posta Göndermeye Neden İhtiyaç Duyduğu

E-posta ile ilgili çoğu SaaS ürünü eninde sonunda aynı gereksinimle karşılaşır: kullanıcı, mesajların platformun genel alan adı yerine kendi adresinden gelmesini ister. İster bir CRM, ister bir yapay zeka yazma asistanı, isterse bir destek aracı olsun, ürününüz kullanıcılar için e-posta göndermeye başladığı an, sizin adınıza gönderim ihtiyacınız olur. Neden önemli olduğu ve üç ana kullanım örneğinin API'ye nasıl eşlendiği aşağıdadır.

CRM Kullanım Örneği

Satış temsilcileri gerçek Gmail veya Outlook hesaplarından gönderim yaparlar.

Bir CRM bağlamında, satış elemanı ilişkiyi kuran kişidir. Platformunuz, aşağıdaki durumlarda takip gönderiyorsa noreply@yourcrm.com, teslim edilebilirlik düşer ve potansiyel müşteri kafası karışır. Vekaleten gönderme ile CRM'iniz, satış temsilcisinin bağlantılı hesabını kullanarak Unipile API'sini çağırır. Her e-posta, temsilcinin gerçek adresi gösterilerek potansiyel müşterinin gelen kutusuna ulaşır.

E-posta dizileri, geçmişi tek bir yerde tutarak temsilcinin gönderilenler klasöründe kalır
Yanıtlar, doğal konuşma sürekliliği için temsilcinin gelen kutusuna düşer
Gönderici itibarı, paylaşılan bir platform alan adına değil, temsilcinin alan adına bağlıdır
Yapay Zeka Asistanı Kullanım Alanı

YZ, kullanıcının posta kutusundan taslak hazırlar ve gönderir

E-posta asistanı yapay zekalar - ister otomatik olarak yanıt taslağı oluştursunlar, ister takip e-postaları planlasınlar, isterse de konuları özetlesinler - kullanıcının posta kutusuna yazma erişimine ihtiyaç duyarlar. "On-behalf" gönderme özelliği olmadan, yapay zeka yalnızca öneride bulunabilir; uygulayamaz. Unipile API aracılığıyla bağlantılı bir hesapla, asistanınız onaylanan mesajı tek bir API çağrısıyla doğrudan kullanıcının Gmail veya Outlook'undan gönderebilir.

Taslak onaylandı: tek bir API çağrısı, onu kullanıcının gerçek adresinden gönderir
Kullanıcı Gmail, Outlook veya istenen herhangi bir IMAP sağlayıcısını çalıştırsa da çalışır
Konuşmaları geçerli kılmak için reply_to parametresi aracılığıyla iş parçacığını destekler
Destek Aracı Kullanım Örneği

Destek temsilcileri ortak bir destek gelen kutusundan yanıt verir

Müşteri destek platformları genellikle biletleri şunlar gibi paylaşılan bir gelen kutusundan yönlendirir support@company.com. Bu gelen kutusu kendi içinde bir posta kutusudur - bir hesap olarak bağlanması gerekir. Unipile ile platformunuz, bu paylaşılan Outlook veya IMAP posta kutusunu bağlayarak, herhangi bir temsilcinin resmi destek adresinden doğrudan geliyormuş gibi görünen yanıtlar göndermesine olanak tanır ve tam ileti dizisi bağlamı korunur.

Paylaşılan gelen kutusu bir kez bağlandı, tüm yetkili temsilciler tarafından erişilebilir
Yanıtlar her zaman Gönderen alanında doğru şirket alanını gösterir
Ekler, CC ve BCC'nin tümü aynı birleşik uç nokta aracılığıyla desteklenir
Daha iyi teslim edilebilirlik
Kullanıcının kendi alan adından gönderilen e-postalar, paylaşılan bir gönderene değil, hesabıyla ilişkilendirilen SPF ve DKIM kontrollerinden geçer.
OAuth ile Güvenli Erişim
Kullanıcılar, sağlayıcılarının OAuth akışı aracılığıyla izin verir. Şifre saklanmaz, herhangi bir zamanda tamamen geri alınabilir.
Tek birleşik API
Aynı POST /api/v1/emails uç nokta Gmail, Outlook ve IMAP hesaplarını yönetir.
Daha hızlı pazara sunma süresi
Gmail, Outlook ve IMAP için ayrı entegrasyonlar oluşturmayı atlayın. Unipile her üçünü de tek bir arayüzün arkasında standartlaştırır.
Kilit nokta: kullanıcılarınızın zaten güvendiği e-posta adresleri var. Adına gönderme, SaaS'ınızın kimseyi farklı bir sağlayıcıya geçmeye veya yeni bir gelen kutusu oluşturmaya zorlamadan bu güveni kullanmasına olanak tanır. E-posta API'lerinin nasıl çalıştığına dair daha geniş bir resim için, E-posta API rehberi.
Ücretsiz olarak oluşturmaya başlayın

On-Behalf E-posta API'si Nasıl Çalışır (OAuth 2.0 Akışı)

Bir kullanıcı adına e-posta göndermek üç şey gerektirir: kullanıcının onayı, geçerli bir erişim belirteci ve sağlayıcının altyapısı üzerinden bir gönderme çağrısı. Akışın pratikte nasıl çalıştığı ve Unipile'ın bunu tek bir birleşik API'ye nasıl soyutladığı aşağıdadır. Gönderme uç noktaları, parametreler ve sağlayıcı farklılıkları hakkında daha geniş bir teknik referans için lütfen eksiksiz belgelerimize bakınız. e-posta gönderme API kılavuzu.

1

Kullanıcı OAuth izni verdi

Kullanıcı, SaaS ürününüzde "E-postanızı bağlayın" düğmesine tıklar. Unipile, onları sağlayıcının OAuth onay ekranına yönlendirir - Gmail kullanıcıları için Google, Outlook ve Microsoft 365 kullanıcıları için Microsoft. Kullanıcı oturum açar ve kendi adlarına e-posta gönderme yeteneğini de içeren istenen kapsamları onaylar. Şifreniz hiçbir zaman uygulamanızla paylaşılmaz.

IMAP sağlayıcıları için kullanıcı, uygulama özel parolasını veya IMAP kimlik bilgilerini doğrudan Unipile tarafından barındırılan bir forma girer. Unipile kimlik bilgilerini şifreli olarak saklar ve yeniden bağlantıyı otomatik olarak yönetir.
2

Uygulamanız bağlı bir hesap kimliği alır

Kullanıcı OAuth akışını tamamladığında, Unipile erişim belirtecini güvenli bir şekilde saklar ve bir account_id uygulamana. Bu, kullanıcının bağlı posta kutusu için kararlı bir tanımlayıcıdır. Bu kimliği, veritabanınızda kullanıcı kaydına karşı saklarsınız. Bu kullanıcı için sonraki tüm e-posta işlemleri bu account_id'ye başvurur - ham OAuth belirtecine asla dokunmazsınız.

Unipile, belirteç yenilemesini otomatik olarak ele alır. Bir Gmail veya Outlook belirteci süresi dolarsa, Unipile arka planda onu yeniler, böylece gönderim çağrılarınız süresi dolmuş kimlik bilgileri nedeniyle asla başarısız olmaz.
3

Sağlayıcının altyapısı üzerinden gönder

Uygulamanız bir e-posta göndermesi gerektiğinde, çağırır POST /api/v1/emails account_id ve mesaj yüküyle. Unipile isteği doğru sağlayıcı üzerinden yönlendirir: Google hesapları için Gmail API, Outlook ve Microsoft 365 hesapları için Microsoft Graph API ve IMAP hesapları için SMTP. E-posta kullanıcının kendi posta kutusundan gönderilir ve Gönderilenler klasöründe görünür.

Aynı API çağrısı sağlayıcıdan bağımsız olarak çalışır. Tek bir entegrasyon yazarsınız; Unipile bunu şeffaf bir şekilde Gmail API, Microsoft Graph veya SMTP'ye çevirir.

Kod örnekleri

Python
Node.js
Python - Kullanıcı Adına E-posta Gönder
İthalat istekleri

# hesap kimliği, kullanıcının OAuth akışını tamamlamasının ardından alındı
UNIPILE_DSN = "https://api1.unipile.com:13301"
ERİŞİM_BELİRTECİ = "ERIŞİM_TOKENINIZ"
HESAP_ KODU = "veritabanından_gelen_kullanıcı_hesabı_kimliği"

yük = {
    "hesap_kimliği"HESAP_KODU,
    "için": [{
        "gösteri_adı": "Sarah Connor",
        "tanımlayıcı":   "sarah@acme.com"
    }],
    "konu": "Konuşmamızın devamı olarak",
    "vücut":    "
Merhaba Sarah, tekrar görüşmek üzere...
 "
}

yanıt = requests.POST(
    f"{UNIPILE_DSN}/api/v1/emails",
    json=payload,
    başlıklar={"X-API-ANAHTAR": ACCESS_TOKEN}
)

print(response.json())  # {"object": "EmailSent", "email_id": "..."}
Node.js - Kullanıcı adına e-posta gönderme
// OAuth akışı tamamlandıktan sonra alınan account_id
const UNIPILE_DSN "https://api1.unipile.com:13301";
const ACCESS_TOKEN  = "ERIŞİM_TOKENINIZ";
const HESAP_KODU = "veritabanından_gelen_kullanıcı_hesabı_kimliği";

const yük = {
  account_idHESAP_KODU,
  için: [{ display_name: "Sarah Connor", tanımlayıcı: "sarah@acme.com" }],
  konu: "Konuşmamızın devamı olarak",
  vücut:    "
Merhaba Sarah, tekrar görüşmek üzere...
 "
};

const response = bekliyor fetch(`${UNIPILE_DSN}/api/v1/e-postalar`, {
  yöntem: "POST",
  başlıklar: {
    "X-API-ANAHTAR"Erişim_Anahtarı,
    "İçerik-Türü": "application/json"
  },
  vücutJSON.stringify(yük)
});

const veri = bekliyor cevap.json();
konsol.log(veri); // { nesne: "EpostaGönderildi", eposta_kimliği: "..." }

On-Behalf vs İşlemsel E-posta API'si: Temel Fark

Bu iki e-posta API kategorisi kökten farklı sorunları çözer. Bunları karıştırmak, ekiplerin bir e-posta entegrasyonu planlarken yaptığı en yaygın hatadır. İşte önemsediğiniz her boyutta karşılaştırmaları:.

Kriterler
Bana Ait (Unipile)
İşlemsel (SendGrid, vb.)
Adresinden
Kullanıcının gerçek e-posta adresi
Platformunuzun alanı
Teslim Edilebilirlik
Kullanıcının SPF/DKIM itibarı
Paylaşılan gönderme IP itibarı
Kullanıcı onayı gerekiyor
Evet - OAuth 2.0 veya IMAP kimlik bilgileri
Hayır - platform göndericiye sahip
Gönderilmiş Öğeler klasörü izleme
Kullanıcının Gönderilmişler klasöründe görünür
Hayır - ayrı gönderme altyapısı
Yanıt iş parçacığı
Yerel iş parçacığı sürekliliği
Manuel Mesaj-Kimliği geçici çözümleri
En iyisi
CRM, yapay zeka yardımcıları, destek araçları, satış otomasyonu
Şifre sıfırlamaları, makbuzlar, pazarlama kampanyaları, bildirimler
Sağlayıcı desteği
Gmail, Outlook, IMAP
Sağlayıcıdan bağımsız SMTP
Her yaklaşım ne zaman kullanılır
Her ikisi de gerektiğinde, SaaS ürünlerinin pek çoğu hem sistem e-postaları için işlemsel bir API'ye hem de kullanıcı tarafından yönlendirilen mesajlar için "adına" API'ye ihtiyaç duyar. Alıcı için gönderenin kimliğinin önemli olduğu durumlarda "adına" API'yi kullanın - satış tanıtımları, kişiselleştirilmiş takip e-postaları, destek yanıtları. Platformun gönderici olduğu durumlarda işlemsel API'yi kullanın - şifre sıfırlamaları, faturalar, sistem bildirimleri. Gmail'e özel uygulama ayrıntıları için şuraya bakın: Gmail API e-posta gönder Microsoft hesapları için, bkz. Outlook e-posta API'si rehber.

Unipile ile Vekaleten E-posta Gönderme

Unipile, Gmail, Outlook ve IMAP'i tek bir tutarlı arayüzün arkasında soyutlayan tek bir birleşik API sunar. Tek bir entegrasyon yazarsınız - Unipile, üçü için de sağlayıcıya özel OAuth akışlarını, jeton yenilemeyi, SMTP yönlendirmeyi ve hata işlemeyi halleder. İşte her sağlayıcı için mevcut olanlar.

SaaS'ınıza sizin adınıza e-posta gönderme özelliği eklemeye hazır mısınız?
Ücretsiz deneme sürümü - kredi kartı gerekmez. 30 dakikadan kısa sürede göndermeye başlayın.
E-posta API Kılavuzu'nu Oku
Desteklenen sağlayıcılar
Gmail
Google OAuth 2.0
Gmail API aracılığıyla gönder - tam iş parçacığı desteği
Google Workspace hesapları desteklenir
Ekler, CC, BCC, yanıtlama-adresi
Auto token yenileme Unipile tarafından yönetilir
Gmail API e-posta gönderme rehberi
Görünüm
Microsoft OAuth 2.0
Microsoft Graph API üzerinden gönderir
Kişisel Outlook ve Microsoft 365'i kapsar
Exchange Online Tam Desteklidir
Ekler, CC, BCC, yanıtlama-adresi
Outlook e-posta API kılavuzu
IMAP
Evrensel yedekleme
Herhangi bir IMAP uyumlu posta kutusuna SMTP üzerinden gönderir
Yahoo, Fastmail, ProtonMail (IMAP köprüsü) ve daha fazlasını kapsar
Gmail ve Outlook ile aynı birleşik API uç noktası
Kimlik bilgileri şifreli olarak saklanır, uygulamanıza asla maruz kalmaz
IMAP API kılavuzu
4 adımda nasıl başlanır
1 Bir Unipile hesabı oluştur dashboard.unipile.com adresine gidin ve DSN'nizi ve API anahtarınızı alın.
2 Barındırılan bir kimlik doğrulama bağlantısı oluştur Kullanıcınız için. Unipile, Gmail veya Outlook'a OAuth yönlendirmesini ele alır veya IMAP kimlik bilgileri formunu görüntüler.
3 hesap_kimliğini sakla Akış tamamlandıktan sonra döndürüldü. Bu, o posta kutusundaki tüm gelecek işlemler için kararlı tanımlayıcıdır.
4 POST /api/v1/emails'i çağır account_id ve mesaj yükü ile. E-posta, kullanıcının kendi posta kutusundan, sağlayıcısının altyapısı aracılığıyla gönderilir.
Bugün Vekaleten E-posta Göndermeyi Kurun API belgelerini oku

Kullanıcı Adına E-posta Gönder API - SSS

Unipile ile vekaleten e-posta gönderme hakkında sık sorulan sorular

Evet, kullanıcının açıkça izin vermesi koşuluyla. Adına e-posta gönderme, OAuth 2.0 (Gmail ve Outlook için) veya açık kimlik bilgisi paylaşımına (IMAP için) dayanır. Her iki durumda da kullanıcı, uygulamanızın kendi posta kutusundan göndermesine bilinçli olarak yetki verir. Bu, her büyük e-posta istemcisi ve üretkenlik aracı tarafından kullanılan mekanizmanın aynısıdır.

Ana uyumluluk gereksinimleri şunlardır:

  • Kullanıcı, adına bir şey göndermeden önce aktif olarak onay vermeli
  • Gizlilik politikanız, kullanıcının posta kutusuna eriştiğinizi ve oradan veri gönderdiğinizi açıklamalıdır.
  • Kullanıcı istediği zaman erişimi iptal edebilmelidir (OAuth iptali veya hesap bağlantısının kesilmesi)
  • Sağlayıcının hizmet şartlarını ihlal eden içerik (örneğin spam) göndermemelisiniz

Yasal değil birinin izni olmadan adresinden göndermek. Unipile'ın OAuth tabanlı bağlantı akışı, herhangi bir gönderme işleminden önce her zaman açık kullanıcı yetkilendirmesine sahip olmanızı sağlar.

Alıcı görür kullanıcının kendi alanı Gönderen alanında - platformunuzun alan adı değil. Bu, sizin adınıza göndermenin temel değer önerisidir. Örneğin, adresinde bir satış temsilcisinin john@acme.com Gmail hesabını bağladı, Unipile aracılığıyla CRM'niz üzerinden gönderilen her e-posta görünecek Kimden: john@acme.com.

E-posta, kullanıcının gerçek posta sağlayıcısı (Gmail API, Microsoft Graph veya SMTP) aracılığıyla gönderilir, bu da şu anlama gelir:

  • SPF kayıtları, gönderen IP adresinin kullanıcının alan adı tarafından yetkilendirilmesi nedeniyle geçerlidir
  • Sağlayıcının kullanıcının etki alanı anahtarıyla imzaladığı için DKIM imzaları geçerlidir
  • DMARC hizalaması aynı nedenlerden dolayı geçer

Bu, paylaşılan bir altyapıdan gönderdiğiniz ve alıcının platformunuzun alan adını gördüğü işlemsel bir API'den temelde farklıdır.

Gerekli kapsamlar sağlayıcıya bağlıdır. Unipile OAuth izin ekranını otomatik olarak yönetir; kullanıcılarınız standart bir Google veya Microsoft izin iletişim kutusu görür. İstendiği üzere tam kapsamlar şunlardır:

  • Gmail e-posta göndermeye izin veren Gmail API kapsamıhttps://mail.google.com/ veya daha sınırlı gmail.gönder (yalnızca gönderme erişimine ihtiyacınız varsa kapsam)
  • Outlook / Microsoft 365: Microsoft Graph Mail.Gönder kapsam, artı Mail.ReadWrite gelen kutusunu da okumanız veya senkronize etmeniz gerekiyorsa
  • IMAP: Kullanıcı IMAP ana bilgisayar adını, bağlantı noktasını, kullanıcı adını ve parolasını veya uygulama parolası (iki faktörlü kimlik doğrulama etkin hesaplar için gereklidir) sağlar

Kullanıcılar bu izinleri istedikleri zaman Google veya Microsoft hesaplarının güvenlik ayarlarından veya ürününüz içindeki bağlantılı hesabı kaldırarak geri alabilirler.

Evet. OAuth veya IMAP kimlik bilgileriyle kimliği doğrulanabilen herhangi bir posta kutusu Unipile hesabı olarak bağlanabilir. Bunlar şunları içerir:

  • Microsoft 365'te paylaşılan posta kutuları (örneğin. support@company.com) - doğru yetkilendirilmiş izinlerle bir hizmet hesabına bağlanmış
  • Google Workspace paylaşılan gelen kutuları ve Gönderen Olarak izinleri yapılandırılmış grup adresleri
  • IMAP erişimli bir posta kutusu tarafından yönetilen herhangi bir e-posta takma adı

Ayrıca özelleştirebilirsiniz Görünen Ad kullanarak Gönderen alanında itibaren API yükündeki parametre, temel gönderim adresini değiştirmeden.

Unipile, hem Gmail hem de Outlook hesapları için belirteç yenilemeyi otomatik olarak halleder. OAuth erişim belirteçleri genellikle bir saat sonra geçerliliğini yitirir, ancak yenileme belirteci uzun ömürlüdür. Unipile, gönderme işlemi öncesinde süresi dolmuş bir erişim belirteci algıladığında, saklanan yenileme belirtecini kullanarak sessizce yenisini ister - uygulamanız bunu asla görmez ve gönderme çağrısı normal şekilde başarılı olur.

Kullanıcıdan yeniden kimlik doğrulaması yapmasını istemeniz gereken tek zaman, kullanıcının manuel olarak erişimi iptal edildi Google veya Microsoft hesap ayarlarından. Unipile bunu bir hesap durumu değişikliği olarak sunar; bunu webhook aracılığıyla veya hesap uç noktasını yoklayarak algılayabilirsiniz.

Hala sorularınız mı var? Ekibimiz yardım etmek için burada.

Bir uzmanla konuşun
tr_TRTR
en_USEN fr_FRFR es_ESES de_DEDE it_ITIT pt_BRBR nl_NLNL pl_PLPL tr_TRTR