Criar uma credencial SMTP (usuário e senha)

A credencial é o usuário e a senha que o seu sistema usa para se conectar ao servidor SMTP da iPORTO. Cada domínio pode ter várias — uma por sistema, por exemplo, para saber de onde veio cada envio e poder desligar uma sem afetar as outras.

Antes de começar

O domínio precisa estar cadastrado — veja Adicionar um domínio de envio. Todo domínio já nasce com a credencial no-reply@ do próprio domínio; se ela basta, você não precisa criar outra.

Passo a passo

1. No painel do SMTP, vá em Infraestrutura → Domínios (SMTP) e abra o domínio.
2. Na aba Credenciais, clique em Nova credencial.
3. Em Usuário SMTP, digite a parte antes do @ — por exemplo, loja para [email protected]. A tela mostra a credencial completa enquanto você digita.
4. Clique em Criar.

Regras do usuário: de 1 a 25 caracteres, só letras minúsculas, números, ponto (.), sublinhado (_) e hífen (-). Ele não pode começar nem terminar com esses símbolos, nem repeti-los em sequência.

O que acontece depois

• A senha é gerada automaticamente — você não escolhe. Ela aparece no card da credencial, na aba Credenciais, em Senha, com um botão para copiar. Copie exatamente como está: maiúsculas e minúsculas fazem diferença.
• Use o botão Testar no card para conferir se a credencial conecta. A tela responde com “Conexão SMTP testada com sucesso!” ou com a falha.
• O Usuário (Username) que o seu sistema deve usar é o endereço completo, como [email protected].

Para trocar a senha

Não há um botão de gerar senha nova. Para trocar — porque a senha vazou, por exemplo —, clique em Excluir no card e crie a credencial de novo com o mesmo usuário. Ela volta com uma senha nova. Atualize o seu sistema logo em seguida: até lá, os envios com a senha antiga falham.

Se der errado

Sintoma	Causa provável	O que fazer
“Esta conta já está em uso.”	Já existe uma credencial com esse usuário neste domínio	Use a existente, ou escolha outro nome
“Você atingiu o limite de contas permitidas para o seu plano…”	O plano permite um número de credenciais e todas estão em uso	Exclua uma que não usa mais, ou mude de plano
O nome não é aceito	Caractere fora da regra (maiúscula, espaço, acento, símbolo no começo ou no fim)	Use só letras minúsculas, números, ., _ e -
Testar falha	A credencial está Inativa, ou o domínio está bloqueado	Confira o Status da credencial e o status do domínio na lista de domínios
O seu sistema recebe “autenticação inválida”	A senha foi copiada errada, ou o usuário foi informado sem o @domínio	Copie a senha pelo botão da tela e use o endereço completo como usuário

Próximos passos

• Conectar seu sistema ao servidor SMTP