---
title: SMTP e modelos de e-mail
description: Configure o e-mail de envio (SMTP), envie uma mensagem de teste, edite os modelos de e-mail em cada idioma e leia o log de entrega.
url: https://nexcmp.com/pt/docs/administration/smtp-and-emails/
applies_to: NexCMP 1.6.1
updated: 2026-11-02
---

# SMTP e modelos de e-mail {#smtp-and-e-mail-templates}

> **Onde no admin:** System › Settings › Email (`/settings/email`) — abas **SMTP** e **Email templates**. Log de entrega: Overview › Support › Sent emails (`/support/emails`).

## O que faz {#what-it-does}

O NexCMP envia e-mails para verificação de cadastro, redefinição de senha, "VM ready" (com a senha inicial), faturas, saldo baixo, renovações, recargas, respostas de suporte e muito mais. Todos passam por **uma conta SMTP fornecida por você**. As mensagens e modelos existem em 16 idiomas; o idioma do cliente é utilizado.

## Requisitos {#requirements}

| Item | Requisito |
|---|---|
| Servidor SMTP | Host, porta e credenciais de qualquer provedor (seu próprio servidor, Brevo, Amazon SES, Mailgun, Google Workspace …) |
| Rede | TCP de saída do servidor NexCMP para o host e a porta SMTP (587 STARTTLS, 465 TLS ou 25) |
| Dominio do remetente | Um domínio controlado por você, com **SPF e DKIM** publicados para o provedor e um registro DMARC |
| Permissão | A conta SMTP deve ter permissão para enviar como o endereço **From** |

::: warning Entregabilidade
E-mails como "VM ready" contêm senhas. Se o SPF/DKIM/DMARC do domínio do remetente não corresponder ao provedor SMTP, eles cairão no spam. A página lembra você disso.
:::

## Preparar o provedor de e-mail {#prepare-the-e-mail-provider}

1. No painel do seu provedor, adicione e verifique seu domínio de envio (por exemplo, `example.com`).
2. Publique os registros DNS SPF, DKIM e DMARC exibidos pelo provedor.
3. Crie um usuário SMTP (ou chave API-SMTP) e anote o host, a porta, o nome de usuário e a senha.

## Conectar no NexCMP {#connect-in-nexcmp}

1. Abra **System › Settings › Email**, aba **SMTP**.
2. Preencha o formulário:

| Campo | Exemplo | Notas |
|---|---|---|
| Host | `smtp.example.net` | Servidor SMTP |
| Porta | `587` | |
| Segurança | STARTTLS (587) | Escolha o modo exigido pelo seu provedor |
| Nome de usuário | `smtp-user` | |
| Senha | (oculto) | Somente gravação: a página mostra apenas se um foi definido |
| E-mail de remetente | `no-reply@example.com` | Deve ser autorizado no provedor |
| Nome de remetente | `Example Cloud` | Usa o nome da sua marca por padrão |
| Responder para (opcional) | `support@example.com` | Para onde vão as respostas dos clientes |

![A aba SMTP de Settings, Email com host, porta, segurança, nome de usuário, campos de remetente e o botão Send test](https://nexcmp.com/pt/docs/images/administration/smtp-and-emails-01-smtp.webp)

3. Clique em **Save**, depois em **Send test** e insira seu próprio endereço.

As configurações são armazenadas em um arquivo com acesso restrito (`smtp.json`, permissão 0600) e apenas o worker em segundo plano `nexcmp-vmd` envia e-mails; o serviço web apenas os enfileira.

## Verificar {#verify}

- A mensagem de teste chega à caixa de entrada (verifique também o spam). Na origem da mensagem, confirme `dkim=pass` e `spf=pass`.
- Abra **Support › Sent emails**: cada mensagem tem um status (enfileirada, enviada, com falha) e o resultado da entrega. Mensagens com falha são reenviadas até 3 vezes.
- Cadastre um cliente de teste no portal e confirme se o e-mail de verificação chega.

## Editar modelos de e-mail {#edit-e-mail-templates}

A aba **Email templates** lista cada modelo por chave, com os idiomas em que ele existe (por exemplo, `verify_email`, `reset_password`, `vm_ready`, `invoice_paid`, `low_balance`, `topup_received`, `ticket_reply`, `scale_up` …).

1. Clique em um modelo e escolha um idioma.
2. Edite o assunto e o corpo. Os espaços reservados são preenchidos quando uma mensagem é enfileirada.
3. Salve. A alteração é aplicada **imediatamente** às mensagens enfileiradas posteriormente.

![A aba Email templates listando as chaves dos modelos e seus idiomas](https://nexcmp.com/pt/docs/images/administration/smtp-and-emails-02-templates.webp)

## Limites e observações {#limits-and-notes}

- Uma conta SMTP por instalação. Os clientes dos revendedores recebem e-mail pela mesma conta, a menos que o revendedor esteja configurado de outra forma.
- Aplicam-se os limites de envio do provedor; o NexCMP não faz limitador de taxa além de tentar novamente.
- Sem SMTP o painel funciona, mas a verificação de cadastro e a redefinição de senha não podem ser concluídas pelos clientes.

## Resolução de problemas {#troubleshooting}

| Sintoma | Causa | Correção |
|---|---|---|
| O e-mail de teste nunca chega | Credenciais incorretas, porta bloqueada, remetente não autorizado | Verifique `journalctl -u nexcmp-vmd` para ver o erro SMTP; tente a porta 587 com STARTTLS; verifique o endereço From no provedor. |
| As mensagens vão para o spam | SPF/DKIM/DMARC ausentes ou desalinhados | Publique os registros do provedor e envie a partir desse domínio. |
| "failed" em Sent emails | O provedor rejeitou a mensagem | Abra a linha para ver a resposta do provedor. |
| O campo de senha parece vazio após salvar | Por design (somente gravação) | O rótulo exibe "current: set" assim que uma senha é armazenada. |