Ctrlk

AWS SES

📧 Módulo AWS SES

O módulo AWS SES permite que o seu chatbot envie e-mails pelo Amazon Simple Email Service (SES) durante uma conversa. Com ele, você configura o remetente, os destinatários, o assunto, o conteúdo do e-mail em HTML e os anexos — tudo dentro do fluxo, sem precisar de ferramentas externas.

📷 Inserir print: visão geral do nó AWS SES no canvas do Builder

🗂️ Como acessar

  1. No menu lateral, clique em Aplicativo.

  2. Em seguida, clique em Fluxos.

  3. Abra o fluxo desejado ou crie um novo.

  4. No canvas do Builder, clique no botão + para adicionar um novo nó.

  5. Localize e selecione AWS - SES na lista de módulos disponíveis.

📷 Inserir print: lista de módulos com o item "AWS - SES" destacado

Pré-requisito: Para usar este módulo, é necessário ter uma integração com a AWS configurada na plataforma. Caso o campo Nome da integração esteja vazio, acesse as configurações de integrações, cadastre as credenciais da AWS e retorne para configurar o módulo.

🧩 Conhecendo o módulo

Ao adicionar o módulo ao fluxo, um painel de configuração é aberto. Nele, você seleciona a integração AWS, preenche os dados do e-mail (remetente, destinatários, assunto e conteúdo) e pode adicionar anexos. O editor de conteúdo aceita HTML e suporta variáveis do fluxo, permitindo personalizar o e-mail com informações coletadas durante a conversa.

📷 Inserir print: painel de configuração do módulo AWS SES aberto

🔧 Configurações do módulo

📌 Campos do painel de configuração

Campo
O que preencher

Nome da integração

Selecione a integração AWS cadastrada que o bot deve usar para enviar o e-mail pelo SES. Campo obrigatório.

Remetente

Informe o endereço de e-mail que aparecerá como remetente da mensagem (ex.: [email protected]). Aceita variáveis do fluxo. Campo obrigatório.

Assunto

Informe o assunto do e-mail. Aceita variáveis do fluxo (ex.: Confirmação de atendimento - {{input.nomeCliente}}). Campo obrigatório.

Destinatários

Informe os endereços de e-mail que receberão a mensagem. Adicione múltiplos e-mails separando-os por Enter, vírgula, ponto e vírgula ou espaço. Campo obrigatório.

Destinatários ocultos

Informe os endereços que receberão o e-mail em cópia oculta (CCO). Os destinatários principais não verão esses endereços. Adicione múltiplos e-mails da mesma forma que no campo acima.

Anexos

Adicione arquivos ao e-mail informando o nome do arquivo e a URL de acesso. Consulte a seção de anexos abaixo para mais detalhes.

Conteúdo do e-mail

Escreva o corpo do e-mail em HTML. Aceita variáveis do fluxo para personalização. Campo obrigatório.

📷 Inserir print: painel de configuração com os campos de remetente, assunto e destinatários preenchidos

⚙️ Recursos do módulo

1️⃣ Destinatários e cópia oculta

🎯 Propósito

Definir quem receberá o e-mail — de forma visível (destinatários) ou sem que os outros saibam (destinatários ocultos / CCO).

✅ Como fazer na tela

  1. No campo Destinatários, digite o endereço de e-mail e pressione Enter (ou use vírgula, ponto e vírgula ou espaço) para confirmar. Repita para adicionar mais endereços.

  2. Para enviar cópias ocultas, repita o mesmo processo no campo Destinatários ocultos.

📷 Inserir print: campo "Destinatários" com múltiplos e-mails adicionados como etiquetas

📌 Resultado esperado

Os e-mails confirmados aparecem como etiquetas no campo. Todos os destinatários listados receberão a mensagem ao executar o fluxo.

2️⃣ Anexos

🎯 Propósito

Incluir arquivos no e-mail, como PDFs, imagens ou documentos, apontando para URLs onde os arquivos estão hospedados.

✅ Como fazer na tela

  1. Clique no botão Adicionar anexos. Um bloco com dois campos será exibido:

    • Nome do arquivo: informe o nome que o destinatário verá (ex.: proposta-comercial.pdf). Aceita variáveis do fluxo.

    • Caminho (URL): informe o endereço completo do arquivo (ex.: https://meusite.com/arquivos/proposta.pdf). Aceita variáveis do fluxo.

  2. Para adicionar mais de um arquivo, clique novamente em Adicionar anexos.

  3. Para remover um anexo, clique no ícone de lixeira ao lado do bloco correspondente.

📷 Inserir print: seção de anexos com um arquivo adicionado, mostrando os campos "Nome do arquivo" e "Caminho (URL)"

📌 Resultado esperado

O arquivo será anexado ao e-mail no momento do envio. O destinatário receberá o e-mail com o arquivo disponível para download com o nome informado.

3️⃣ Conteúdo do e-mail

🎯 Propósito

Escrever o corpo do e-mail com formatação HTML e personalizar o conteúdo com variáveis coletadas durante a conversa.

✅ Como fazer na tela

  1. No campo Conteúdo do e-mail, escreva o HTML do corpo da mensagem diretamente no editor.

  2. Para incluir informações dinâmicas (como nome do cliente ou número do protocolo), use a sintaxe de variável {{nome.da.variavel}} dentro do HTML.

  3. Para visualizar como o e-mail ficará para o destinatário, ative o modo de tela cheia clicando no botão de expansão no canto superior do painel. O editor e a prévia serão exibidos lado a lado.

O editor aceita HTML completo. Você pode usar tags de formatação (<b>, <p>, <table>, etc.) para criar e-mails visualmente ricos. Variáveis do fluxo inseridas no HTML serão substituídas pelos valores reais no momento do envio.

📷 Inserir print: editor de conteúdo do e-mail com HTML digitado e a prévia exibida ao lado no modo tela cheia

📌 Resultado esperado

O e-mail será enviado com o conteúdo HTML exatamente como configurado, com as variáveis substituídas pelos valores reais da conversa.

🔀 Saída do módulo no fluxo

O módulo AWS SES possui uma saída opcional de continuação do fluxo:

Saída
Quando acontece

Próximo

Caminho opcional que pode ser ativado para continuar o fluxo após o envio do e-mail. Conecte ao próximo nó desejado caso precise encadear ações após o envio.

A saída Próximo é opcional. Se não for conectada a nenhum nó, o fluxo simplesmente encerra neste ponto após o envio do e-mail.

📷 Inserir print: nó AWS SES no canvas com a saída "Próximo" conectada a um nó subsequente

💡 Dicas úteis

  • Variáveis no conteúdo: Use {{nome.da.variavel}} em todos os campos de texto para personalizar o e-mail com dados coletados na conversa — nome do cliente, número do protocolo, data do atendimento, entre outros.

  • Remetente verificado: O endereço de e-mail informado no campo Remetente precisa estar verificado no AWS SES da conta configurada na integração. Caso contrário, o envio será rejeitado pela AWS.

  • Modo de prévia: Ative a tela cheia no painel de configuração para ver uma prévia visual do e-mail enquanto edita o HTML. Isso ajuda a garantir que a formatação está correta antes de publicar o fluxo.

  • Múltiplos destinatários: Você pode informar quantos destinatários precisar no campo Destinatários. Cada endereço confirmado aparece como uma etiqueta no campo.

  • Anexos por URL: Os arquivos anexados precisam estar acessíveis por uma URL pública ou autenticada. O módulo não faz upload de arquivos — ele usa o endereço informado para buscar e anexar o arquivo no momento do envio.

📋 Caso de uso

Cenário: Uma empresa de serviços usa um chatbot para registrar solicitações de suporte. Ao final de cada atendimento, o bot envia automaticamente um e-mail de confirmação para o cliente com um resumo do protocolo aberto, incluindo o número do chamado, a descrição do problema e um PDF com os termos do serviço.

Configuração principal:

  1. Adicionar o módulo ao fluxo:

    • No fluxo de encerramento do atendimento, após o nó que registra o protocolo, adicione o módulo AWS SES.

    • Selecione a integração AWS configurada na plataforma.

  2. Preencher os dados do e-mail:

    • No campo Remetente, informe o endereço verificado: [email protected].

    • No campo Assunto, use: Protocolo {{input.numeroProtocolo}} — sua solicitação foi registrada.

    • No campo Destinatários, use a variável com o e-mail do cliente: {{input.emailCliente}}.

  3. Escrever o conteúdo do e-mail:

    • No editor Conteúdo do e-mail, escreva o HTML com as variáveis do fluxo:

  4. Adicionar anexo (opcional):

    • Clique em Adicionar anexos.

    • No campo Nome do arquivo, informe: termos-de-servico.pdf.

    • No campo Caminho (URL), informe a URL do PDF hospedado.

  5. Conectar a saída:

    • Conecte a saída Próximo ao nó que exibe a mensagem de encerramento para o usuário no chat.

Resultado esperado no fluxo: Ao final de cada atendimento, o cliente recebe automaticamente um e-mail personalizado com o número do protocolo, a descrição do problema e o PDF dos termos de serviço — tudo sem intervenção manual da equipe.

✅ Resumo

  • O módulo AWS SES permite enviar e-mails personalizados diretamente em fluxos de chatbot, usando o Amazon Simple Email Service.

  • Todos os campos de texto — remetente, assunto, destinatários, anexos e conteúdo — aceitam variáveis do fluxo com a sintaxe {{nome.da.variavel}}.

  • O campo Destinatários ocultos permite enviar cópias do e-mail em CCO, sem que os destinatários principais vejam os endereços ocultos.

  • O editor de Conteúdo do e-mail suporta HTML completo e oferece um modo de prévia lado a lado para verificar a formatação antes de publicar o fluxo.

  • A saída Próximo é opcional: conecte-a ao próximo nó para encadear ações após o envio, ou deixe sem conexão para encerrar o fluxo nesse ponto.

Last updated