Etapa 3: Especificar o conjunto de configurações no envio de e-mail - Amazon Simple Email Service

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Etapa 3: Especificar o conjunto de configurações no envio de e-mail

Depois de criar um conjunto de configurações e adicionar um destino de evento, a última etapa na publicação de evento será enviar seus e-mails.

Para publicar eventos associados a um e-mail, informe o nome do conjunto de configurações para associar ao e-mail. Como opção, informe as tags de mensagens para classificar o e-mail.

Forneça essas informações para o Amazon SES como parâmetros para a API de envio de e-mail, cabeçalhos específicos de e-mail do Amazon SES ou cabeçalhos personalizados em sua mensagem MIME. O método escolhido depende da interface de envio de e-mail que você usa, como mostrado na tabela a seguir.

Interface de envio de e-mails Formas de publicar eventos

SendEmail

Parâmetros de API

SendTemplatedEmail

Parâmetros de API

SendBulkTemplatedEmail

Parâmetros de API

SendCustomVerificationEmail

Parâmetros de API

SendRawEmail

Parâmetros de API, cabeçalhos de e-mail específicos do Amazon SES ou cabeçalhos MIME personalizados

Importante

Se você especifica etiquetas de mensagens usando os cabeçalhos e os parâmetros de API, o Amazon SES usa apenas as etiquetas de mensagens fornecidas pelos parâmetros de API. O Amazon SES não une etiquetas de mensagens especificadas por parâmetros de API e cabeçalhos.

Interface SMTP

Cabeçalhos de e-mail específicos do Amazon SES

As seções a seguir descrevem como especificar o conjunto de configurações e as tags de mensagens usando cabeçalhos e parâmetros de API.

nota

Opcionalmente, você pode incluir as tags de mensagens nos cabeçalhos de seus e-mails. Tags de mensagens podem incluir números de 0-9, as letras A-Z (letras maiúsculas e minúsculas), hífens (-) e sublinhados (_).

Uso de parâmetros de API do Amazon SES

Para usar SendEmail,, SendTemplatedEmailSendBulkTemplatedEmailSendCustomVerificationEmail, ou SendRawEmailcom a publicação de eventos, você especifica o conjunto de configurações e as tags de mensagem passando estruturas de dados chamadas ConfigurationSete MessageTagpara a chamada da API.

Para obter informações sobre o uso da API do Amazon SES, consulte a Referência da API do Amazon Simple Email Service.

Uso de cabeçalhos de e-mail específicos do Amazon SES

Quando você usa a interface SendRawEmail ou SMTP, pode especificar o conjunto de configurações e as etiquetas de mensagem, adicionando cabeçalhos específicos do Amazon SES ao e-mail. O Amazon SES remove os cabeçalhos antes de enviar o e-mail. A tabela a seguir mostra os nomes dos cabeçalhos para usar.

Informações de publicação de eventos Cabeçalho

Conjunto de configurações

X-SES-CONFIGURATION-SET

Tags de mensagens

X-SES-MESSAGE-TAGS

O exemplo a seguir mostra como os cabeçalhos podem aparecer em um e-mail bruto que você envia para o Amazon SES.

X-SES-MESSAGE-TAGS: tagName1=tagValue1, tagName2=tagValue2 X-SES-CONFIGURATION-SET: myConfigurationSet From: sender@example.com To: recipient@example.com Subject: Subject Content-Type: multipart/alternative; boundary="----=_boundary" ------=_boundary Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 7bit body ------=_boundary Content-Type: text/html; charset=UTF-8 Content-Transfer-Encoding: 7bit body ------=_boundary--

Uso de cabeçalhos de e-mail personalizados

Embora seja necessário especificar o nome do conjunto de configurações usando o cabeçalho X-SES-CONFIGURATION-SET específico do Amazon SES, você pode especificar etiquetas de mensagem usando seus próprios cabeçalhos MIME.

nota

Os nomes e os valores de cabeçalho que você usa para publicação de eventos do Amazon SES devem ser em ASCII. Se você especificar um nome ou valor de cabeçalho não ASCII para a publicação de eventos do Amazon SES, a chamada de envio de e-mail ainda será bem-sucedida, mas as métricas do evento não serão emitidas para a Amazon. CloudWatch