AWS SES
Enviar e-mails e administrar modelos com o Amazon Simple Email Service.
O que faz
Integre o AWS SES v2 ao fluxo. Envie e-mails simples, com modelo e em massa. Gerencie modelos de e-mail, identidades, conjuntos de configuração e a lista de supressão da conta, e consulte a cota de envio da conta e as informações das identidades verificadas.
Quando usar: Use quando o seu fluxo precisar enviar e-mails e administrar modelos com o Amazon Simple Email Service.
Exemplo de situação: Enviar uma confirmação por e-mail ou tratar uma mensagem recebida.
Antes de começar
Conexão necessária: Credencial protegida.
Escolha uma conexão ou credencial já cadastrada no workspace. Nunca cole senhas ou chaves em campos de texto comuns.
Passo a passo
- Adicione AWS SES ao desenho a partir da aba Blocos e ligue a entrada dele à etapa anterior.
- Escolha uma conexão ou credencial já cadastrada no workspace. Nunca cole senhas ou chaves em campos de texto comuns.
- Escolha a operação. O painel mostra só os campos que essa operação usa.
- Preencha os campos obrigatórios. Para usar um dado de uma etapa anterior, digite < e escolha o bloco e o campo.
- Clique em Executar com dados de teste e confira, no terminal, o que entrou e o que saiu do bloco.
- Só publique depois de conferir o resultado da execução de teste.
Operações
| Operação | O que faz |
|---|---|
| Enviar e-mail | Envia e-mail com o bloco AWS SES. |
| Enviar e-mail com modelo | Envia e-mail com modelo com o bloco AWS SES. |
| Enviar e-mail em massa | Envia e-mail em massa com o bloco AWS SES. |
| Listar identidades | Lista identidades com o bloco AWS SES. |
| Obter dados da conta | Obtém dados da conta com o bloco AWS SES. |
| Criar modelo | Cria modelo com o bloco AWS SES. |
| Obter modelo | Obtém modelo com o bloco AWS SES. |
| Listar modelos | Lista modelos com o bloco AWS SES. |
| Excluir modelo | Exclui modelo com o bloco AWS SES. |
Campos
Operação
Escolhe qual ação este bloco executará.
- Opções:
- Enviar e-mail · Enviar e-mail com modelo · Enviar e-mail em massa · Listar identidades · Obter dados da conta · Criar modelo · Obter modelo · Listar modelos · Excluir modelo
- Padrão:
- Enviar e-mail
Região da AWS
ObrigatórioRegião da AWS em que o Amazon SES está configurado na sua conta (ex.: sa-east-1, São Paulo); remetentes e modelos valem só na região em que foram criados.
- Exemplo:
- us-east-1
ID da chave de acesso da AWS
ObrigatórioDado protegidoInforma o identificador exato do recurso na plataforma conectada.
- Padrão:
- Segredo protegido
Chave de acesso secreta da AWS
ObrigatórioDado protegidoInforme a sua chave de acesso secreta.
- Padrão:
- Segredo protegido
Endereço do remetente
Obrigatório conforme a operaçãoE-mail que aparece como remetente; precisa estar verificado no Amazon SES na mesma região (ex.: contato@minhaempresa.com.br).
- Aparece em:
- Enviar e-mail, Enviar e-mail com modelo, Enviar e-mail em massa
- Exemplo:
- cliente@exemplo.com
Endereços dos destinatários
Obrigatório conforme a operaçãoE-mails dos destinatários da mensagem, separados por vírgula (ex.: cliente@exemplo.com.br, financeiro@exemplo.com.br).
- Aparece em:
- Enviar e-mail, Enviar e-mail com modelo
- Exemplo:
- Avenida Paulista, 1000, São Paulo - SP
Assunto
Obrigatório conforme a operaçãoInforme o assunto do e-mail.
- Aparece em:
- Enviar e-mail
- Exemplo:
- Exemplo de atendimento
Corpo em HTML
Informa o conteúdo de texto que será enviado ou processado.
- Aparece em:
- Enviar e-mail
- Exemplo:
- Olá! Sua solicitação foi processada com sucesso.
Corpo em texto simples
Em campos adicionaisVersão em texto simples do seu e-mail.
- Aparece em:
- Enviar e-mail
- Exemplo:
- Olá! Sua solicitação foi processada com sucesso.
Nome do modelo
Obrigatório conforme a operaçãoDefine o nome ou título usado para identificar o recurso.
- Aparece em:
- Enviar e-mail com modelo, Enviar e-mail em massa, Obter modelo, Criar modelo, Excluir modelo
- Exemplo:
- Exemplo de atendimento
Dados do modelo (JSON)
Obrigatório conforme a operaçãoInforma dados estruturados ou código no formato exigido pelo campo.
- Aparece em:
- Enviar e-mail com modelo
- Exemplo:
- { "chave": "valor" }
Destinos (JSON)
Obrigatório conforme a operaçãoInforma dados estruturados ou código no formato exigido pelo campo.
- Aparece em:
- Enviar e-mail em massa
- Exemplo:
- { "chave": "valor" }
Assunto
Obrigatório conforme a operaçãoOlá, {{name}}.
- Aparece em:
- Criar modelo
- Exemplo:
- Exemplo de atendimento
Corpo em HTML
Conteúdo em HTML do modelo de e-mail; use {{variavel}} nos pontos que serão preenchidos no envio (ex.: <h1>Olá, {{nome}}!</h1>).
- Aparece em:
- Criar modelo
- Exemplo:
- <h1>Olá, {{name}}!</h1>
Corpo em texto simples
Em campos adicionaisOlá, {{name}}.
- Aparece em:
- Criar modelo
- Exemplo:
- Olá! Sua solicitação foi processada com sucesso.
Endereços em Cc
Em campos adicionaisE-mails que recebem uma cópia visível da mensagem, separados por vírgula (ex.: financeiro@minhaempresa.com.br).
- Aparece em:
- Enviar e-mail, Enviar e-mail com modelo
- Exemplo:
- Avenida Paulista, 1000, São Paulo - SP
Endereços em Cco
Em campos adicionaisE-mails que recebem cópia oculta da mensagem, sem que os outros destinatários saibam, separados por vírgula.
- Aparece em:
- Enviar e-mail, Enviar e-mail com modelo
- Exemplo:
- Avenida Paulista, 1000, São Paulo - SP
Endereços de resposta (Reply-To)
Em campos adicionaisE-mail que recebe as respostas quando o destinatário clica em responder, se for diferente do remetente (ex.: atendimento@minhaempresa.com.br); para mais de um, separe por vírgula.
- Aparece em:
- Enviar e-mail
- Exemplo:
- Avenida Paulista, 1000, São Paulo - SP
Dados padrão do modelo (JSON)
Em campos adicionaisInforma dados estruturados ou código no formato exigido pelo campo.
- Aparece em:
- Enviar e-mail em massa
- Exemplo:
- { "chave": "valor" }
Conjunto de configuração
Em campos adicionaisDefine o nome ou título usado para identificar o recurso.
- Aparece em:
- Enviar e-mail, Enviar e-mail com modelo, Enviar e-mail em massa
- Exemplo:
- Exemplo de atendimento
Itens por página
Em campos adicionaisDefine um valor numérico, quantidade ou limite da operação.
- Aparece em:
- Listar identidades, Listar modelos
- Exemplo:
- 10
Token da próxima página
Em campos adicionaisToken de paginação da resposta anterior.
- Aparece em:
- Listar identidades, Listar modelos
- Exemplo:
- Token de paginação da resposta anterior
Saídas
Para usar um resultado deste bloco em uma etapa seguinte, digite < no campo e escolha o bloco e o campo. A referência tem o formato <awsses.messageId>: antes do ponto vai o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.
| Referência | Tipo | O que contém |
|---|---|---|
<awsses.messageId> | string | ID da mensagem no SES (send_email, send_templated_email, send_custom_verification_email). |
<awsses.results> | array | Resultados do envio por destino (send_bulk_email). |
<awsses.successCount> | number | Número de e-mails enviados com sucesso (send_bulk_email). |
<awsses.failureCount> | number | Número de envios de e-mail que falharam (send_bulk_email). |
<awsses.identities> | array | Lista de identidades de e-mail verificadas (list_identities). |
<awsses.nextToken> | string | Token de paginação da próxima página (list_identities, list_templates, list_suppressed_destinations). |
<awsses.count> | number | Número de itens retornados (list_identities, list_templates, list_suppressed_destinations). |
<awsses.destinations> | array | Lista de destinos suprimidos (list_suppressed_destinations). |
<awsses.emailAddress> | string | Endereço de e-mail suprimido (get_suppressed_destination). |
<awsses.reason> | string | Motivo da supressão (get_suppressed_destination). |
<awsses.lastUpdateTime> | string | Quando o endereço foi adicionado à lista de supressão (get_suppressed_destination). |
<awsses.feedbackId> | string | ID do feedback do evento de devolução/reclamação (get_suppressed_destination). |
<awsses.identityType> | string | Tipo de identidade: EMAIL_ADDRESS ou DOMAIN (create_email_identity, get_email_identity). |
<awsses.verifiedForSendingStatus> | boolean | Indica se a identidade está verificada para envio (create_email_identity, get_email_identity). |
<awsses.dkimAttributes> | json | Status e tokens da assinatura DKIM (create_email_identity, get_email_identity). |
<awsses.verificationStatus> | string | Status da verificação da identidade (get_email_identity). |
<awsses.feedbackForwardingStatus> | boolean | Indica se o feedback de devoluções/reclamações é encaminhado por e-mail (get_email_identity). |
<awsses.mailFromAttributes> | json | Configuração do domínio MAIL FROM personalizado (get_email_identity). |
<awsses.policies> | json | Políticas de autorização de envio (get_email_identity). |
<awsses.verificationInfo> | json | Diagnósticos adicionais da verificação (get_email_identity). |
<awsses.sendingEnabled> | boolean | Indica se o envio de e-mails está ativado (get_account). |
<awsses.max24HourSend> | number | Máximo de e-mails a cada 24 horas (get_account). |
<awsses.maxSendRate> | number | Máximo de e-mails por segundo (get_account). |
<awsses.sentLast24Hours> | number | E-mails enviados nas últimas 24 horas (get_account). |
<awsses.templateName> | string | Nome do modelo (get_template). |
<awsses.subjectPart> | string | Assunto do modelo (get_template). |
<awsses.textPart> | string | Corpo em texto simples do modelo (get_template). |
<awsses.htmlPart> | string | Corpo em HTML do modelo (get_template). |
<awsses.templates> | array | Lista de modelos de e-mail (list_templates). |
<awsses.tags> | array | Tags associadas à identidade (get_email_identity). |
<awsses.message> | string | Mensagem de confirmação (create_template, delete_template, update_template, put_suppressed_destination, delete_suppressed_destination, delete_email_identity, create_configuration_set). |
Exemplo de uso
Objetivo: Enviar uma confirmação por e-mail ou tratar uma mensagem recebida.
- Operação
- Enviar e-mail
- Região da AWS
- us-east-1
- Endereço do remetente
- cliente@exemplo.com
- Endereços dos destinatários
- Avenida Paulista, 1000, São Paulo - SP
- Assunto
- Exemplo de atendimento
- Corpo em HTML
- Olá! Sua solicitação foi processada com sucesso.
Os valores são ilustrativos. Teste primeiro com dados fictícios ou de homologação.
Erros comuns e como resolver
- O bloco não executa
- Confira se existe um caminho de setas que parte do gatilho (ou do Início) até este bloco. Blocos soltos no desenho são ignorados.
- Aparece “Validação do fluxo” no terminal
- Há campo obrigatório vazio. Clique no aviso, abra o bloco indicado e preencha o campo marcado.
- Um campo chega vazio na etapa seguinte
- Confira se a referência aponta para um bloco que já executou e para um campo que existe, como <awsses.messageId>. O nome antes do ponto é o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.
- O campo que eu procuro não aparece
- Os campos mudam conforme a operação escolhida. Escolha a operação primeiro; campos menos usados ficam em “Mostrar campos adicionais”.
- Credencial ausente ou recusada
- Escolha uma conexão válida do workspace. Se a senha ou a chave mudou no serviço, atualize a conexão cadastrada em vez de colar o segredo no bloco.
- O serviço recusou a chamada ou devolveu erro
- Leia a mensagem no terminal: ela traz o motivo informado pelo serviço. Confira IDs, limites de uso e permissões, e teste antes com um recurso de homologação.
Blocos relacionados
- Adicionar contato · SendGridAdicionar contato usando a conexão SendGrid deste workspace.
- Adicionar contato ao segmento · ResendAdicionar contato ao segmento com a conta Resend conectada.
- Adicionar contatos à lista · SendGridAdicionar contatos à lista usando a conexão SendGrid deste workspace.
- Atualizar campanha de e-mail · ResendAtualizar campanha de e-mail com a conta Resend conectada.
- Atualizar contato · ResendAtualizar contato com a conta Resend conectada.
- Atualizar domínio · ResendAtualizar domínio com a conta Resend conectada.