> For the complete documentation index, see [llms.txt](https://help.hyperflow.global/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.hyperflow.global/docs/builder-hyperflow/gerenciamento-de-aplicativos/fluxos/integracao/aws-ses.md).

# 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.

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2FMqX0GK5F49Myke8A8hpL%2F01-visao-geral-canvas.png?alt=media&amp;token=5679d2b7-759d-4f5f-80af-21301e01506a" alt=""><figcaption><p>Imagem 1 - Visão geral do módulo AWS SES no canvas do Hyperflow Integrações.</p></figcaption></figure>

***

### 🗂️ 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.

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2Fwxf4k36ANnyBz0jAEVWD%2F02-lista-modulo-ses.png?alt=media&amp;token=50762b91-8748-4dc1-b64e-848f4f70f613" alt=""><figcaption><p>Imagem 2 - Lista de módulos com o item "AWS - SES" destacado.</p></figcaption></figure>

{% hint style="warning" %}
**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.
{% endhint %}

***

### 🧩 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.

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2FvH9dn7tcCCYHWvvQdaWT%2F03-painel-aberto.png?alt=media&amp;token=6772fc10-387d-47c3-aef0-90b29aed3d1c" alt=""><figcaption><p>Imagem 3 - Painel de configuração do módulo AWS SES aberto.</p></figcaption></figure>

***

### 🔧 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.: `contato@minhaempresa.com`). 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.                                                                                    |

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2FNhNvMhMcKGFWMXjobiod%2F04-campos-remetente-assunto-destinatarios.png?alt=media&amp;token=518fdeff-ff52-468c-87f7-5f1a93b289ae" alt=""><figcaption><p>Imagem 4 - Painel de configuração com os campos de remetente, assunto e destinatários preenchidos.</p></figcaption></figure>

***

### ⚙️ 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**.

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2FupCJsDrzRu6DCyDoD6Ix%2F05-destinatarios-multiplos.png?alt=media&amp;token=784c2c6d-7d3c-430f-a7f2-3ae5f527c336" alt=""><figcaption><p>Imagem 5 - Campo "Destinatários" com múltiplos e-mails adicionados como etiquetas.</p></figcaption></figure>

**📌 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.

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2FMpN8IK4sJ7mkrmvGwueg%2F06-anexo-adicionado.png?alt=media&amp;token=032341c8-1796-455b-b3e2-a6679c92d52a" alt=""><figcaption><p>Imagem 6 - Seção de anexos com um arquivo adicionado, mostrando os campos "Nome do arquivo" e "Caminho (URL)".</p></figcaption></figure>

**📌 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.

{% hint style="info" %}
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.
{% endhint %}

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2FZYN1c8EhAlZqJYSS4JEV%2F07-editor-html-preview.png?alt=media&amp;token=ae05f1ae-e321-4593-a0b9-c250bb9c9712" alt=""><figcaption><p>Imagem 7 - Editor de conteúdo do e-mail com HTML digitado e a prévia exibida ao lado no modo tela cheia.</p></figcaption></figure>

**📌 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. |

{% hint style="info" %}
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.
{% endhint %}

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2F5Ofiasr3XlGvuxKIQ7tP%2F08-saida-proximo-conectada.png?alt=media&amp;token=be0509ad-30f2-46c2-9b25-2b4ba5fc01ba" alt=""><figcaption><p>Imagem 8 - Módulo AWS SES no canvas com a saída "Próximo" conectada a um nó subsequente</p></figcaption></figure>

***

### 💡 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: `suporte@minhaempresa.com`.
   * 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:

     ```html
     <p>Olá, {{input.nomeCliente}}!</p>
     <p>Sua solicitação foi registrada com sucesso.</p>
     <p><strong>Protocolo:</strong> {{input.numeroProtocolo}}</p>
     <p><strong>Descrição:</strong> {{input.descricaoProblema}}</p>
     <p>Em breve nossa equipe entrará em contato.</p>
     ```
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.