Kirim email lewat SMTP relay

Kalau aplikasimu sudah bisa mengirim email lewat SMTP — misalnya Laravel, Odoo, atau aplikasi lain — kamu bisa langsung memakai kirim.id tanpa menulis kode integrasi API. Cukup ganti pengaturan SMTP-nya. Biayanya sama dengan API: 1 koin (Rp0,5) per email yang diserahkan ke server pengiriman.

Sebelum mulai#

• Domain pengirim sudah aktif di akunmu. Lihat Verifikasi domain pengirim.

• Server aplikasimu bisa terhubung keluar ke mail.kirim.id di port 587 atau 465.

Membuat kredensial SMTP#

1. Buka Settings, tab Kredensial SMTP

   Di dashboard kirim.id, buka menu Settings, lalu pilih tab Kredensial SMTP. Kalau belum pernah dibuat, klik Buat Kredensial SMTP. Satu kredensial berlaku untuk semua domain aktif di akunmu.

2. Catat username dan password

   Username berformat kir + 6 angka dan bisa disalin dengan tombol Salin. Password terdiri dari 32 karakter dan disembunyikan; klik ikon mata untuk menampilkannya. Di panel yang sama terlihat juga Batas kirim akunmu per menit.

3. Masukkan ke pengaturan SMTP aplikasimu

   Isi host, port, enkripsi, username, dan password sesuai tabel di bawah, lalu kirim email uji.

Pengaturan SMTP#

Contoh: Laravel (.env)#

MAIL_MAILER=smtp
MAIL_HOST=mail.kirim.id
MAIL_PORT=587
MAIL_ENCRYPTION=tls
MAIL_USERNAME=kir123456
MAIL_PASSWORD=password-dari-dashboard
MAIL_FROM_ADDRESS=[email protected]

Ganti MAIL_FROM_ADDRESS dengan alamat di domain yang sudah aktif di akunmu. Simpan password di .env atau secret manager, jangan di kode yang ikut ter-commit.

Apa yang terjadi pada email SMTP#

Setiap penerima dalam satu email SMTP menjadi satu pesan terpisah di kirim.id, dengan fitur yang sama seperti API:

• Merge tag seperti {{nama|Kak}} diisi otomatis.

• Pelacakan buka dan klik untuk email marketing. Email transactional dikirim tanpa pelacakan (link apa adanya), dan linknya dicek dulu ke daftar hitam domain. Email berisi link ke domain spam, phishing, atau malware tidak dikirim (lihat Kirim email lewat API).

• Untuk email marketing, footer unsubscribe ditambahkan bila email belum memuat link berhenti langganan. Email transactional (invoice, OTP, notifikasi) dikirim tanpa footer dan tanpa header List-Unsubscribe. Atur jenis bawaannya di Email → Settings → Kredensial SMTP → Jenis email (bawaan: marketing), atau per email dengan header X-Kirim-Type: transactional atau X-Kirim-Type: marketing. Isi yang sama ke 30+ penerima dalam 1 jam, atau 300+ email transactional dalam 10 menit dengan isi berbau promosi, tetap diperlakukan sebagai marketing (lihat Jenis email). Penerima yang sudah berhenti berlangganan tetap menerima email transactional. Penerima seperti ini tetap diterima saat RCPT TO. Setelah isi email terbaca, email marketing (jenis bawaan kredensial, header X-Kirim-Type: marketing, atau terdeteksi blast) tidak dikirim, tercatat gagal di log pengiriman, dan kena penalti kirim paksa. Email transactional ke kontak seperti ini dibatasi 100 per hari.

• Event dikirim ke webhook-mu, dengan channel: "smtp".

Batas kecepatan SMTP sama dengan jalur lain dan dipakai bersama: akun Free 10 email/menit (maks. 300/hari), akun Premium 1.200 email/menit tanpa batas harian.

Kode balasan yang perlu dikenali#

Baca juga#

• Plugin WordPress kirim.id

• Mulai cepat dengan REST API

• SPF, DKIM, dan DMARC