Ações do AWS SES

Esta página fornece uma referência para as ações do AWS Simple Email Service (SES) disponíveis no catálogo de ações de automação de fluxo de trabalho. Use estas ações para criar, atualizar, recuperar e excluir modelos de e-mail e para enviar e-mails pelo Amazon SES.

Pré-requisitos

Para pré-requisitos e configuração de credenciais, consulte Configurar credenciais da AWS.

Criar um modelo

O identificador da ação é aws.ses.createTemplate.

Cria um modelo de e-mail no Amazon SES para o envio de e-mails com modelo.

Importante

Pelo menos um de textPart ou htmlPart deve ser fornecido. O SES exige que o modelo tenha conteúdo de corpo em pelo menos um formato.

A tabela a seguir descreve os campos de entrada para esta ação.

Entrada	Tipo	Descrição	Exemplo
`awsRoleArn`	Corda	Opcional. ARN da função do IAM a ser assumida para chamadas de API da AWS.	`arn:aws:iam::123456789012:role/my-workflow-role`
`awsAccessKeyId`	Corda	Opcional. ID da chave de acesso da AWS. Passe como um segredo.	`${{ :secrets:awsAccessKeyId }}`
`awsSecretAccessKey`	Corda	Opcional. Chave de acesso secreta da AWS. Passe como um segredo.	`${{ :secrets:awsSecretAccessKey }}`
`awsSessionToken`	Corda	Opcional. Token de sessão temporário para autenticação STS. Passe como um segredo.	`${{ :secrets:awsSessionToken }}`
`region`	Corda	Obrigatório. Região da AWS onde o modelo será criado.	`us-east-2`
`templateName`	Corda	Obrigatório. Nome do modelo a ser criado.	`WelcomeEmailTemplate`
`subjectPart`	Corda	Obrigatório. Linha de assunto para e-mails enviados com este modelo. Oferece suporte a variáveis de modelo usando a sintaxe `{{variableName}}` .	`Welcome to Our Service`
`textPart`	Corda	Opcional. Versão em texto simples do corpo do e-mail. Pelo menos um entre `textPart` ou `htmlPart` deve ser fornecido.	`Hello, welcome aboard.`
`htmlPart`	Corda	Opcional. Versão em HTML do corpo do e-mail. Pelo menos um entre `textPart` ou `htmlPart` deve ser fornecido.	`<h1>Hello</h1><p>Welcome aboard.</p>`
`selectors`	Lista	Opcional. Seletores JQ para extrair campos específicos da saída da ação.	`[{"name": "created", "expression": ".success"}]`

A tabela a seguir descreve os campos de saída para esta ação.

Saída	Tipo	Exemplo
`response`	Objeto	Consulte a referência do boto3 para create_template . Retorna um objeto vazio `{}` em caso de sucesso.
`success`	Boleano	`true` ou `false`
`errorMessage`	Corda	`"An error occurred (AlreadyExistsException) when calling the CreateTemplate operation: Template WelcomeEmailTemplate already exists"`

Saída

Tipo

Exemplo

response

Objeto

Consulte a

referência do boto3 para create_template

. Retorna um objeto vazio

{}

em caso de sucesso.

success

Boleano

true

false

errorMessage

Corda

"An error occurred (AlreadyExistsException) when calling the CreateTemplate operation: Template WelcomeEmailTemplate already exists"

Exemplo de fluxo de trabalho

name: create-ses-template
description: 'Create an email template in Amazon SES'
steps:
  - name: createWelcomeTemplate
    type: action
    action: aws.ses.createTemplate
    version: '1'
    inputs:
      awsRoleArn: "arn:aws:iam::123456789012:role/my-workflow-role"
      region: us-east-2
      templateName: WelcomeEmailTemplate
      subjectPart: "Welcome to Our Service"
      textPart: "Hello, welcome aboard."
      htmlPart: "<h1>Hello</h1><p>Welcome aboard.</p>"
    next: end

Atualizar um modelo

O identificador da ação é aws.ses.updateTemplate.

Atualiza um modelo de e-mail existente no Amazon SES. O modelo já deve existir.

Importante

Pelo menos um de textPart ou htmlPart deve ser fornecido. O SES exige que o modelo tenha conteúdo de corpo em pelo menos um formato.

A tabela a seguir descreve os campos de entrada para esta ação.

Entrada	Tipo	Descrição	Exemplo
`awsRoleArn`	Corda	Opcional. ARN da função do IAM a ser assumida para chamadas de API da AWS.	`arn:aws:iam::123456789012:role/my-workflow-role`
`awsAccessKeyId`	Corda	Opcional. ID da chave de acesso da AWS. Passe como um segredo.	`${{ :secrets:awsAccessKeyId }}`
`awsSecretAccessKey`	Corda	Opcional. Chave de acesso secreta da AWS. Passe como um segredo.	`${{ :secrets:awsSecretAccessKey }}`
`awsSessionToken`	Corda	Opcional. Token de sessão temporário para autenticação STS. Passe como um segredo.	`${{ :secrets:awsSessionToken }}`
`region`	Corda	Obrigatório. Região da AWS onde o modelo existe.	`us-east-2`
`templateName`	Corda	Obrigatório. Nome do modelo a ser atualizado. Já deve existir.	`WelcomeEmailTemplate`
`subjectPart`	Corda	Obrigatório. Linha de assunto atualizada. Oferece suporte a variáveis de modelo usando a sintaxe `{{variableName}}` .	`Welcome to Our Service (Updated)`
`textPart`	Corda	Opcional. Versão em texto simples atualizada do corpo do e-mail. Pelo menos um entre `textPart` ou `htmlPart` deve ser fornecido.	`Hi, thanks again for signing up.`
`htmlPart`	Corda	Opcional. Versão em HTML atualizada do corpo do e-mail. Pelo menos um entre `textPart` ou `htmlPart` deve ser fornecido.	`<h1>Welcome!</h1><p>Thanks again for signing up.</p>`
`selectors`	Lista	Opcional. Seletores JQ para extrair campos específicos da saída da ação.	`[{"name": "updated", "expression": ".success"}]`

A tabela a seguir descreve os campos de saída para esta ação.

Saída	Tipo	Exemplo
`response`	Objeto	Consulte a referência do boto3 para update_template . Retorna um objeto vazio `{}` em caso de sucesso.
`success`	Boleano	`true` ou `false`
`errorMessage`	Corda	`"An error occurred (TemplateDoesNotExistException) when calling the UpdateTemplate operation: Template (WelcomeEmailTemplate) does not exist"`

Saída

Tipo

Exemplo

response

Objeto

Consulte a

referência do boto3 para update_template

. Retorna um objeto vazio

{}

em caso de sucesso.

success

Boleano

true

false

errorMessage

Corda

"An error occurred (TemplateDoesNotExistException) when calling the UpdateTemplate operation: Template (WelcomeEmailTemplate) does not exist"

Exemplo de fluxo de trabalho

name: update-ses-template
description: 'Update an email template in Amazon SES'
steps:
  - name: updateWelcomeTemplate
    type: action
    action: aws.ses.updateTemplate
    version: '1'
    inputs:
      awsRoleArn: "arn:aws:iam::123456789012:role/my-workflow-role"
      region: us-east-2
      templateName: WelcomeEmailTemplate
      subjectPart: "Welcome to Our Service (Updated)"
      textPart: "Hi, thanks again for signing up."
      htmlPart: "<h1>Welcome!</h1><p>Thanks again for signing up.</p>"
    next: end

Excluir um modelo

O identificador da ação é aws.ses.deleteTemplate.

Exclui um modelo de e-mail do Amazon SES. Esta ação é idempotente — ela é bem-sucedida mesmo se o modelo nomeado não existir.

A tabela a seguir descreve os campos de entrada para esta ação.

Entrada	Tipo	Descrição	Exemplo
`awsRoleArn`	Corda	Opcional. ARN da função do IAM a ser assumida para chamadas de API da AWS.	`arn:aws:iam::123456789012:role/my-workflow-role`
`awsAccessKeyId`	Corda	Opcional. ID da chave de acesso da AWS. Passe como um segredo.	`${{ :secrets:awsAccessKeyId }}`
`awsSecretAccessKey`	Corda	Opcional. Chave de acesso secreta da AWS. Passe como um segredo.	`${{ :secrets:awsSecretAccessKey }}`
`awsSessionToken`	Corda	Opcional. Token de sessão temporário para autenticação STS. Passe como um segredo.	`${{ :secrets:awsSessionToken }}`
`region`	Corda	Obrigatório. Região da AWS onde o modelo existe.	`us-east-2`
`templateName`	Corda	Obrigatório. Nome do modelo a ser excluído.	`WelcomeEmailTemplate`
`selectors`	Lista	Opcional. Seletores JQ para extrair campos específicos da saída da ação.	`[{"name": "deleted", "expression": ".success"}]`

A tabela a seguir descreve os campos de saída para esta ação.

Saída	Tipo	Exemplo
`response`	Objeto	Consulte a referência do boto3 para delete_template . Retorna um objeto vazio `{}` em caso de sucesso.
`success`	Boleano	`true` ou `false`
`errorMessage`	Corda	`"An error occurred (AccessDenied) when calling the DeleteTemplate operation: User is not authorized to perform ses:DeleteTemplate"`

Saída

Tipo

Exemplo

response

Objeto

Consulte a

referência do boto3 para delete_template

. Retorna um objeto vazio

{}

em caso de sucesso.

success

Boleano

true

false

errorMessage

Corda

"An error occurred (AccessDenied) when calling the DeleteTemplate operation: User is not authorized to perform ses:DeleteTemplate"

Exemplo de fluxo de trabalho

name: delete-ses-template
description: 'Delete an email template from Amazon SES'
steps:
  - name: deleteWelcomeTemplate
    type: action
    action: aws.ses.deleteTemplate
    version: '1'
    inputs:
      awsRoleArn: "arn:aws:iam::123456789012:role/my-workflow-role"
      region: us-east-2
      templateName: WelcomeEmailTemplate
    next: end

Obter um modelo

O identificador da ação é aws.ses.getTemplate.

Recupera um modelo de e-mail existente do Amazon SES, incluindo seu assunto, corpo em texto simples e corpo em HTML.

A tabela a seguir descreve os campos de entrada para esta ação.

Entrada	Tipo	Descrição	Exemplo
`awsRoleArn`	Corda	Opcional. ARN da função do IAM a ser assumida para chamadas de API da AWS.	`arn:aws:iam::123456789012:role/my-workflow-role`
`awsAccessKeyId`	Corda	Opcional. ID da chave de acesso da AWS. Passe como um segredo.	`${{ :secrets:awsAccessKeyId }}`
`awsSecretAccessKey`	Corda	Opcional. Chave de acesso secreta da AWS. Passe como um segredo.	`${{ :secrets:awsSecretAccessKey }}`
`awsSessionToken`	Corda	Opcional. Token de sessão temporário para autenticação STS. Passe como um segredo.	`${{ :secrets:awsSessionToken }}`
`region`	Corda	Obrigatório. Região da AWS onde o modelo existe.	`us-east-2`
`templateName`	Corda	Obrigatório. Nome do modelo a ser recuperado.	`WelcomeEmailTemplate`
`selectors`	Lista	Opcional. Seletores JQ para extrair campos específicos da saída da ação.	`[{"name": "template", "expression": ".response.Template"}]`

A tabela a seguir descreve os campos de saída para esta ação.

Saída	Tipo	Exemplo
`response`	Objeto	Consulte a referência do boto3 para get_template . Contém um objeto `Template` com `TemplateName` , `SubjectPart` , `TextPart` e `HtmlPart` .
`success`	Boleano	`true` ou `false`
`errorMessage`	Corda	`"An error occurred (TemplateDoesNotExistException) when calling the GetTemplate operation: Template (WelcomeEmailTemplate) does not exist"`

Saída

Tipo

Exemplo

response

Objeto

Consulte a

referência do boto3 para get_template

. Contém um objeto

Template

com

TemplateName

SubjectPart

TextPart

HtmlPart

success

Boleano

true

false

errorMessage

Corda

"An error occurred (TemplateDoesNotExistException) when calling the GetTemplate operation: Template (WelcomeEmailTemplate) does not exist"

Exemplo de fluxo de trabalho

name: get-ses-template
description: 'Retrieve an email template from Amazon SES'
steps:
  - name: getWelcomeTemplate
    type: action
    action: aws.ses.getTemplate
    version: '1'
    inputs:
      awsRoleArn: "arn:aws:iam::123456789012:role/my-workflow-role"
      region: us-east-2
      templateName: WelcomeEmailTemplate
      selectors:
        - name: template
          expression: ".response.Template"
    next: end

Listar modelos

O identificador da ação é aws.ses.listTemplates.

Lista os modelos de e-mail presentes na sua conta do Amazon SES na região atual.

A tabela a seguir descreve os campos de entrada para esta ação.

Entrada	Tipo	Descrição	Exemplo
`awsRoleArn`	Corda	Opcional. ARN da função do IAM a ser assumida para chamadas de API da AWS.	`arn:aws:iam::123456789012:role/my-workflow-role`
`awsAccessKeyId`	Corda	Opcional. ID da chave de acesso da AWS. Passe como um segredo.	`${{ :secrets:awsAccessKeyId }}`
`awsSecretAccessKey`	Corda	Opcional. Chave de acesso secreta da AWS. Passe como um segredo.	`${{ :secrets:awsSecretAccessKey }}`
`awsSessionToken`	Corda	Opcional. Token de sessão temporário para autenticação STS. Passe como um segredo.	`${{ :secrets:awsSessionToken }}`
`region`	Corda	Obrigatório. Região da AWS da qual listar os modelos.	`us-east-2`
`maxItems`	Inteiro	Opcional. Número máximo de modelos a serem retornados por página. Deve estar entre 1 e 100. O padrão é 10.	`50`
`nextToken`	Corda	Opcional. Token de paginação de uma resposta anterior para recuperar a próxima página de resultados.	`some-pagination-token`
`selectors`	Lista	Opcional. Seletores JQ para extrair campos específicos da saída da ação.	`[{"name": "templates", "expression": ".response.TemplatesMetadata"}]`

A tabela a seguir descreve os campos de saída para esta ação.

Saída	Tipo	Exemplo
`response`	Objeto	Consulte a referência do boto3 para list_templates . Contém uma matriz `TemplatesMetadata` de objetos com `Name` e `CreatedTimestamp` , além de um `NextToken` para paginação.
`success`	Boleano	`true` ou `false`
`errorMessage`	Corda	`"An error occurred (AccessDenied) when calling the ListTemplates operation: User is not authorized to perform ses:ListTemplates"`

Saída

Tipo

Exemplo

response

Objeto

Consulte a

referência do boto3 para list_templates

. Contém uma matriz

TemplatesMetadata

de objetos com

Name

CreatedTimestamp

, além de um

NextToken

para paginação.

success

Boleano

true

false

errorMessage

Corda

"An error occurred (AccessDenied) when calling the ListTemplates operation: User is not authorized to perform ses:ListTemplates"

Exemplo de fluxo de trabalho

name: list-ses-templates
description: 'List email templates in Amazon SES'
steps:
  - name: listSesTemplates
    type: action
    action: aws.ses.listTemplates
    version: '1'
    inputs:
      awsRoleArn: "arn:aws:iam::123456789012:role/my-workflow-role"
      region: us-east-2
      maxItems: 50
      selectors:
        - name: templates
          expression: ".response.TemplatesMetadata"
    next: end

Enviar um e-mail

O identificador da ação é aws.ses.sendEmail.

Envia um e-mail pelo Amazon SES. O endereço source deve ser uma identidade verificada do SES.

Importante

Pelo menos um entre toAddresses, ccAddresses ou bccAddresses deve ser fornecido, e pelo menos um entre bodyText ou bodyHtml deve ser fornecido. A contagem combinada de destinatários em todos os três campos de endereço não pode exceder 50. Todos os endereços de e-mail devem ser ASCII de 7 bits — os domínios Unicode devem ser codificados em Punycode.

A tabela a seguir descreve os campos de entrada para esta ação.

Entrada	Tipo	Descrição	Exemplo
`awsRoleArn`	Corda	Opcional. ARN da função do IAM a ser assumida para chamadas de API da AWS.	`arn:aws:iam::123456789012:role/my-workflow-role`
`awsAccessKeyId`	Corda	Opcional. ID da chave de acesso da AWS. Passe como um segredo.	`${{ :secrets:awsAccessKeyId }}`
`awsSecretAccessKey`	Corda	Opcional. Chave de acesso secreta da AWS. Passe como um segredo.	`${{ :secrets:awsSecretAccessKey }}`
`awsSessionToken`	Corda	Opcional. Token de sessão temporário para autenticação STS. Passe como um segredo.	`${{ :secrets:awsSessionToken }}`
`region`	Corda	Obrigatório. Região da AWS a partir da qual o e-mail será enviado.	`us-east-2`
`source`	Corda	Obrigatório. Endereço de e-mail do remetente. Deve ser uma identidade verificada do SES.	`no-reply@example.com`
`subject`	Corda	Obrigatório. Linha de assunto do e-mail.	`Welcome to Our Service`
`toAddresses`	Lista	Opcional. Lista de endereços de destinatários Para. Pelo menos um entre `toAddresses` , `ccAddresses` ou `bccAddresses` deve ser fornecido.	`["recipient@example.com"]`
`ccAddresses`	Lista	Opcional. Lista de endereços de destinatários CC. Pelo menos um entre `toAddresses` , `ccAddresses` ou `bccAddresses` deve ser fornecido.	`["cc@example.com"]`
`bccAddresses`	Lista	Opcional. Lista de endereços de destinatários Cco. Pelo menos um de `toAddresses` , `ccAddresses` ou `bccAddresses` deve ser fornecido.	`["bcc@example.com"]`
`bodyText`	Corda	Opcional. Corpo do e-mail em texto simples. Pelo menos um entre `bodyText` ou `bodyHtml` deve ser fornecido.	`Hi there, thanks for signing up.`
`bodyHtml`	Corda	Opcional. Corpo do e-mail em HTML. Pelo menos um entre `bodyText` ou `bodyHtml` deve ser fornecido.	`<h1>Welcome!</h1><p>Thanks for signing up.</p>`
`subjectCharset`	Corda	Opcional. Conjunto de caracteres para o assunto. O padrão é `UTF-8` .	`UTF-8`
`bodyTextCharset`	Corda	Opcional. Conjunto de caracteres para o corpo em texto simples. O padrão é `UTF-8` .	`UTF-8`
`bodyHtmlCharset`	Corda	Opcional. Conjunto de caracteres para o corpo em HTML. O padrão é `UTF-8` .	`UTF-8`
`replyToAddresses`	Lista	Opcional. Endereços de resposta.	`["reply-to@example.com"]`
`returnPath`	Corda	Opcional. Endereço de e-mail para notificações de devolução e reclamação.	`bounces@example.com`
`sourceArn`	Corda	Opcional. ARN de uma identidade verificada a ser usada para autorização de envio.	`arn:aws:ses:us-east-2:123456789012:identity/example.com`
`returnPathArn`	Corda	Opcional. ARN de uma identidade verificada associada a `returnPath` , para autorização de envio.	`arn:aws:ses:us-east-2:123456789012:identity/example.com`
`configurationSetName`	Corda	Opcional. Nome de um conjunto de configuração a ser usado para este envio.	`my-configuration-set`
`tags`	Lista	Opcional. Tags de mensagem como uma lista de objetos `{"Name": "...", "Value": "..."}` .	`[{"Name": "purpose", "Value": "welcome-email"}]`
`selectors`	Lista	Opcional. Seletores JQ para extrair campos específicos da saída da ação.	`[{"name": "messageId", "expression": ".response.MessageId"}]`

A tabela a seguir descreve os campos de saída para esta ação.

Saída	Tipo	Exemplo
`response`	Objeto	Consulte a referência do boto3 para send_email . Contém uma string `MessageId` em caso de sucesso.
`success`	Boleano	`true` ou `false`
`errorMessage`	Corda	`"An error occurred (MessageRejected) when calling the SendEmail operation: Email address is not verified. The following identities failed the check in region US-EAST-2: sender@example.com"`

Saída

Tipo

Exemplo

response

Objeto

Consulte a

referência do boto3 para send_email

. Contém uma string

MessageId

em caso de sucesso.

success

Boleano

true

false

errorMessage

Corda

"An error occurred (MessageRejected) when calling the SendEmail operation: Email address is not verified. The following identities failed the check in region US-EAST-2: sender@example.com"

Exemplo de fluxo de trabalho

name: send-ses-email
description: 'Send an email through Amazon SES'
steps:
  - name: sendWelcomeEmail
    type: action
    action: aws.ses.sendEmail
    version: '1'
    inputs:
      awsRoleArn: "arn:aws:iam::123456789012:role/my-workflow-role"
      region: us-east-2
      source: no-reply@example.com
      toAddresses:
        - recipient@example.com
      subject: "Welcome to Our Service"
      bodyText: "Hi there, thanks for signing up."
      bodyHtml: "<h1>Welcome!</h1><p>Thanks for signing up.</p>"
      selectors:
        - name: messageId
          expression: ".response.MessageId"
    next: end

Enviar um e-mail com modelo

O identificador da ação é aws.ses.sendTemplatedEmail.

Envia um e-mail usando um modelo existente do Amazon SES, substituindo os valores de espaço reservado de templateData no modelo. O endereço source e o template referenciado já devem existir.

Importante

Pelo menos um entre toAddresses, ccAddresses ou bccAddresses deve ser fornecido. Omitir todos os três resulta em um erro da API da AWS no momento do envio. A contagem combinada de destinatários não pode exceder 50, e templateData não pode exceder 262.144 caracteres.

A tabela a seguir descreve os campos de entrada para esta ação.

Entrada	Tipo	Descrição	Exemplo
`awsRoleArn`	Corda	Opcional. ARN da função do IAM a ser assumida para chamadas de API da AWS.	`arn:aws:iam::123456789012:role/my-workflow-role`
`awsAccessKeyId`	Corda	Opcional. ID da chave de acesso da AWS. Passe como um segredo.	`${{ :secrets:awsAccessKeyId }}`
`awsSecretAccessKey`	Corda	Opcional. Chave de acesso secreta da AWS. Passe como um segredo.	`${{ :secrets:awsSecretAccessKey }}`
`awsSessionToken`	Corda	Opcional. Token de sessão temporário para autenticação STS. Passe como um segredo.	`${{ :secrets:awsSessionToken }}`
`region`	Corda	Obrigatório. Região da AWS a partir da qual o e-mail será enviado.	`us-east-2`
`source`	Corda	Obrigatório. Endereço de e-mail do remetente. Deve ser uma identidade verificada do SES.	`no-reply@example.com`
`template`	Corda	Obrigatório. Nome do modelo do SES a ser usado. Já deve existir.	`WelcomeEmailTemplate`
`templateData`	Corda	Obrigatório. String JSON de pares de valor principal para substituir nos espaços reservados do modelo. Máximo de 262.144 caracteres.	`{"name": "Alice"}`
`toAddresses`	Lista	Opcional. Lista de endereços de destinatários Para. Pelo menos um entre `toAddresses` , `ccAddresses` ou `bccAddresses` deve ser fornecido.	`["recipient@example.com"]`
`ccAddresses`	Lista	Opcional. Lista de endereços de destinatários CC. Pelo menos um entre `toAddresses` , `ccAddresses` ou `bccAddresses` deve ser fornecido.	`["cc@example.com"]`
`bccAddresses`	Lista	Opcional. Lista de endereços de destinatários Cco. Pelo menos um de `toAddresses` , `ccAddresses` ou `bccAddresses` deve ser fornecido.	`["bcc@example.com"]`
`replyToAddresses`	Lista	Opcional. Endereços de resposta.	`["reply-to@example.com"]`
`returnPath`	Corda	Opcional. Endereço de e-mail para notificações de devolução e reclamação.	`bounces@example.com`
`sourceArn`	Corda	Opcional. ARN de uma identidade verificada a ser usada para autorização de envio.	`arn:aws:ses:us-east-2:123456789012:identity/example.com`
`returnPathArn`	Corda	Opcional. ARN de uma identidade verificada associada a `returnPath` , para autorização de envio.	`arn:aws:ses:us-east-2:123456789012:identity/example.com`
`templateArn`	Corda	Opcional. ARN de conta cruzada do modelo, como uma alternativa a `template` .	`arn:aws:ses:us-east-2:123456789012:template/WelcomeEmailTemplate`
`configurationSetName`	Corda	Opcional. Nome de um conjunto de configuração a ser usado para este envio.	`my-configuration-set`
`tags`	Lista	Opcional. Tags de mensagem como uma lista de objetos `{"Name": "...", "Value": "..."}` .	`[{"Name": "purpose", "Value": "welcome-email"}]`
`selectors`	Lista	Opcional. Seletores JQ para extrair campos específicos da saída da ação.	`[{"name": "messageId", "expression": ".response.MessageId"}]`

A tabela a seguir descreve os campos de saída para esta ação.

Saída	Tipo	Exemplo
`response`	Objeto	Consulte a referência do boto3 para send_templated_email . Contém uma string `MessageId` em caso de sucesso.
`success`	Boleano	`true` ou `false`
`errorMessage`	Corda	`"An error occurred (TemplateDoesNotExistException) when calling the SendTemplatedEmail operation: Template (WelcomeEmailTemplate) does not exist"`

Saída

Tipo

Exemplo

response

Objeto

Consulte a

referência do boto3 para send_templated_email

. Contém uma string

MessageId

em caso de sucesso.

success

Boleano

true

false

errorMessage

Corda

"An error occurred (TemplateDoesNotExistException) when calling the SendTemplatedEmail operation: Template (WelcomeEmailTemplate) does not exist"

Exemplo de fluxo de trabalho

name: send-ses-templated-email
description: 'Send a templated email through Amazon SES'
steps:
  - name: sendWelcomeTemplatedEmail
    type: action
    action: aws.ses.sendTemplatedEmail
    version: '1'
    inputs:
      awsRoleArn: "arn:aws:iam::123456789012:role/my-workflow-role"
      region: us-east-2
      source: no-reply@example.com
      template: WelcomeEmailTemplate
      templateData: '{"name": "Alice"}'
      toAddresses:
        - recipient@example.com
      selectors:
        - name: messageId
          expression: ".response.MessageId"
    next: end

Enviar e-mails em massa com modelo

O identificador da ação é aws.ses.sendBulkTemplatedEmail.

Envia um e-mail com modelo para vários destinatários em uma única chamada, com substituição de dados do modelo por destinatário. O endereço source e o template referenciado já devem existir.

Importante

A AWS limita esta ação a 50 entradas destinations por chamada, com até 50 destinatários (combinando Para/Cc/Cco) por destino e um tamanho máximo de mensagem gerada de 10 MB. Exceder qualquer um desses limites produz um erro de API da AWS no momento do envio.

Cada entrada em destinations aceita os seguintes campos:

destination — Obrigatório. Objeto com toAddresses, ccAddresses e/ou bccAddresses (cada um sendo uma lista de strings).
replacementTemplateData — Opcional. String JSON de valores de espaço reservado por destinatário. Substitui defaultTemplateData para este destinatário.
replacementTags — Opcional. Lista de objetos {"name": "...", "value": "..."} que substituem defaultTags para este destinatário.

A tabela a seguir descreve os campos de entrada para esta ação.

Entrada	Tipo	Descrição	Exemplo
`awsRoleArn`	Corda	Opcional. ARN da função do IAM a ser assumida para chamadas de API da AWS.	`arn:aws:iam::123456789012:role/my-workflow-role`
`awsAccessKeyId`	Corda	Opcional. ID da chave de acesso da AWS. Passe como um segredo.	`${{ :secrets:awsAccessKeyId }}`
`awsSecretAccessKey`	Corda	Opcional. Chave de acesso secreta da AWS. Passe como um segredo.	`${{ :secrets:awsSecretAccessKey }}`
`awsSessionToken`	Corda	Opcional. Token de sessão temporário para autenticação STS. Passe como um segredo.	`${{ :secrets:awsSessionToken }}`
`region`	Corda	Obrigatório. Região da AWS de onde enviar os e-mails.	`us-east-2`
`source`	Corda	Obrigatório. Endereço de e-mail do remetente. Deve ser uma identidade verificada do SES.	`no-reply@example.com`
`template`	Corda	Obrigatório. Nome do modelo do SES a ser usado. Já deve existir.	`WelcomeEmailTemplate`
`defaultTemplateData`	Corda	Obrigatório. String JSON de valores de espaço reservado de fallback usados para qualquer destino que não forneça seu próprio `replacementTemplateData` .	`{"name": "Guest"}`
`destinations`	Lista	Obrigatório. Lista de objetos de destino por destinatário. Cada entrada exige um objeto `destination` com pelo menos um de `toAddresses` , `ccAddresses` ou `bccAddresses` . Até 50 entradas por chamada.	`[{"destination": {"toAddresses": ["alice@example.com"]}, "replacementTemplateData": "{\"name\": \"Alice\"}"}]`
`replyToAddresses`	Lista	Opcional. Endereços de resposta aplicados a todos os destinos.	`["support@example.com"]`
`returnPath`	Corda	Opcional. Endereço de e-mail para notificações de devolução e reclamação.	`bounces@example.com`
`sourceArn`	Corda	Opcional. ARN de uma identidade verificada a ser usada para autorização de envio.	`arn:aws:ses:us-east-2:123456789012:identity/example.com`
`returnPathArn`	Corda	Opcional. ARN de uma identidade verificada associada a `returnPath` , para autorização de envio.	`arn:aws:ses:us-east-2:123456789012:identity/example.com`
`templateArn`	Corda	Opcional. ARN de conta cruzada do modelo, como uma alternativa a `template` .	`arn:aws:ses:us-east-2:123456789012:template/WelcomeEmailTemplate`
`configurationSetName`	Corda	Opcional. Nome de um conjunto de configuração a ser usado para este envio.	`my-configuration-set`
`defaultTags`	Lista	Opcional. Tags de mensagem padrão aplicadas a todos os destinos como uma lista de objetos `{"Name": "...", "Value": "..."}` . Destinos individuais podem sobrescrevê-los com `replacementTags` .	`[{"Name": "campaign", "Value": "welcome-series"}]`
`selectors`	Lista	Opcional. Seletores JQ para extrair campos específicos da saída da ação.	`[{"name": "sendStatuses", "expression": ".response.Status"}]`

A tabela a seguir descreve os campos de saída para esta ação.

Saída	Tipo	Exemplo
`response`	Objeto	Consulte a referência do boto3 para send_bulk_templated_email . Contém uma matriz `Status` com uma entrada por destino, cada uma com uma string `Status` , `Error` opcional e `MessageId` .
`success`	Boleano	`true` ou `false`
`errorMessage`	Corda	`"An error occurred (TemplateDoesNotExistException) when calling the SendBulkTemplatedEmail operation: Template (WelcomeEmailTemplate) does not exist"`

Saída

Tipo

Exemplo

response

Objeto

Consulte a

referência do boto3 para send_bulk_templated_email

. Contém uma matriz

Status

com uma entrada por destino, cada uma com uma string

Status

Error

opcional e

MessageId

success

Boleano

true

false

errorMessage

Corda

"An error occurred (TemplateDoesNotExistException) when calling the SendBulkTemplatedEmail operation: Template (WelcomeEmailTemplate) does not exist"

Exemplo de fluxo de trabalho

name: send-ses-bulk-templated-email
description: 'Send bulk templated emails through Amazon SES'
steps:
  - name: sendBulkWelcomeEmail
    type: action
    action: aws.ses.sendBulkTemplatedEmail
    version: '1'
    inputs:
      awsRoleArn: "arn:aws:iam::123456789012:role/my-workflow-role"
      region: us-east-2
      source: no-reply@example.com
      template: WelcomeEmailTemplate
      defaultTemplateData: '{"name": "Guest"}'
      destinations:
        - destination:
            toAddresses:
              - alice@example.com
          replacementTemplateData: '{"name": "Alice"}'
        - destination:
            toAddresses:
              - bob@example.com
          replacementTemplateData: '{"name": "Bob"}'
      selectors:
        - name: sendStatuses
          expression: ".response.Status"
    next: end

Esta tradução de máquina é fornecida para sua comodidade.

Pré-requisitos.css-21sua1{background:none;border:none;width:0;padding:0;}

Criar um modelo

Importante

Atualizar um modelo

Importante

Excluir um modelo

Obter um modelo

Listar modelos

Enviar um e-mail

Importante

Enviar um e-mail com modelo

Importante

Enviar e-mails em massa com modelo

Importante

Pré-requisitos