Opsi pengiriman
Apa yang terjadi saat email tidak bisa langsung dikirim, dan cara mengubahnya per email: berapa lama kami terus mencoba ulang, dan apakah tetap mengirim ke alamat yang pernah mengalami hard bounce.
Semua opsi bersifat opsional. Tanpa opsi ini, setiap email mengikuti default di bawah. Opsi dimasukkan ke body Kirim Email, atau sebagai header saat Anda mengirim melalui SMTP.
Cara kerja retry
Penolakan permanen, seperti alamat yang tidak ada, bersifat final dan tidak dicoba ulang. Kasus berikut kami coba ulang untuk Anda:
Greylisting
Server penerima menjawab "coba lagi nanti" kepada pengirim yang belum pernah dilihatnya.
Kami mencoba lagi dari IP yang sama setelah 5, 10, 20, 40, 60, dan 60 menit (total sekitar 3 jam).
Error sementara
Balasan 4xx, terlalu banyak koneksi, atau koneksi yang terputus di tengah pengiriman.
Kami mencoba lagi beberapa kali dengan jeda di antara percobaan. Berapa kali dan berapa lama menunggu tergantung pada error-nya, kecuali Anda mengaturnya.
retryUnavailable · retryUnavailableSecondsServer penerima mati
Server email penerima sama sekali tidak menerima koneksi.
Kami menunggu hingga server kembali tanpa menghabiskan retry Anda. Jika masih mati setelah 24 jam, email ditandai sebagai bounced.
Terkena rate limit
Penyedia mailbox (Outlook, Yahoo, AOL…) meminta kami memperlambat pengiriman.
Email menunggu dan dicoba lagi setiap 30 menit, mungkin dari IP lain. Secara default kami terus mencoba selama 25 siklus (sekitar 12 jam).
retryRateLimitedOpsi retry
Anda menetapkan batas, kami menetapkan plafon. Nilai di luar rentang disesuaikan ke nilai terdekat yang diizinkan, dan respons memberi tahu Anda di warnings. Nama field tidak peka huruf besar/kecil: retryRateLimited dan retry_rate_limited sama saja.
retryRateLimitedintegeropsionalBerapa siklus rate limit 30 menit yang ditunggu sebelum menyerah. 0 langsung menyerah pada rate limit pertama. Gunakan nilai rendah untuk email yang mendesak, seperti kode login.
Rentang0 – 24Default 25 siklusSMTPX-Sendcorex-Retry-Rate-LimitedretryUnavailableintegeropsionalBerapa kali mencoba lagi setelah error sementara. 0 langsung gagal pada error pertama.
Rentang0 – 30Default Tergantung error (hingga 10)SMTPX-Sendcorex-Retry-UnavailableretryUnavailableSecondsintegeropsionalBerapa detik menunggu di antara percobaan tersebut.
Rentang10 – 3600Default Tergantung errorSMTPX-Sendcorex-Retry-Unavailable-SecondsignoreHardBouncebooleanopsionalTetap kirim meskipun alamat mengalami hard bounce dalam 90 hari terakhir. Satu percobaan per alamat, dan opsi dinonaktifkan selama 7 hari setelah 3 kegagalan dalam 24 jam. Lihat Hard bounce yang sudah diketahui di bawah.
Rentangtrue · falseDefault falseSMTPX-Sendcorex-Ignore-Hard-Bounce
Hard bounce yang sudah diketahui
Saat sebuah alamat mengalami hard bounce (mailbox tidak ada), kami mengingatnya selama 90 hari. Mengirim lagi ke alamat itu hanya akan merusak reputasi pengirim Anda, jadi kami tidak terhubung lagi ke server penerima:
Tanpa Hard Bounce Shield
Ditandai sebagai bounced
Email tidak dikirim dan dicatat sebagai bounce. Email ini dihitung dalam bounce rate Anda.
Dengan Hard Bounce Shield
Disupresi
Email tidak dikirim dan dicatat sebagai Suppressed. Email ini menggunakan kredit, tetapi tidak dihitung sebagai bounce. Anda tetap menerima webhook bounced, dengan suppressed: true, sehingga setiap email berakhir dengan event final.
Mailbox penuh
Mailbox penuh adalah error sementara, jadi alamat tidak diingat pada kali pertama. Jika alamat yang sama kembali penuh pada 3 email berturut-turut, tanpa pengiriman berhasil di antaranya dan dengan jarak kurang dari 30 hari, kami memperlakukannya sebagai hard bounce sejak saat itu. Satu pengiriman berhasil mereset hitungan.
Tetap kirim
Jika Anda tahu mailbox kini sudah ada (penerima sudah memperbaikinya, atau itu masalah sementara di sisi mereka), atur ignoreHardBounce: true. Email dikirim seperti biasa. Jika berhasil terkirim, alamat dihapus dari daftar dan Anda tidak perlu opsi ini lagi untuk alamat tersebut.
Batasan
Opsi ini berarti "mailbox ini sekarang ada". Jika ternyata tidak benar, opsi berhenti berfungsi:
Satu percobaan per alamat
Jika email mengalami hard bounce lagi, email dihitung sebagai bounce, alamat diingat selama 90 hari lagi, dan opsi diabaikan untuk alamat itu sampai saat tersebut.
3 kegagalan dalam 24 jam
Jika 3 email yang dikirim dengan opsi ini mengalami hard bounce lagi, masing-masing kurang dari 24 jam setelah yang sebelumnya, opsi dinonaktifkan untuk akun Anda selama 7 hari. Email Anda tetap terkirim; hard bounce yang sudah diketahui hanya dilewati seperti biasa.
Jika opsi diabaikan, reason diawali dengan ignore_hard_bounce revoked: dan menyebutkan alasannya.
Gunakan per email, bukan sebagai default. Penyedia mailbox memantau seberapa sering Anda mengirim ke alamat yang tidak ada. Mengaktifkannya di setiap pengiriman menghilangkan perlindungan.
Pilih IP pengirim
Dengan IP dedicated, kami memilih IP mana yang mengirim setiap email berdasarkan pengaturan di halaman IP Anda. Untuk menentukannya sendiri, atur sendingIp ke salah satu IP dedicated Anda. Email hanya dikirim dari IP itu, dari percobaan pertama hingga retry terakhir.
sendingIpstringopsionalAlamat IPv4 atau IPv6 yang merupakan salah satu IP dedicated Anda dan sedang aktif. Nilai lain akan menolak email.
Default Dipilih oleh pengaturan IP AndaSMTPX-Sendcorex-Sending-IPMCPsending_ip
{
"to": "customer@example.com",
"from": "billing@yourdomain.com",
"senderName": "My App",
"subject": "Your invoice",
"body": "<p>Your invoice is ready.</p>",
"sendingIp": "203.0.113.10"
}Apa yang diganti
Pengaturan dari halaman IP Anda berikut tidak berlaku untuk email yang dikirim dengan sendingIp. Email tanpa opsi ini tetap mengikutinya.
IP mana yang mengirim
Biasanya kami bergantian di antara IP dedicated Anda. Email dikirim dari IP yang Anda pilih.
Routing IPv4 dan IPv6
Pembagian IPv4/IPv6 dari pengaturan routing Anda dilewati. Alamat IPv6 mengirim melalui IPv6, alamat IPv4 melalui IPv4.
Failover saat terkena rate limit
Biasanya kami mencoba ulang dari IP dedicated Anda yang lain. Email menunggu di IP yang Anda pilih.
Blacklist Guard
Jika IP masuk blacklist, email tidak dipindahkan ke IP bersama. Email menunggu di IP yang Anda pilih.
Email terjadwal
IP disimpan bersama email dan digunakan saat email dikirim, meskipun pengaturan IP Anda berubah di antaranya.
Error
API
400 INVALID_SENDING_IPNilainya bukan alamat IP, atau bukan salah satu IP dedicated aktif Anda. Email tidak masuk antrean.SMTP
550 5.7.1Pemeriksaan yang sama pada header X-Sendcorex-Sending-IP. Pesan ditolak di akhir DATA.MCP
INVALID_SENDING_IPPemeriksaan yang sama pada argumen sending_ip dari email_send.
IP tetap akan menunggu, bukan berpindah.Jika provider memperlambat IP itu atau IP masuk blacklist, email menunggu di IP yang sama hingga terkirim atau retry habis. Untuk email yang tidak bisa menunggu, jangan sertakan sendingIp dan biarkan kami yang memilih.
Contoh
Kode login tidak berguna setelah beberapa menit, jadi jangan biarkan menunggu berjam-jam.
import axios from 'axios';
const response = await axios.post(
'https://mail.sendcorex.com/v3.0/send',
{
to: 'user@example.com',
from: 'noreply@yourdomain.com',
senderName: 'My App',
subject: 'Your login code',
body: '<p>Your code is <b>482913</b></p>',
retryRateLimited: 4, // give up after 4 rate-limit cycles (~2 h)
retryUnavailable: 5, // up to 5 retries on temporary errors
retryUnavailableSeconds: 30, // 30 s between them
ignoreHardBounce: true, // send even if this address hard bounced before
},
{
headers: { Authorization: process.env.SENDCOREX_API_KEY },
}
);
console.log(response.data.id, response.data.warnings);Respons dengan nilai yang disesuaikan
Di sini retryRateLimited dikirim sebagai 40. Email tetap masuk antrean, dengan 24.
Email masuk antrean, dengan peringatan
{
"success": true,
"message": "Email queued successfully",
"code": "EMAIL_QUEUED_SUCCESS",
"id": "3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f",
"ids": [
{ "id": "3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f", "recipient": "user@example.com" }
],
"recipients": 1,
"scheduledAt": null,
"warnings": ["retry_rate_limited 40 → 24"]
}Header SMTP
Mengirim melalui SMTP? Tambahkan opsi yang sama sebagai header. Kami membacanya dan menghapusnya sebelum email dikirim, sehingga penerima tidak pernah melihatnya.
X-Sendcorex-Retry-Rate-Limited: 4 X-Sendcorex-Retry-Unavailable: 5 X-Sendcorex-Retry-Unavailable-Seconds: 30 X-Sendcorex-Ignore-Hard-Bounce: true X-Sendcorex-Sending-IP: 203.0.113.10
Event webhook
Pantau retry secara langsung dengan event webhook berikut:
- retrying
Terjadi error sementara dan email akan dicoba lagi. Reason menyebutkan percobaan ke berapa.
- failed
Kami menyerah setelah retry atau siklus rate limit habis.
- bounced
Server penerima menolak email secara permanen, atau mati selama 24 jam. Juga dikirim saat kami melewati hard bounce yang sudah diketahui, dengan suppressed: true jika Anda memiliki Hard Bounce Shield.