Toplu gönderimler

import time from openemail import openemailfrom openemail.types import BroadcastCreate draft: BroadcastCreate = {    'audienceIds': ['aud_4c1b8e2a7d9f05c36b4e8a71'],    'from': 'Acme <[email protected]>',    'subject': '{{firstName|Hello}}, the September release is out',    'html': '<p>Hi {{firstName|there}},</p><p>Here is what changed this month.</p>',    'text': 'Hi {{firstName|there}}, here is what changed this month. Unsubscribe: {{unsubscribeUrl}}',    'tags': {'campaign': 'release-2026-09'},} reach = openemail.broadcasts.preview(draft)print(reach['recipients'], reach['unsubscribed'], reach['suppressed']) broadcast = openemail.broadcasts.send(draft) latest = openemail.broadcasts.get(broadcast['id'])while latest['status'] in ('scheduled', 'queued', 'sending'):    time.sleep(5)    latest = openemail.broadcasts.get(broadcast['id']) for copy in openemail.broadcasts.iterate_recipients(broadcast['id']):    print(copy['email'], copy['status'], copy['opens'], copy['clicks']) bounced = openemail.broadcasts.list_recipients(broadcast['id'], filter='bounced')if bounced['items']:    content = openemail.broadcasts.get_recipient(broadcast['id'], bounced['items'][0]['emailId'])    print(content['subject'], content['bouncedAt']) stats = openemail.broadcasts.stats(broadcast['id'], grain='day')print(stats['totals']['opened'], stats['totals']['clicked'], stats['totals']['unsubscribed']) lately = openemail.broadcasts.stats(broadcast['id'], days=1)print(lately['window']['opened'] if lately['window'] else None) month = openemail.broadcasts.analytics(days=30)for row in month['broadcasts']:    print(row['subject'], row['sent'], row['opened']) later = openemail.broadcasts.send({**draft, 'scheduledAt': 'P1D'})openemail.broadcasts.cancel(later['id']) history = openemail.broadcasts.list(audience_id=draft['audienceIds'][0])print(latest['status'], latest['counts']['sent'], len(history['items']))

Toplu gönderim, bir ya da daha fazla kitledeki herkese her kişi için ayrı bir kopya olarak tek bir ileti gönderir. Her kopyanın tam olarak bir alıcısı vardır, cc ya da bcc yoktur; bu yüzden kimse başka kime gittiğini görmez ve her kopya kendi msg_ kimliği, olayları, izlemesi ve webhook'ları olan sıradan bir e-postadır. list_recipients onları her birine ne olduğuyla birlikte listeler. Kopyalar Gönderilenler klasörüne kaydedilmez, çünkü toplu gönderim kayıttır.

send, toplu gönderim queued durumundayken ya da scheduledAt verirseniz scheduled durumundayken hemen döner ve gönderim arka planda sürer. send için emails:send ve audiences:read, preview için audiences:read, list, list_all, iterate, get, list_recipients, list_all_recipients, iterate_recipients, get_recipient, stats ve analytics için emails:read, cancel için emails:send gerekir.

subject, html ve text her kişi için kendi kişi kaydından doldurulur. {{firstName}} kişi adının ilk sözcüğü, {{lastName}} geri kalanı, {{name}} tam ad, {{email}} kopyanın gittiği adres ve {{unsubscribeUrl}} onun aboneliğini sonlandıran bağlantıdır.

Her alan çizgiden sonra bir yedek değer alır; kişinin o alan için değeri yoksa kullanılır, bu yüzden {{firstName|there}} adsız kaydedilmiş bir kişi için "there" olur. Değerler html içinde kaçırılır ve diğer her {{…}} tam yazıldığı gibi bırakılır.

Kaydedilmiş bir şablonu göndermek için html ve text yerine template geçirin. Aynı beş değer ona özellik olarak ulaşır, ama yalnızca şablonun tanımladığı özellikler; bu yüzden firstName'i tanımlayan bir şablon onu alır, tanımlamayan ise bu yüzden hiçbir zaman reddedilmez. template.props içindeki her şey her kopyaya aynı biçimde gider.

Her kopya, bir posta istemcisinin kendi abonelikten çıkma düğmesini göstermesini sağlayan tek tık abonelikten çıkma başlıklarını taşır; büyük posta kutusu sağlayıcılarının toplu postadan istediği de budur. {{unsubscribeUrl}}'i kendisi yerleştirmeyen bir html ya da text gövdesine bağlantıyı içeren tek satırlık bir alt bilgi eklenir. Şablon tam olduğu gibi gönderilir, bu yüzden {{unsubscribeUrl}}'i şablona koyun.

Abonelikten çıkmak, kişiyi o toplu gönderimin gittiği her kitlede abonelikten çıkmış olarak işaretler ve AudienceContactResource.unsubscribedAt bunu audiences.list_contacts üzerinde gösterir. Kişi kitlede ve adres defterinde kalır, diğer kitlelerine dokunulmaz ve ona tek tek gönderilen postalar gitmeye devam eder. Onu kitleden çıkarıp yeniden eklemek yeniden abone yapar.

Toplu gönderim, audienceIds içindekilerden en az birinde bulunan her kişiye, kaçında bulunursa bulunsun bir kez ulaşır. İçinde bulunduğu bu kitlelerin her birinden abonelikten çıkmış kişiyi ve bir geri dönme ya da şikâyet sonrasında veya biri eklediği için engelleme listesinde olan adresi atlar. send'den sonra ama gönderim ona ulaşmadan önce kitlelerden birine eklenen kişi dahil edilir.

preview hiçbir şey göndermeden aynı sayıları döndürür: recipients, unsubscribed ve suppressed. Kimseye ulaşmayacak bir send 422 no_recipients fırlatır.

get, counts'u kopyalardan canlı okur, bu yüzden bir toplu gönderim sürerken onu yoklayın. status, scheduled ya da queued'dan sending'e geçer ve teslim edilen her kopya gittiğinde ya da başarısız olduğunda sent üzerinde kalır. Kopyalar hâlâ beklerken, completedAt son kişiye ulaşıldığını söyledikten sonra bile sending kalır. failed, toplu gönderimin tamamının durduğu anlamına gelir ve lastError nedenini söyler: from adresinden artık gönderilemiyor, şablon çözümlenmeyi bıraktı, plan yarı yolda bitti, gönderimin kendisi sürekli başarısız oldu ya da tek bir kopya bile yazılamadı.

cancel, scheduled, queued ya da sending olan bir toplu gönderimi durdurur. Kimse eklenmez ve hâlâ bekleyen her kopya iptal edilir, gitmiş kopyalar ise geri alınamaz. Her kopya gittikten sonra cancel 409 broadcast_not_cancellable fırlatır ve iptal edilmiş bir toplu gönderimi iptal etmek onu olduğu gibi döndürür.

list_recipients, bir toplu gönderimin gittiği kişilerin bir sayfasını, kopya başına bir satır, adrese göre sıralı ve items, hasMore ve nextCursor içeren bir sözlük olarak döndürür. list_all_recipients tüm sayfaları dolaşıp tek bir listeye toplar, iterate_recipients ise her seferinde bir kopya verir ve sonraki sayfayı yalnızca döngü istediğinde getirir. limit 1 ile 200 arasındadır ve varsayılanı 50'dir; bir cursor aynı filter ve q ile geri gönderilir.

BROADCAST_RECIPIENT_FILTERS her filtreyi adlandırır, q ise adreste ve adda büyük/küçük harf ayrımı yapmadan arar. Açmalar ve tıklamalar görsel proxy'lerini ve bağlantı tarayıcılarını dışarıda bırakır ve toplu gönderim izleme kapalıyken çıktıysa 0 kalır.

get_recipient(id, email_id) tek bir kopya döndürür: aynı satır, artı birleştirme alanları doldurulmuş ve kişinin kendi abonelikten çıkma bağlantısıyla, o kişinin aldığı hâliyle subject, html ve text. HTML, açma ve tıklama izlemesi eklenmeden önceki hâlidir. Bu toplu gönderimin kopyası olmayan bir email_id 404 recipient_not_found fırlatır, bilinmeyen bir toplu gönderim ise 404 broadcast_not_found fırlatır.

stats toplamları ve bir seriyi döndürür. totals, sent, delivered, bounced, complained ve failed kopyaları, hâlâ bekleyenler için pending ile birlikte, ve opened, clicked ve unsubscribed kişileri sayar; opens ve clicks olay sayılarıdır. series seyrektir ve en eskiden başlar; bir şeyin olduğu her grain (minute, hour ya da day, varsayılan hour) için bir dilim vardır ve UTC'nin doğusundaki offset_minutes ile bölünür. Her kişiyi, başına ilk geldiği anda bir kez sayar, bu yüzden toplamı toplamlara eşittir.

get ve cancel her biri bunlardan birini döndürür; send ise bir SentBroadcastResource döndürür: aynı alanlar artı replayed; yanıt, aynı idempotency anahtarıyla yapılmış daha önceki bir çağrının oluşturduğu toplu gönderim olduğunda True olur. list bunlardan bir sayfayı en yeniden eskiye items, hasMore ve nextCursor içeren bir sözlük olarak döndürür; list_all ve iterate her sayfayı gezer. preview, audienceIds, recipients, unsubscribed ve suppressed içeren bir BroadcastPreviewResource döndürür. list_recipients bir BroadcastRecipientResource satırları sayfası, get_recipient bir BroadcastRecipientContentResource, stats ise bir BroadcastStatsResource döndürür.

list_recipients, list_all_recipients ve iterate_recipients sonuçlarının her satırı. get_recipient'ten gelen BroadcastRecipientContentResource, subject, html ve text ekler.

• broadcasts.preview()Tam başvuru
• broadcasts.send()Tam başvuru
• broadcasts.list()Tam başvuru
• broadcasts.list_all()Tam başvuru
• broadcasts.iterate()Tam başvuru
• broadcasts.get()Tam başvuru
• broadcasts.list_recipients()Tam başvuru
• broadcasts.list_all_recipients()Tam başvuru
• broadcasts.iterate_recipients()Tam başvuru
• broadcasts.get_recipient()Tam başvuru
• broadcasts.stats()Tam başvuru
• broadcasts.analytics()Tam başvuru
• broadcasts.cancel()Tam başvuru