Troubleshooting Pengiriman Email

Urutan diagnosis yang paling cepat: pastikan domain terverifikasi, saldo cukup, kredensial benar, lalu baca timeline pesan di Sending & Logs. Mulai dari kasus di bawah bila gejalanya cocok.

Kasus umum

“Sender tidak diizinkan” / 403 sender_not_authorized

Alamat pengirim memakai domain yang bukan milik akun Anda, atau domainnya belum terverifikasi. BukaDomain, pastikan statusnya terverifikasi dan konfigurasi penyedia sudah siap. Ingat: alamat dari penyedia email publik (Gmail dan sejenisnya) tidak bisa menjadi pengirim — pakai domain sendiri.

“Saldo belum mencukupi” / 403 insufficient_balance / 452 4.2.2

Saldo tersedia kurang dari rate akun. Top up di Wallet & Billing(minimum Rp15.000). Cek juga apakah ada dana yang sedang ditahan untuk pesan reserved ataureconcile_pending — dana itu belum bisa dipakai.

503 provider_unavailable

Penyedia pengiriman sedang tidak dapat dihubungi dari sisi Hubina. Ini gangguan sementara: retry dengan jeda bertahap. Percobaan yang gagal total tidak menagih saldo. Bila berlangsung lama dan semua pengiriman gagal, hubungi dukungan sambil tetap memantau Sending & Logs.

SMTP menolak koneksi/AUTH

• 538 5.7.0 — klien mencoba AUTH sebelum TLS. Aktifkan STARTTLS (di Nodemailer: requireTLS: true; di framework: setelan enkripsi TLS).
• 535 5.7.8 — API key salah atau sudah dicabut. Buat key baru bila perlu; username diisi api.
• Koneksi timeout — cek keluar firewall Anda ke port 587, dan pastikan hostnya smtp.hubina.net.

Email terkirim dua kali

Biasanya karena aplikasi mengulang pengiriman setelah timeout tanpa kunci deduplication. Di REST API pakaiIdempotency-Key; di SMTP sertakan header Message-ID yang stabil untuk pesan logis yang sama. Simpan kunci itu bersama data pesan Anda sehingga retry berikutnya tetap sama.

Email masuk folder spam penerima

• Pastikan domain terverifikasi lengkap — SPF/DKIM yang benar adalah faktor terbesar.
• Gunakan alamat pengirim yang konsisten dengan domain dan isi yang relevan (jangan memakai subjek/tautan yang menyamar).
• Hindari lampiran mencurigakan dan tautan pendek yang tidak dikenal.
• Penerima yang menandai pesan sebagai spam berdampak pada reputasi; gunakan daftar penerima yang benar-benar berlangganan.
• Keputusan akhir ada di penyedia email penerima; Hubina tidak bisa memaksa inbox placement.

Status berhenti di reconcile_pending

Hasil penyerahan ke penyedia belum pasti. Jangan mengirim ulang — pesan mungkin sudah diterima. Tombol Sinkronkan menarik status terbaru; dana tetap ditahan sampai hasil jelas (lihat Billing & Saldo).

Pesan bounced — apakah saldo kembali?

Tidak otomatis; finalisasi sudah terjadi saat penyedia menerima pesan. Baca alasan bounce di timeline (mis. 550 5.1.1 mailbox unavailable) — biasanya masalah di alamat tujuan, bukan konfigurasi Anda. Hapus alamat itu dari daftar kirim berikutnya.

Checklist debugging

1. Domain: status terverifikasi + konfigurasi penyedia siap?
2. Saldo: tersedia cukup untuk rate akun, dan tidak ada dana besar tertahan?
3. Kredensial: API key masih aktif, dan di header/username dipasang dengan benar?
4. Pesan: ketemu di Sending & Logs? Bandingkan msg_… dari respons API.
5. Timeline: baca event terakhir + alasan/kode dari penyedia.
6. Uji terisolasi: kirim satu pesan uji ke alamat yang Anda kendalikan lewat cURL atau klien SMTP sederhana, tanpa retry.
7. Cek spam di sisi penerima sebelum menyimpulkan gagal.