Email

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.

i

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).

Otomatis

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.

Ubah denganretryUnavailable · retryUnavailableSeconds

Server 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.

Otomatis

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).

Ubah denganretryRateLimited

Opsi 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.

  • retryRateLimitedintegeropsional

    Berapa 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.

    Rentang 0 – 24Default 25 siklusSMTP X-Sendcorex-Retry-Rate-Limited
  • retryUnavailableintegeropsional

    Berapa kali mencoba lagi setelah error sementara. 0 langsung gagal pada error pertama.

    Rentang 0 – 30Default Tergantung error (hingga 10)SMTP X-Sendcorex-Retry-Unavailable
  • retryUnavailableSecondsintegeropsional

    Berapa detik menunggu di antara percobaan tersebut.

    Rentang 10 – 3600Default Tergantung errorSMTP X-Sendcorex-Retry-Unavailable-Seconds
  • ignoreHardBouncebooleanopsional

    Tetap 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.

    Rentang true · falseDefault falseSMTP X-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.

  • sendingIpstringopsional

    Alamat IPv4 atau IPv6 yang merupakan salah satu IP dedicated Anda dan sedang aktif. Nilai lain akan menolak email.

    Default Dipilih oleh pengaturan IP AndaSMTP X-Sendcorex-Sending-IPMCP sending_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_IP Nilainya bukan alamat IP, atau bukan salah satu IP dedicated aktif Anda. Email tidak masuk antrean.

  • SMTP

    550 5.7.1 Pemeriksaan yang sama pada header X-Sendcorex-Sending-IP. Pesan ditolak di akhir DATA.

  • MCP

    INVALID_SENDING_IP Pemeriksaan 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.

200

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.