As mensagens de e-mail enviadas para seu app são implementadas como solicitações HTTP contendo dados MIME. Para processar as mensagens de e-mail recebidas, associe os endereços de e-mail aos gerenciadores de script na configuração do app e inclua os gerenciadores no código do app.
O e-mail recebido gera solicitações HTTP, que são passadas aos scripts apropriados. Os scripts que gerenciam os e-mails recebidos precisam residir em seu serviço padrão.
Para mais informações sobre o serviço de e-mail, consulte a Visão geral da API Mail.
Como configurar o aplicativo para receber e-mails
Quando você cria um novo app, o recebimento de e-mail está desativado por padrão. Para ativar o recebimento de e-mail, é preciso modificar o arquivo app.yaml
em seu serviço padrão.
Adicione uma seção
inbound_services
que ative o serviço de recebimento de e-mail. Por exemplo:Se você não ativar o recebimento de e-mail incluindo essa seção no seu arquivo de configuração, o recurso será desativado e as mensagens de e-mail enviadas para o aplicativo serão ignoradas.
Adicione mapeamentos que associem os endereços de e-mail mapeados por URL aos gerenciadores de script.
Para o serviço padrão, o endereço de e-mail de recebimento tem este formato:
[STRING]@[Google Cloud project ID].appspotmail.com
Para serviços não padrão, o endereço de e-mail tem este formato:
[STRING]@[servicename]-dot-[Google Cloud project ID].appspotmail.com
As mensagens de e-mail são enviadas para seu app como solicitações POST HTTP usando o URL a seguir, em que [ADDRESS] é um endereço de e-mail completo, incluindo o nome do domínio:
/_ah/mail/[ADDRESS]
Para manipular os e-mails recebidos em seu app, mapeie os URLs de e-mail para os gerenciadores no arquivo
app.yaml
:No exemplo acima,
/_ah/mail/.+
corresponde a todos os e-mails endereçados ao app. Se preferir, configure vários gerenciadores para endereços de e-mail diferentes, como no exemplo a seguir:URLs de mensagens de e-mail recebidas são comparados a essa lista, do primeiro ao último, e se o URL de uma mensagem de e-mail corresponder a mais de um padrão, o primeiro gerenciador correspondente será o executado. Isso possibilita incluir um gerenciador "pega-tudo" como o último mapeamento. Os gerenciadores são executados no módulo padrão (ou versão do aplicativo).
Como manipular os e-mails recebidos
O SDK do Python define InboundMailHandler
, uma classe webapp para manipular e-mails recebidos. InboundMailHandler
está no pacote google.appengine.ext.webapp.mail_handlers
.
Para usar InboundMailHandler
:
- Crie uma subclasse para
InboundMailHandler
e modifique o métodoreceive()
. - Chame o método
receive()
com um argumento da classeInboundEmailMessage
, definido pelo SDK do Python.
Por exemplo, é possível criar uma instância de InboundEmailMessage
como esta:
InboundMailHandler
contém um método de classe de conveniência mapping()
, que retorna ao gerenciador de e-mails um par correspondente a todos os endereços de e-mail recebidos. É possível, claro, chamá-lo em qualquer subclasse de InboundMailHandler
que você codificar:
O objeto InboundEmailMessage
(mail_message
neste exemplo) contém a mensagem de e-mail. O método bodies()
retorna os corpos dentro da mensagem. Se você chamar bodies()
sem argumentos, ele retornará um iterador que produz corpos HTML primeiro e, em seguida, corpos de texto simples. Se quiser apenas HTML ou apenas texto simples, passe um argumento para bodies()
:
O objeto InboundEmailMessage
inclui atributos para acessar outros campos de mensagens:
subject
contém o assunto da mensagem.sender
é o endereço do remetente, como"Nobody <nobody@example.com>"
.to
é uma lista separada por vírgulas dos principais destinatários da mensagem, por exemplo,"Joe <joe@example.com>, Bill <bill@example.com>"
.cc
contém uma lista separada por vírgulas dos destinatários cc, por exemplo,"Joe <joe@example.com>, Bill <bill@example.com>"
.date
retorna a data da mensagem.attachments
é uma lista de objetosAttachment
, possivelmente vazia.original
é a mensagem completa, incluindo dados não expostos por outros campos, como cabeçalhos de e-mail, na forma deemail.message.Message
do Python (em inglês).
Como simular mensagens recebidas no servidor de desenvolvimento local
Depois de definir o aplicativo para processar o recebimento de e-mail, é possível usar o console do servidor de desenvolvimento para simular mensagens de e-mail recebidas.
- Acesse o servidor de desenvolvimento como administrador. Para isso, navegue até http://localhost:8080/console e clique em Fazer login como administrador.
- No servidor de desenvolvimento, clique em E-mail de entrada na navegação.
Preencha o formulário exibido e clique em Enviar e-mail.
Para saber mais, inclusive como executar o servidor de desenvolvimento, consulte o servidor de desenvolvimento Python.