> 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

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

{% 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.

**📷 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.: `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.                                                                                    |

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

{% 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 %}

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

{% 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 %}

**📷 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: `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.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.hyperflow.global/docs/builder-hyperflow/gerenciamento-de-aplicativos/fluxos/integracao/aws-ses.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
