SMTP y plantillas de correo

Ubicación en el panel de administración: System › Settings › Email (/settings/email) — pestañas SMTP y Email templates. Registro de entregas: Overview › Support › Sent emails (/support/emails).

Qué hace

NexCMP envía correos para la verificación de registro, restablecimiento de contraseña, "VM lista" (con la contraseña inicial), facturas, saldo bajo, renovaciones, recargas, respuestas de soporte y más. Todos se envían mediante una cuenta SMTP que usted proporcione. Los mensajes y plantillas están disponibles en 16 idiomas; se utiliza el idioma del cliente.

Requisitos

Elemento	Requisito
Servidor SMTP	Host, puerto y credenciales de cualquier proveedor (su propio servidor, Brevo, Amazon SES, Mailgun, Google Workspace…)
Red	Conexión TCP saliente desde el servidor NexCMP hacia el host y puerto SMTP (587 STARTTLS, 465 TLS o 25)
Dominio de remitente	Un dominio bajo su control, con SPF y DKIM publicados para el proveedor y un registro DMARC
Permisos	La cuenta SMTP debe tener autorización para enviar con la dirección del campo From

Entregabilidad

Los correos electrónicos como "VM lista" contienen contraseñas. Si el SPF/DKIM/DMARC del dominio remitente no coincide con el proveedor SMTP, llegarán a spam. La página se lo recuerda.

Preparar el proveedor de correo electrónico

1. En el panel de su proveedor, añada y verifique su dominio de envío (por ejemplo, example.com).
2. Publique los registros DNS SPF, DKIM y DMARC que indique el proveedor.
3. Cree un usuario SMTP (o clave API-SMTP) y anote el host, puerto, nombre de usuario y contraseña.

Conectar en NexCMP

1. Abra System › Settings › Email, pestaña SMTP.
2. Complete el formulario:

Campo	Ejemplo	Notas
Host	smtp.example.net	Servidor SMTP
Puerto	587
Security	STARTTLS (587)	Elija el modo que requiera su proveedor
Username	smtp-user
Contraseña	(oculto)	Solo escritura: la página solo muestra si hay una configurada
From email	no-reply@example.com	Debe estar autorizada en el proveedor
From name	Example Cloud	Por defecto toma el nombre de su marca
Reply-To (opcional)	support@example.com	Dirección a la que llegan las respuestas del cliente

3. Haga clic en Save, luego en Send test e ingrese su propia dirección.

La configuración se guarda en un archivo con acceso restringido (smtp.json, modo 0600) y solo el worker en segundo plano nexcmp-vmd envía correos; el servicio web únicamente los pone en cola.

Verificación

• El mensaje de prueba llega a la bandeja de entrada (revise también la carpeta de spam). En el código fuente del mensaje, confirme dkim=pass y spf=pass.
• Abra Support › Sent emails: cada mensaje muestra un estado (en cola, enviado, fallido) y el resultado de la entrega. Los mensajes fallidos se reintentan hasta 3 veces.
• Registre un cliente de prueba en el portal y confirme que llegue el correo de verificación.

Editar plantillas de correo

La pestaña Email templates muestra cada plantilla por su clave, junto con los idiomas en los que está disponible (por ejemplo, verify_email, reset_password, vm_ready, invoice_paid, low_balance, topup_received, ticket_reply, scale_up…).

1. Haga clic en una plantilla y seleccione un idioma.
2. Edite el asunto y el cuerpo. Los marcadores de posición se completan cuando se pone en cola un mensaje.
3. Guarde. El cambio se aplica de forma inmediata a los mensajes que se pongan en cola a partir de ese momento.

Límites y notas

• Una cuenta SMTP por instalación. Los clientes de los revendedores reciben correos mediante la misma cuenta, a menos que el revendedor esté configurado de otro modo.
• Se aplican los límites de envío del proveedor; NexCMP no limita la tasa de envío salvo por los reintentos.
• Sin SMTP el panel funciona, pero los clientes no podrán completar la verificación de registro ni el restablecimiento de contraseña.

Resolución de problemas

Síntoma	Causa	Solución
El correo de prueba nunca llega	Credenciales incorrectas, puerto bloqueado o remitente no autorizado	Revise journalctl -u nexcmp-vmd para ver el error de SMTP; pruebe el puerto 587 con STARTTLS; verifique la dirección From en el proveedor.
Los mensajes van a spam	SPF/DKIM/DMARC ausentes o desalineados	Publique los registros del proveedor y envíe desde ese dominio.
"failed" en Sent emails	El proveedor rechazó el mensaje	Abra la fila para ver la respuesta del proveedor.
El campo de contraseña aparece vacío tras guardar	Por diseño (solo escritura)	La etiqueta muestra "current: set" en cuanto se guarda una contraseña.