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 |
---|---|
|
Parâmetros de API |
|
Parâmetros de API |
|
Parâmetros de API |
|
Parâmetros de API |
|
Parâmetros de API, cabeçalhos de e-mail específicos do Amazon SES ou cabeçalhos MIME personalizados ImportanteSe 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, SendTemplatedEmail, SendBulkTemplatedEmail, SendCustomVerificationEmail 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 |
|
Tags de mensagens |
|
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.