Como enviar e receber e-mails com a API Mail

Este guia descreve como usar a Mail API para enviar e receber e-mails.

Essa API é compatível com os ambientes de execução de primeira geração e pode ser usada ao fazer upgrade para os ambientes de execução de segunda geração correspondentes. Se você estiver atualizando para o ambiente de execução do Go 1.12+ do App Engine, consulte o guia de migração para saber mais sobre as opções de migração para serviços incluídos legados.

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

Para enviar e-mails do seu aplicativo:

1. Use o tipo mail.Message para definir o remetente, o destinatário, o assunto e o corpo da mensagem.

2. Envie o e-mail com a função mail.Send.

O exemplo a seguir mostra como enviar uma mensagem de e-mail ao usuário como uma confirmação de que foi criada uma nova conta com o aplicativo:

import (
	"bytes"
	"fmt"
	"net/http"

	"google.golang.org/appengine"
	"google.golang.org/appengine/log"
	"google.golang.org/appengine/mail"
)

func confirm(w http.ResponseWriter, r *http.Request) {
	ctx := appengine.NewContext(r)
	addr := r.FormValue("email")
	url := createConfirmationURL(r)
	msg := &mail.Message{
		Sender:  "Example.com Support <[e-mail]>",
		To:      []string{addr},
		Subject: "Confirm your registration",
		Body:    fmt.Sprintf(confirmMessage, url),
	}
	if err := mail.Send(ctx, msg); err != nil {
		log.Errorf(ctx, "Couldn't send email: %v", err)
	}
}

const confirmMessage = `
Thank you for creating an account!
Please confirm your email address by clicking on the link below:

%s
`

Como receber e-mails

É possível configurar seu aplicativo para receber e-mails de endereços no seguinte formato:

[e-mail]

Observação: mesmo que o app seja implantado em um domínio personalizado, não será possível receber e-mails enviados para endereços nesse domínio.

Para receber e-mails:

1. Ative os e-mails recebidos no arquivo app.yaml do seu app:

   inbound_services:
   - mail

2. Configure um gerenciador para processar e-mails recebidos, fornecidos ao seu aplicativo como dados MIME em uma solicitação HTTP POST.

   1. No seu app, registre um gerenciador para o caminho /_ah/mail/:

      func init() {
      	http.HandleFunc("/_ah/mail/", incomingMail)
      }
      

   2. No gerenciador, leia os dados do e-mail de *http.Request:

      func incomingMail(w http.ResponseWriter, r *http.Request) {
      	ctx := appengine.NewContext(r)
      	defer r.Body.Close()
      	var b bytes.Buffer
      	if _, err := b.ReadFrom(r.Body); err != nil {
      		log.Errorf(ctx, "Error reading body: %v", err)
      		return
      	}
      	log.Infof(ctx, "Received mail: %v", b)
      }
      

   Use o pacote net/mail na biblioteca padrão para analisar mensagens de e-mail.