E-posta gönderme ve izleme

emails ad alanı, gönderim API'sinin komut hâlidir; SDK'daki openemail.emails nesnesinin her yöntemi için bir komut. Her biri bir uç noktayı çağırır ve döndürdüğünü yazdırır. tracking ad alanı, gönderdiğiniz postadaki açılmaları ve tıklamaları okur. openemail emails yerine openemail email de çalışır.

Buradaki her komut, tarayıcıdan ya da bir API anahtarıyla açılmış bir oturum ve iki kapsamdan birini gerektirir: gönderme, çevirme, iptal etme ve yeniden zamanlama için emails:send, yalnızca okuyan her şey için emails:read.

openemail send, Posta sayfasındaki elle yazılmış komuttur ve emails send üzerinden gönderir. Terminal başındaki bir kişi için yapılmıştır: --from vermediğinizde gönderen adresi seçer, gövdeyi bir dosyadan, stdin'den ya da düzenleyicinizden okur, dosyaları yoluyla ekler ve bir şey gönderilmeden önce onaylamanız için bir özet gösterir. openemail emails send ise istek gövdesini her alan için bir bayrak olarak alır ve hiçbir şey sormaz; bu da tam olarak ne gönderdiğini bilen bir betiğe uyar.

Yalnızca emails send içinde tek bir gönderim için açılmaları ya da tıklamaları kapatan --tracking, --signature, özel başlıklar için --headers, dosyaları eklemek ile onlara bağlantı vermek arasında seçim yapmak için --attachment-delivery ve gövdenin tamamını JSON olarak satır içi, @path ile bir dosyadan ya da - ile stdin'den almak için --data bulunur.

send, send-batch, translate, cancel ve reschedule için emails:send gerekir. list, get, list-events ve get-tracking için emails:read gerekir. Bir e-posta id'si, bir gönderimin döndürdüğü gibi msg_ ve ardından 24 onaltılık karakterdir.

Beşi de emails:read gerektirir. tracking get, list-opens ve list-clicks, bir mesajın sahip olduğu iki id'den birini alır: gönderiminin döndürdüğü msg_ id'si ya da tracking list ile webhook yüklerinin taşıdığı tmsg_ izleme id'si.

tracking list ve get-stats, web uygulamasında yazılan posta ve MCP araçlarının ya da asistanın gönderdiği posta dahil, posta kutusunun gönderdiği izlenen her mesajı kapsar; emails list ise API'nin oluşturduğu gönderim kayıtlarını tutar. Gönderim kaydı olmayan bir raporda sendId değeri null olur.

Bir betikten kendi eş güçlülük anahtarınızla gönderin. Aynı --idempotency-key ile yeniden çalıştırmak, ikinci bir e-posta göndermek yerine ilk e-postayı replayed: true ile yazdırır.

openemail emails send \  --from 'Acme Billing <[email protected]>' \  --to [email protected] \  --subject 'Your September invoice' \  --html '<p>The invoice is attached. Tell me if anything on it looks wrong.</p>' \  --attachments '[{"fileId":"file_6bb640f5b99e47deb758f1f5"}]' \  --tracking '{"opens":false}' \  --idempotency-key invoice:inv_2026_09_4192 \  --json | jq -r '.id + " " + .status'

Bir çeviriyi gitmeden önce bir kişiye okutun. Onaylanan metni --translate olmadan düz --subject ve --html olarak gönderin, yoksa ikinci kez çevrilir. --no-include-original vermediğiniz sürece çevrilmiş html, özgün metninizi zaten altında içerir.

openemail emails translate --to de \  --subject 'Your September invoice' \  --html "$(cat invoice.html)" \  --json > preview.jsonjq -r .html preview.jsonopenemail emails send --from [email protected] --to [email protected] \  --subject "$(jq -r .subject preview.json)" \  --html "$(jq -r .html preview.json)"

Bir dosyadan toplu gönderim yapın. Komut, bazı öğeler başarısız olsa bile toplu gönderim işlendiği her durumda 0 koduyla çıkar, bu yüzden failed değerini ve her öğenin status değerini okuyun. Aynı anahtarla yeniden çalıştırmak, dizi sırasını koruduğu sürece giden öğeleri yeniden oynatır ve yalnızca geri kalanları gönderir.

[  { "from": "[email protected]", "to": "[email protected]", "subject": "Receipt 4192", "text": "Thanks for your order." },  { "from": "[email protected]", "to": "[email protected]", "subject": "Receipt 4193", "text": "Thanks for your order." }]

openemail emails send-batch receipts.json --idempotency-key receipts:2026-09-27 --json > result.jsonjq '{ sent, failed }' result.jsonjq -r '.items[] | select(.status == "error") | "\(.index) \(.error.code)"' result.json

Bir e-postayı zamanlayın, taşıyın ve iptal edin. --yes, cancel komutunun istediği onayı yanıtlar; bir betik bunu yapamaz.

ID=$(openemail send --from [email protected] --to [email protected] --subject "Standup notes" \  --body-file notes.md --at 2026-10-01T09:00:00Z --json | jq -r .id)openemail emails reschedule "$ID" 2026-10-01T13:00:00Zopenemail emails get "$ID" --json | jq -r '.status + " " + .scheduledAt'openemail emails cancel "$ID" --yes

Başarısız olan gönderimleri bulun ve birine ne olduğunu okuyun. --json olmadan bir kanala yönlendirildiğinde --all her satıra bir JSON nesnesi yazdırır.

openemail emails list --status failed,partial --from [email protected] --all | jq -r .idopenemail emails get msg_3f9a1c07d2b84e6a9c5b1f20openemail emails list-events msg_3f9a1c07d2b84e6a9c5b1f20 --all --json | jq -r '.items[] | .createdAt + " " + .type'

Bir haftalık etkileşimi UTC+2 gece yarısında bölünen günler hâlinde okuyun, kimsenin açmadıklarını listeleyin ve tek bir mesajın her bağlantısındaki tıklamaları sayın.

openemail tracking get-stats --days 7 --offset-minutes 120 --json | jq '{ tracked, openRate, clickRate }'openemail tracking list --no-opened --days 7 --all | jq -r .subjectopenemail tracking list-clicks msg_3f9a1c07d2b84e6a9c5b1f20 --all | jq -r .url | sort | uniq -c

• —Bir tarayıcı oturumu kapsamları onay sayfasında ister ve openemail login --scopes emails:send,emails:read ikisini de önceden seçer. Kapsamı eksik olan bir komut 4 çıkış kodu ve insufficient_scope ile durur ve kapsamın adını verir.
• —5 MB'tan fazla dosyayla send --attach önce onları Dosyalar'a yükler; bu da ayrıca files:write gerektirir.
• —Bu komutların hiçbiri doğrulama kodu istemez, bu yüzden bir tarayıcı oturumu onları bir API anahtarı gibi çalıştırır.
• —emails cancel iptal etmeden önce sorar ve --yes sizin yerinize yanıtlar. Gözetimsiz çalışırken --yes yoksa Refusing to run unattended. Pass --yes to confirm. iletisi ve 2 çıkış koduyla durur.
• —emails send, send-batch ve reschedule asla sormaz. send bir özet gösterir ve yalnızca bir terminalde sorar; --yes bunu da atlar.
• —--dry-run bir komutun göndereceği isteği yazdırır, hiçbir şey göndermez ve 0 koduyla çıkar. emails translate üzerinde bu hiçbir yapay zekâ işlemi harcamaz, emails cancel üzerinde ise hiçbir şey sormaz.

emails list, emails list-events, tracking list, list-opens ve list-clicks tek bir sayfa okur. --limit boyutunu belirler: iki emails listesi için 1 ile 100 arası, varsayılan 25; üç tracking listesi için 1 ile 200 arası, varsayılan 50. --cursor bir sayfanın yazdırdığı imleçten devam eder.

• —--all her sayfayı okur ve öğeleri akış hâlinde verir: terminalde bir tablo, bir kanala yönlendirildiğinde ya da --ndjson ile her satıra bir JSON nesnesi.
• —--max <n> o kadar öğeden sonra durur ve --all anlamına gelir.
• —--json, --all dahil, tek bir { items, hasMore, nextCursor } belgesi yazdırır.
• —Sayfalama ofset ile değil imleçle yapılır, bu yüzden siz sayfalar arasında gezinirken gönderilen posta hiçbir satırı kaydırmaz ya da tekrarlamaz.

• —Her çalıştırma kendi eş güçlülük anahtarını üretir ve bu anahtar o çalıştırmanın içindeki yeniden denemeleri kapsar. Bir gönderimi iki kez çalıştırmak, iki çalıştırma da aynı --idempotency-key değerini vermedikçe iki kez gönderir. Aynı anahtar farklı bir gövdeyle idempotency_key_reuse ve 7 çıkış koduyla reddedilir.
• —Yalnızca queued ve scheduled durumundaki posta iptal edilebilir ya da taşınabilir. Geri alma penceresi olmayan anlık bir gönderim istek içinde gider, bu yüzden id'sini elinize aldığınızda genellikle çok geçtir ve çağrı email_not_cancellable ve 6 çıkış koduyla biter.
• —İptal edilen bir e-posta iptal edilmiş kalır. Yeniden zamanlama yalnızca zamanı değiştirir; bir süre verildiğinde bu süre sunucunun isteği aldığı andan itibaren sayılır. Metni değiştirmek için iptal edip yeniden gönderin.
• —Üretilemeyen bir çeviri gönderimin tamamını reddeder ve hiçbir şey çevrilmeden gitmez. Çevrilmiş bir toplu gönderim, translate taşıyan en fazla 10 mesaj içerir.
• —Tükenmiş bir gönderim kotası, bir gönderimi ayın ilk gününe kadar send_quota_exceeded ile durdurur; tükenmiş bir yapay zekâ kotası da bir çeviriyi UTC gece yarısına kadar ai_quota_exceeded ile durdurur. İkisi de 8 çıkış koduyla biter.
• —Bir oe_test_ anahtarıyla gönderilen posta asla teslim edilmez. sent olarak görünür, transport değeri test olur ve asla izlenmez.
• —emails get-tracking ve tracking get, piksel ya da yeniden yazılmış bağlantı taşımayan bir mesaj için 404 ve 5 çıkış koduyla yanıt verir, çünkü izlenmemiş olmak açılmamış olmakla aynı şey değildir. İzleme, mesajın gönderildiği ayarı izler, bu yüzden sonradan açmak önceki postaya ulaşmaz.
• —Her sayı bir alt sınırdır. Posta istemcisi görselleri engelleyen bir okuyucu asla açılma olarak sayılmaz ve bir tıklama, okunduğunun bir açılmadan daha güçlü kanıtıdır.
• —list-opens ve list-clicks, hiçbir şeyin izlenmediği bir msg_ id'si için 404 döndürür, ancak bir tmsg_ id'sini verildiği gibi alır; bu yüzden bilinmeyen bir id boş bir liste olarak döner.
• —Bazı adreslerle sınırlı bir anahtar yalnızca o adreslerden gönderilen postayı görür; bütün bir alan adını tutan bir anahtar ise oradaki her adresi kapsar.

Bu sayfa en önemli bayrakları adlandırır. openemail <command> --help, bir komutun aldığı her bağımsız değişkeni ve bayrağı türüyle, gereken kapsamla, yöntemi ve yoluyla, ne döndürdüğüyle ve API başvurusundaki notlarla listeler. Aynı yardımı tek bir JSON belgesi olarak almak için --json ekleyin.

openemail emails --helpopenemail emails send --helpopenemail tracking list-opens --help --json