---
title: SMTP dan templat e-mail
description: Konfigurasikan e-mail keluar (SMTP), kirim pesan uji, edit templat e-mail di setiap bahasa, dan baca log pengiriman.
url: https://nexcmp.com/id/docs/administration/smtp-and-emails/
applies_to: NexCMP 1.6.1
updated: 2026-11-02
---

# SMTP dan templat e-mail {#smtp-and-e-mail-templates}

> **Di mana letaknya di admin:** System › Settings › Email (`/settings/email`) — tab **SMTP** dan **Email templates**. Log pengiriman: Overview › Support › Sent emails (`/support/emails`).

## Fungsi {#what-it-does}

NexCMP mengirim e-mail untuk verifikasi pendaftaran, pengaturan ulang kata sandi, "VM ready" (dengan kata sandi awal), faktur, saldo rendah, pembaruan, isi ulang, balasan dukungan, dan banyak lagi. Semuanya melalui **satu akun SMTP yang Anda sediakan**. Pesan dan templat tersedia dalam 16 bahasa; bahasa pelanggan yang akan digunakan.

## Persyaratan {#requirements}

| Item | Persyaratan |
|---|---|
| Server SMTP | Host, port, dan kredensial dari penyedia mana pun (server Anda sendiri, Brevo, Amazon SES, Mailgun, Google Workspace ...) |
| Jaringan | TCP keluar dari server NexCMP ke host dan port SMTP (587 STARTTLS, 465 TLS, atau 25) |
| Domain pengirim | Domain yang Anda kendalikan, dengan **SPF dan DKIM** yang dipublikasikan untuk penyedia serta catatan DMARC |
| Izin | Akun SMTP harus diizinkan untuk mengirim sebagai alamat **From** |

::: warning Keteririman
E-mail seperti "VM ready" berisi kata sandi. Jika SPF/DKIM/DMARC domain pengirim tidak cocok dengan penyedia SMTP, e-mail akan masuk ke spam. Halaman ini mengingatkan Anda akan hal tersebut.
:::

## Siapkan penyedia e-mail {#prepare-the-e-mail-provider}

1. Di panel penyedia Anda, tambahkan dan verifikasi domain pengiriman Anda (misalnya `example.com`).
2. Publikasikan catatan DNS SPF, DKIM, dan DMARC yang ditampilkan oleh penyedia.
3. Buat pengguna SMTP (atau kunci API-SMTP) dan catat host, port, nama pengguna, serta kata sandi.

## Hubungkan di NexCMP {#connect-in-nexcmp}

1. Buka **System › Settings › Email**, tab **SMTP**.
2. Isi formulir:

| Kolom | Contoh | Catatan |
|---|---|---|
| Host | `smtp.example.net` | Server SMTP |
| Port | `587` | |
| Keamanan | STARTTLS (587) | Pilih mode yang diwajibkan oleh penyedia Anda |
| Nama pengguna | `smtp-user` | |
| Kata sandi | (tersembunyi) | Hanya-tulis: halaman hanya menampilkan apakah sudah diatur |
| Email dari | `no-reply@example.com` | Harus diotorisasi di penyedia |
| Nama pengirim | `Example Cloud` | Default ke nama merek Anda |
| Balas-Ke (opsional) | `support@example.com` | Tempat balasan pelanggan dikirim |

![Tab SMTP dari Pengaturan, Email dengan host, port, keamanan, nama pengguna, bidang pengirim, dan tombol Kirim uji](https://nexcmp.com/id/docs/images/administration/smtp-and-emails-01-smtp.webp)

3. Klik **Save**, lalu **Send test** dan masukkan alamat Anda sendiri.

Pengaturan disimpan dalam file dengan akses terbatas (`smtp.json`, mode 0600) dan hanya pekerja latar belakang `nexcmp-vmd` yang mengirimkan email; layanan web hanya mengantrekannya.

## Verifikasi {#verify}

- Pesan uji tiba di kotak masuk (cek juga folder spam). Di sumber pesan, konfirmasikan `dkim=pass` dan `spf=pass`.
- Buka **Support › Sent emails**: setiap pesan memiliki status (dalam antrean, terkirim, gagal) dan hasil pengiriman. Pesan yang gagal akan dicoba ulang hingga 3 kali.
- Daftarkan pelanggan uji coba di portal dan konfirmasikan email verifikasi tiba.

## Edit templat email {#edit-e-mail-templates}

Tab **Email templates** mencantumkan setiap templat berdasarkan kunci, beserta bahasa yang tersedia (misalnya `verify_email`, `reset_password`, `vm_ready`, `invoice_paid`, `low_balance`, `topup_received`, `ticket_reply`, `scale_up` …).

1. Klik templat dan pilih bahasa.
2. Edit subjek dan isi. Placeholder akan diisi saat pesan dimasukkan ke antrean.
3. Simpan. Perubahan berlaku **segera** pada pesan yang masuk antrean setelahnya.

![Tab Email templates yang mencantumkan kunci templat beserta bahasanya](https://nexcmp.com/id/docs/images/administration/smtp-and-emails-02-templates.webp)

## Batasan dan catatan {#limits-and-notes}

- Satu akun SMTP per instalasi. Pelanggan reseller menerima email melalui akun yang sama kecuali reseller dikonfigurasi secara berbeda.
- Batasan pengiriman penyedia berlaku; NexCMP tidak melakukan pelambatan selain mencoba ulang.
- Tanpa SMTP panel tetap berfungsi, tetapi verifikasi pendaftaran dan pengaturan ulang kata sandi tidak dapat diselesaikan oleh pelanggan.

## Pemecahan Masalah {#troubleshooting}

| Gejala | Penyebab | Solusi |
|---|---|---|
| Email uji tidak pernah tiba | Kredensial salah, port diblokir, pengirim tidak berwenang | Periksa `journalctl -u nexcmp-vmd` untuk kesalahan SMTP; coba port 587 dengan STARTTLS; verifikasi alamat From di penyedia. |
| Pesan masuk ke spam | SPF/DKIM/DMARC hilang atau tidak selaras | Publikasikan catatan penyedia dan kirim dari domain tersebut. |
| "failed" di Sent emails | Penyedia menolak pesan | Buka baris untuk respons penyedia. |
| Kolom kata sandi tampak kosong setelah disimpan | Sesuai desain (hanya-tulis) | Label menampilkan "current: set" setelah kata sandi disimpan. |