Configurando SMTP¶
Visão Geral¶
O Protocolo Simples de Transferência de Correio (SMTP) é o protocolo padrão para envio emails pela Internet. App Builder suporta SMTP nativamente. App Builder usa MailKit, uma biblioteca de cliente de email multiplataforma construída sobre o MimeKit, para enviar email. As notificações de Workflow são um exemplo de App Builder enviando email. Outro exemplo de App Builder o envio de email seria as notificações email enviadas pelo redefinição de senha recurso. Para que qualquer email seja enviado de App Builder, você deve primeiro configurar as configurações de SMTP.
Tabela de Configuração SMTP¶
O servidor SMTP é registrado como um Endpoint de notificação. App Builder vem com um único endpoint de notificação SMTP que os administradores devem configurar para habilitar operações SMTP.
| Propriedade | Valor |
|---|---|
| URI | smtp://mail.exemplo.com |
| Nome de usuário | Nome de usuário |
| Senha | Senha |
| Endereço de remetente padrão | Endereço de email válido que tem permissão para enviar emails por meio do hospedar fornecido. |
Configurando SMTP em App Builder¶
Talvez o aspecto mais importante da configuração adequada do SMTP seja o valor Uri. Dentro App Builder, você precisará configurar os valores Uri e Default From Address para configurar as configurações de SMTP em App Builder:
- Navegue até o IDE
- Nas opções de conexão, clique no botão Servidores de notificação
- Clique no ícone Editar em Endpoints de notificação 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ê digitarásmtps://email-smtp.us-east-1.amazonaws.com. - Insira o valor apropriado Default From Address. Este valor é o endereço email de onde o email foi enviado. App Builder parecerá ter sido enviado 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 |
| SMTPS | O Simple Mail Transfer Protocol Secure (SMTPS) é um método depreciado para proteger conexões SMTP com Transport Layer Security (TLS). |
Importante
App Builder não suporta OAuth 2.0 para autenticação de servidor SMTP.
Solução de Problemas¶
Erro: "O argumento passado não é serializável. Nome do parâmetro: valor"
Este erro pode indicar App Builder não é capaz de autenticar as configurações SMTP, e em particular o valor Default From Address. 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: Endereço de origem"
Este erro pode indicar App Builder não é capaz de autenticar as configurações SMTP, e em particular o valor Default From Address. 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 App Builder não é capaz de autenticar as configurações SMTP, e em particular o valor Uri. Verifique a propriedade Uri para o Notification Endpoint e certifique-se de que ele esteja usando um valor Uri válido.
Erro: "Autenticação necessária"
Este erro pode indicar App Builder não é capaz de 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 User Name e Password.