Formato de e-mail e Amazon SES - Amazon Simple Email Service
Cabeçalho de e-mailCorpo do e-mailInformações de e-mail que você precisa fornecer ao Amazon SES

Formato de e-mail e Amazon SES

Quando um cliente faz uma solicitação para o Amazon SES, o Amazon SES cria uma mensagem de e-mail em conformidade com a especificação de formato de mensagem de Internet (RFC 5322). Um e-mail consiste em um cabeçalho, um corpo e um envelope, como descrito abaixo.

  • Cabeçalho: contém instruções de roteamento e informações sobre a mensagem. Entre os exemplos estão o endereço do remetente, o endereço do destinatário, o assunto e a data. O cabeçalho é semelhante às informações na parte superior de uma carta postal, embora possa conter muitos outros tipos de informação, como o formato da mensagem.

  • Corpo: contém o texto da mensagem.

  • Envelope: contém as informações de roteamento reais que são transmitidas entre o cliente de e-mail e o servidor de e-mail durante a sessão SMTP. Essas informações de envelope de e-mail são semelhantes às informações em um envelope postal. As informações de roteamento do envelope de e-mail normalmente são iguais às informações de roteamento no cabeçalho de e-mail, mas nem sempre. Por exemplo, quando você envia uma cópia oculta (CCO), o endereço real do destinatário (derivado do envelope) não é igual ao endereço "To" que é exibido no cliente de e-mail do destinatário, que é derivado do cabeçalho.

Veja a seguir um exemplo simples de um e-mail. O cabeçalho é seguido por uma linha em branco e pelo corpo do e-mail. O envelope não é mostrado porque é transmitido entre o cliente e o servidor de e-mail durante a sessão SMTP, em vez de uma parte do e-mail em si. 


Received: from abc.smtp-out.amazonses.com (123.45.67.89) by in.example.com (87.65.43.210); Fri, 17 Dec 2010 14:26:22
From: "Andrew" <andrew@example.com>;
To: "Bob" <bob@example.com>
Date: Fri, 17 Dec 2010 14:26:21 -0800
Subject: Hello
Message-ID: <61967230-7A45-4A9D-BEC9-87CBCF2211C9@example.com>
Accept-Language: en-US
Content-Language: en-US
Content-Type: text/plain; charset="us-ascii"
Content-Transfer-Encoding: quoted-printable
MIME-Version: 1.0

Hello, I hope you are having a good day.

-Andrew

As seções a seguir analisam cabeçalhos e corpos de e-mail, e identificam as informações que você precisa fornecer quando usa o Amazon SES.

Cabeçalho de e-mail

Há um cabeçalho por mensagem de e-mail. Cada linha do cabeçalho contém um campo seguido por dois pontos seguidos por um corpo de campo. Quando você lê um e-mail em um cliente de e-mail, o cliente de e-mail normalmente exibe os valores dos seguintes campos de cabeçalho:

  • Para — Os endereços de e-mail dos destinatários da mensagem.

  • CC — Os endereços de e-mail dos destinatários copiados na mensagem.

  • De – O endereço de e-mail do qual o e-mail é enviado.

  • Assunto – Resumo do tópico da mensagem.

  • Data — A data e hora em que o e-mail é enviado.

Há muitos campos de cabeçalho adicionais que fornecem informações de roteamento e descrevem o conteúdo da mensagem. Os clientes de e-mail normalmente não exibem esses campos para o usuário. Para obter uma lista completa dos campos de cabeçalho que o Amazon SES aceita, consulte Campos de cabeçalho do Amazon SES. Quando você usa o Amazon SES, precisa entender especialmente a diferença entre os campos de cabeçalho "From" (De), "Reply-To" (Responder para) e "Return-Path" (Caminho de devolução). Conforme mencionado anteriormente, o endereço "From" é o endereço de e-mail do remetente da mensagem, enquanto "Reply-To" e "Return-Path" são assim:

  • Reply-To (Responder para): o endereço de e-mail para o qual as respostas serão enviadas. Por padrão, as respostas são enviadas para o endereço de e-mail do remetente original.

  • Return-Path (Caminho de devolução): o endereço de e-mail para o qual devoluções e reclamações de mensagem devem ser enviadas. "Return-Path" às vezes é chamado de "envelope de", "remetente do envelope" ou "E-MAIL DE".

    nota

    Quando você usar o Amazon SES, recomendamos que sempre defina o parâmetro "Return-Path" (Caminho de devolução), para tomar conhecimento das devoluções e tomar a ação corretiva se ocorrerem.

Para associar facilmente uma mensagem devolvida ao destinatário pretendido, você pode usar Variable Envelope Return Path (VERP). Com VERP, você define um "Return-Path" diferente para cada destinatário, de modo que, se a mensagem voltar, você saberá automaticamente qual destinatário a devolveu, em vez de precisar abrir a mensagem de devolução e analisá-la.

Corpo do e-mail

O corpo do e-mail contém o texto da mensagem. O corpo pode ser enviado nos seguintes formatos:

  • HTML – Se o cliente de e-mail do destinatário conseguir interpretar HTML, o corpo poderá incluir texto formatado e hiperlinks

  • Texto sem formatação – Se o cliente de e-mail do destinatário for baseado em texto, o corpo não deverá conter caracteres não imprimíveis.

  • HTML e texto sem formatação – Quando você usa ambos os formatos para enviar o mesmo conteúdo em uma única mensagem, o cliente de e-mail do destinatário decide quais exibir, com base em seus recursos.

Se você enviar uma mensagem de e-mail para um grande número de destinatários, faz sentido enviá-la em HTML e texto. Alguns destinatários terão clientes de e-mail habilitados para HTML, para que eles possam clicar em hiperlinks incorporados na mensagem. Os destinatários que usam clientes de e-mail com base em texto precisarão incluir URLs que eles podem copiar e abrir usando um navegador da Web.

Informações de e-mail que você precisa fornecer ao Amazon SES

Quando você envia um e-mail com o Amazon SES, as informações de e-mail que precisa fornecer dependem de como o Amazon SES é chamado. Você pode fornecer uma quantidade mínima de informações e deixar o Amazon SES cuidar de toda a formatação. Ou, se você quiser fazer algo mais avançado, como enviar um anexo, poderá fornecer a mensagem bruta. As seções a seguir analisam o que você precisa fornecer quando envia um e-mail usando a API do Amazon SES, a interface SMTP do Amazon SES ou o console do Amazon SES.

API do Amazon SES

Se você chamar a API do Amazon SES diretamente, chamará a API SendEmail ou SendRawEmail. A quantidade de informações necessárias depende da API que você chamar.

  • A SendEmail API requer que o usuário forneça somente um endereço de origem, endereço de destino, assunto da mensagem e um corpo da mensagem. Opcionalmente, você pode fornecer endereços "Responder para". Quando você chama essa API, o Amazon SES monta automaticamente uma mensagem de e-mail Multipurpose Internet Mail Extensions (MIME) de várias partes adequadamente formatada, otimizada para exibição pelo software cliente de e-mail. Para ter mais informações, consulte Envio de e-mail formatado usando a API do Amazon SES.

  • A API SendRawEmail fornece a flexibilidade de formatar e enviar sua própria mensagem de e-mail bruta ao especificar cabeçalhos, partes MIME e tipos de conteúdo. Normalmente, SendRawEmail é usado por usuários avançados. Você precisa fornecer o corpo da mensagem e todos os campos de cabeçalho que são especificados como exigido na especificação do formato de mensagem de Internet (RFC 5322). Para ter mais informações, consulte Envio de e-mail bruto usando a API v2 do Amazon SES.

Se usar um AWS SDK para chamar a API do Amazon SES, você fornece as informações listadas acima para as funções correspondentes (por exemplo, SendEmail e SendRawEmail para Java).

Para obter mais informações sobre envio de e-mail usando a API do Amazon SES, consulte Uso da API do Amazon SES para enviar e-mail.

Interface SMTP do Amazon SES

Quando você acessa o Amazon SES por meio da interface SMTP, sua aplicação do cliente SMTP monta a mensagem, assim as informações que você precisa fornecer dependem da aplicação que está usando. No mínimo, a troca de SMTP entre um cliente e um servidor requer um endereço de origem, um endereço de destino e os dados da mensagem.

Para obter mais informações sobre envio de e-mail usando a interface SMTP do Amazon SES, consulte Uso da interface SMTP do Amazon SES para enviar e-mail.

Console do Amazon SES

Quando você envia um e-mail usando o console do Amazon SES, a quantidade de informações necessárias depende ter optado por enviar um e-mail formatado ou bruto.

  • Para enviar um e-mail formatado, forneça somente um endereço de origem, endereço de destino, um assunto da mensagem e um corpo da mensagem. O Amazon SES monta automaticamente uma mensagem de e-mail MIME de várias partes adequadamente formatada, otimizada para exibição pelo software cliente de e-mail. Você também pode especificar uma um campo de resposta e um caminho de retorno.

  • Para enviar um e-mail bruto, você fornece o endereço de origem, endereço de destino e o conteúdo da mensagem, que deve conter o corpo da mensagem e todos os campos de cabeçalho que são especificados como exigido na especificação do formato de mensagem de Internet (RFC 5322).