A API Mail fornece duas maneiras de enviar uma mensagem de e-mail: a
função mail.send_mail()
e a classe EmailMessage
.
O envio é assíncrono: a função mail.send_mail()
e o
método EmailMessage.send()
transmitem os dados da mensagem para o serviço de
e-mail e retornam. O serviço de e-mail enfileira a mensagem e tenta enviá-la, repetindo se o servidor de e-mail de destino não estiver disponível. Erros e mensagens de retorno são enviados ao endereço do remetente da mensagem de e-mail.
Antes de começar
Você precisa registrar seus remetentes de e-mails como remetentes autorizados. Para mais informações, consulte quem pode enviar e-mails.
Como enviar e-mails com mail.send_mail()
Para enviar e-mails usando a função mail.send_mail()
, utilize os campos da mensagem de e-mail como parâmetros, incluindo o remetente, os destinatários, o assunto e o corpo da mensagem. Exemplo:
Como enviar e-mails com EmailMessage
Para enviar e-mails usando objetos com a
classe EmailMessage
, transmita os campos da mensagem de e-mail para
o construtor EmailMessage e use os atributos da instância para atualizar a
mensagem.
O método EmailMessage.send()
envia a mensagem de e-mail
representada pelos atributos da instância. Um aplicativo pode reutilizar uma
instância EmailMessage
ao modificar atributos e chamar o método send()
novamente.
No exemplo a seguir, veja como enviar uma mensagem para confirmar um endereço de e-mail:
Como enviar e-mails em massa
Consulte as diretrizes de e-mail em massa para considerações sobre como enviar e-mails em massa.