SMTP- und E-Mail-Vorlagen

Wo im Admin: System › Settings › Email (/settings/email) — Registerkarten SMTP und Email templates. Versandprotokoll: Overview › Support › Sent emails (/support/emails).

Funktion

NexCMP versendet E-Mails für Registrierungsverifizierung, Passwort-Reset, „VM ready“ (mit dem anfänglichen Passwort), Rechnungen, geringes Guthaben, Verlängerungen, Aufladungen, Support-Antworten und mehr. All dies läuft über ein von Ihnen bereitgestelltes SMTP-Konto. Nachrichten und Templates sind in 16 Sprachen verfügbar; es wird die Sprache des Kunden verwendet.

Anforderungen

Komponente	Anforderung
SMTP-Server	Host, Port und Anmeldedaten eines beliebigen Anbieters (eigener Server, Brevo, Amazon SES, Mailgun, Google Workspace …)
Netzwerk	Ausgehendes TCP vom NexCMP-Server zum SMTP-Host und -Port (587 STARTTLS, 465 TLS oder 25)
Absenderdomäne	Eine von Ihnen kontrollierte Domain, mit für den Anbieter veröffentlichten SPF und DKIM sowie einem DMARC-Eintrag
Berechtigung	Das SMTP-Konto muss zum Senden als From-Adresse berechtigt sein

Zustellbarkeit

E-Mails wie „VM ready“ enthalten Passwörter. Wenn SPF/DKIM/DMARC der Absenderdomäne nicht zum SMTP-Anbieter passen, landen sie im Spam. Die Seite erinnert Sie daran.

E-Mail-Anbieter vorbereiten

1. Fügen Sie im Panel Ihres Anbieters Ihre Absenderdomain hinzu und verifizieren Sie sie (z. B. example.com).
2. Veröffentlichen Sie die vom Anbieter angezeigten SPF-, DKIM- und DMARC-DNS-Einträge.
3. Erstellen Sie einen SMTP-Benutzer (oder API-SMTP-Key) und notieren Sie Host, Port, Benutzernamen und Passwort.

In NexCMP verbinden

1. Öffnen Sie System › Settings › Email, Registerkarte SMTP.
2. Füllen Sie das Formular aus:

Feld	Beispiel	Hinweise
Host	smtp.example.net	SMTP-Server
Port	587
Sicherheit	STARTTLS (587)	Wählen Sie den Modus, den Ihr Anbieter erfordert
Benutzername	smtp-user
Passwort	(versteckt)	Nur Schreiben: Die Seite zeigt nur an, ob einer festgelegt ist
Absender-E-Mail	no-reply@example.com	Muss beim Anbieter autorisiert sein
Absendername	Example Cloud	Standardmäßig Ihr Markenname
Antwort an (optional)	support@example.com	Wohin Kundenantworten gehen

3. Klicken Sie auf Save, dann auf Send test und geben Sie Ihre eigene Adresse ein.

Die Einstellungen werden in einer zugriffsgeschützten Datei gespeichert (smtp.json, Modus 0600) und nur der Hintergrunddienst nexcmp-vmd versendet E-Mails; der Webservice stellt sie nur in die Warteschlange.

Verifizierung

• Die Testnachricht kommt im Posteingang an (überprüfen Sie auch den Spam-Ordner). Bestätigen Sie im Nachrichtenquelltext dkim=pass und spf=pass.
• Öffnen Sie Support › Sent emails: Jede Nachricht hat einen Status (in Warteschlange, gesendet, fehlgeschlagen) und das Zustellungsergebnis. Fehlgeschlagene Nachrichten werden bis zu 3 Mal erneut versucht.
• Registrieren Sie einen Testkunden im Portal und vergewissern Sie sich, dass die Bestätigungs-E-Mail ankommt.

Edit e-mail templates

Der Tab Email templates listet jedes Template nach Schlüssel auf, zusammen mit den Sprachen, in denen es verfügbar ist (zum Beispiel verify_email, reset_password, vm_ready, invoice_paid, low_balance, topup_received, ticket_reply, scale_up …).

1. Klicken Sie auf ein Template und wählen Sie eine Sprache aus.
2. Bearbeiten Sie Betreff und Text. Platzhalter werden ausgefüllt, wenn eine Nachricht in die Warteschlange gestellt wird.
3. Speichern Sie. Die Änderung gilt sofort für danach in die Warteschlange gestellte Nachrichten.

Grenzwerte und Hinweise

• Ein SMTP-Konto pro Installation. Kunden von Resellern erhalten E-Mails über dasselbe Konto, es sei denn, für den Reseller ist etwas anderes konfiguriert.
• Es gelten die Versandlimits des Anbieters; NexCMP drosselt den Versand nicht über erneute Versuche hinaus.
• Ohne SMTP funktioniert das Panel, aber Kunden können die Registrierungsverifizierung und das Zurücksetzen des Passworts nicht abschließen.

Fehlerbehebung

Symptom	Ursache	Behebung
Test-E-Mail kommt nie an	Falsche Anmeldedaten, Port gesperrt, Absender nicht autorisiert	Überprüfen Sie journalctl -u nexcmp-vmd auf den SMTP-Fehler; versuchen Sie Port 587 mit STARTTLS; verifizieren Sie die From-Adresse beim Anbieter.
Messages go to spam	SPF/DKIM/DMARC fehlen oder stimmen nicht überein	Veröffentlichen Sie die Datensätze des Anbieters und senden Sie von dieser Domain.
"failed" in Gesendete E-Mails	Anbieter hat die Nachricht abgelehnt	Öffnen Sie die Zeile für die Antwort des Anbieters.
Passwortfeld sieht nach dem Speichern leer aus	By design (write-only)	Das Label zeigt "current: set", sobald ein Passwort gespeichert ist.