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 SendEmailSendTemplatedEmailSendBulkTemplatedEmailSendCustomVerificationEmail ou SendRawEmail com a publicação de eventos, especifique o conjunto de configurações e as etiquetas de mensagem, transmitindo estruturas de dados denominadas ConfigurationSet e MessageTag para a chamada de 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 do cabeçalho para publicação de eventos do Amazon SES que não sejam em ASCII, a chamada de envio de e-mail ainda ocorre, mas as métricas de evento não são emitidas para o Amazon CloudWatch.