Configurando SMTP¶
Visão Geral¶
Simple Mail Transfer Protocol (SMTP) é o protocolo padrão para envio emails pela Internet. O Vinyl oferece suporte nativo a SMTP. Vinyl usa MailKit, uma biblioteca de cliente de email multiplataforma construída sobre MimeKit, para enviar email. As notificações de Workflow são um exemplo de envio de correspondência do Vinyl. Outro exemplo de envio de email do Vinyl seriam as notificações por email enviadas pelo Redefinir senha recurso. Para que qualquer email seja enviado do Vinyl, você deve primeiro definir as configurações de SMTP.
Tabela de Configuração SMTP¶
O servidor SMTP está registrado como Notification Endpoint. O Vinyl é fornecido com um único endpoint de notificação SMTP que os administradores devem configurar para permitir operações SMTP.
| Propriedade | Valor |
|---|---|
| URI | smtp://mail.exemplo.com |
| Nome de usuário | Nome de usuário |
| Senha | Senha |
| Endereço De Padrão | Endereço email válido que tem permissão para enviar emails por meio do hospedar fornecido. |
Configurando SMTP no Vinyl¶
Talvez o aspecto mais importante da configuração adequada do SMTP seja o valor Uri. No Vinyl, você precisará configurar os valores Uri e Default From Address Para definir as configurações de SMTP no Vinyl:
- Navegue até o IDE
- Nas opções de conexão, clique no botão Servidores de notificação
- Clique no ícone Editar em Notification Endpoints para o registro SMTP
- Insira o valor Uri apropriado. O formato deste valor é crítico e deve ser
smtp://<hostname>ousmtps://<hostname>. Veja abaixo uma lista de protocolos suportados. Se estiver enviando email de um servidor hospedado na região AWS US-East-1, por exemplo, você inserirásmtps://email-smtp.us-east-1.amazonaws.com. - Insira o valor Endereço De Padrão apropriado. Este valor é o endereço email de onde as mensagens enviadas do Vinyl parecerão ter sido enviadas e deve ser um endereço válido por meio do hospedar fornecido.
- Clique no botão Continuar para salvar suas alterações
Protocolos Suportados¶
| Protocolo | Definição |
|---|---|
| SMTP | Simple Mail Transfer Protocol (SMTP) é um padrão da Internet para transmissão de correio eletrônico. Portas padrão: 25, 587, 465 |
| SMTP | Simple Mail Transfer Protocol Secure (SMTPS) é um método obsoleto para proteger conexões SMTP com Transport Layer Security (TLS). |
Importante
O Vinyl não suporta OAuth 2.0 para autenticação de servidor SMTP.
Solução de Problemas¶
Erro: "O argumento transmitido não é serializável. Nome do parâmetro: valor"
Este erro pode indicar que o Vinyl não consegue autenticar as configurações SMTP e, em particular, o valor do endereço De padrão. Verifique a propriedade DefaultFromAddress para o Notification Endpoint e certifique-se de que ele esteja usando um endereço email válido para o hospedar fornecido.
Erro: "O valor não pode ser nulo. ParameterName: From Address"
Este erro pode indicar que o Vinyl não consegue autenticar as configurações SMTP e, em particular, o valor do endereço De padrão. Verifique a propriedade DefaultFromAddress para o Notification Endpoint e certifique-se de que ele esteja usando um endereço email válido para o hospedar fornecido e não nulo ou vazio.
Erro: "Esquema de URI desconhecido. Nome do parâmetro: uri"
Este erro pode indicar que o Vinyl não consegue autenticar as configurações SMTP e, em particular, o valor Uri. Verifique a propriedade Uri do Notification Endpoint e certifique-se de que ela esteja usando um valor Uri válido.
Erro: "Autenticação necessária"
Este erro pode indicar que o Vinyl não consegue autenticar as configurações SMTP e, em particular, a propriedade UserName ou Password relacionada à configuração SMTP. Verifique se as configurações do Notification Endpoint têm os valores corretos definidos para Nome de usuário e Senha.