> 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/sendgrid.md).

# SendGrid

## 📧 SendGrid

O módulo **SendGrid** envia e-mails usando um **modelo dinâmico (Dynamic Template)** já cadastrado na sua conta SendGrid, preenchendo os dados variáveis do template com informações do fluxo. É útil para enviar e-mails com um layout visual já pronto, mantendo apenas o conteúdo dinâmico configurado pelo Hyperflow Integrações.

{% hint style="info" %}
Diferente do módulo **AWS SES**, aqui o corpo do e-mail (HTML), o assunto e o layout são definidos dentro do próprio template cadastrado no SendGrid — o módulo só envia as variáveis para preenchê-lo.
{% endhint %}

<figure><img src="/files/ODNhMFfsMLTvlmDcf7ws" alt=""><figcaption><p>Imagem 1 - Visão geral do módulo SendGrid na área de trabalho do fluxo no Hyperflow Integrações.</p></figcaption></figure>

***

### 🧭 Como acessar

1. No menu lateral, clique em **Gerenciamento de aplicativos**.
2. Em seguida, clique em **Fluxos**.
3. Abra ou crie um fluxo e acesse a área de trabalho do fluxo.
4. No painel de módulos, localize a categoria **Integração** (identificada pela cor azul).
5. Arraste o módulo **SendGrid** para a área de trabalho do fluxo.

<figure><img src="/files/iBqHdjk5G4bcrMwCiNcH" alt=""><figcaption><p>Imagem 2 - Painel de módulos com a categoria Integração expandida e o módulo SendGrid visível.</p></figcaption></figure>

{% hint style="warning" %}
**Antes de usar este módulo:** é necessário ter uma integração do tipo **SendGrid** já cadastrada (com a chave de API da sua conta) e pelo menos um **Dynamic Template** criado na sua conta SendGrid.
{% endhint %}

***

### 🔍 Conhecendo o módulo

Ao clicar duas vezes no módulo na área de trabalho do fluxo, um painel de configuração é aberto na lateral da tela.

<figure><img src="/files/18fecXfODIFOjcKH5etB" alt=""><figcaption><p>Imagem 3 - Painel de configuração do módulo SendGrid aberto.</p></figcaption></figure>

***

#### 📋 Campos de configuração

| Campo                       | O que preencher                                                        |
| --------------------------- | ---------------------------------------------------------------------- |
| **Nome da integração**      | Selecione a integração SendGrid já cadastrada                          |
| **Remetente**               | Endereço de e-mail que aparecerá como remetente                        |
| **ID do Template SendGrid** | Selecione o modelo (Dynamic Template) cadastrado na sua conta SendGrid |
| **Destinatários**           | E-mails que devem receber a mensagem (aceita múltiplos)                |
| **Substituições**           | Valores para preencher as variáveis do template selecionado            |
| **Anexos**                  | Arquivos a anexar ao e-mail (nome, URL e tipo do arquivo)              |

{% hint style="warning" %}
No campo **ID do Template SendGrid**, sempre selecione o modelo pela lista de sugestões. Digitar o código manualmente pode fazer o campo ficar vazio e impedir a publicação do fluxo.
{% endhint %}

<figure><img src="/files/cKTgkSCrd1LhMWQPQ4ns" alt=""><figcaption><p>Imagem 4 - Campos de configuração preenchidos, com o template selecionado.</p></figcaption></figure>

***

#### 🔁 Substituições

Ao selecionar um template, o módulo detecta automaticamente as variáveis usadas nele e sugere um modelo para você preencher com os valores correspondentes — que podem ser texto fixo ou variáveis do fluxo.

<figure><img src="/files/IC37NYPNNj1aqivVdrJM" alt=""><figcaption><p>Imagem 5 - Campo Substituições preenchido com variáveis do fluxo.</p></figcaption></figure>

***

#### 🖥️ Pré-visualização do e-mail

Para conferir como o e-mail ficará com o template selecionado, clique no botão de expansão no canto superior do painel de configuração. O painel passa para o modo tela cheia, mostrando os campos de configuração de um lado e uma prévia visual do e-mail do outro.

<figure><img src="/files/KQtuGhVvHJNMd0yv21on" alt=""><figcaption><p>Imagem 6 - Painel em tela cheia com a pré-visualização do e-mail ao lado dos campos.</p></figcaption></figure>

***

#### 📎 Anexos

Para cada anexo, informe:

* **Nome do arquivo** — nome que o destinatário verá.
* **Caminho (URL)** — endereço onde o arquivo está hospedado.
* **Tipo do arquivo** — formato do arquivo anexado.

<figure><img src="/files/8rGeOwNrJJBBv7Jpb8Jo" alt=""><figcaption><p>Imagem 7 - Seção de anexos com um arquivo configurado.</p></figcaption></figure>

***

#### 🔀 Saída do módulo

O módulo tem uma única saída, opcional: **Próximo**. Se não conectada, o fluxo simplesmente encerra após o envio do e-mail.

{% hint style="warning" %}
Este módulo não possui uma saída de erro. Se o envio falhar (por exemplo, chave de API inválida ou template não encontrado), o fluxo segue normalmente sem nenhum aviso. Teste o fluxo para confirmar que os e-mails estão sendo entregues como esperado.
{% endhint %}

<figure><img src="/files/nIz1UcylkJclZC8ly2TT" alt=""><figcaption><p>Imagem 8 - Módulo com a saída Próximo conectada.</p></figcaption></figure>

***

### 💡 Caso de uso

**Cenário:** uma empresa quer enviar um e-mail de boas-vindas com um layout visual já pronto sempre que um novo cliente se cadastrar pelo chatbot.

**Configuração:**

1. Adicione o módulo **SendGrid** ao fluxo, após o cadastro do cliente.
2. Selecione a integração SendGrid e o template "Boas-vindas".
3. Em **Destinatários**, informe `{{input.email}}`.
4. Em **Substituições**, preencha as variáveis do template com `{{input.nome}}` e demais dados coletados.
5. Conecte a saída **Próximo** para dar continuidade ao atendimento.

**Resultado:** o cliente recebe automaticamente um e-mail com o layout visual da empresa, já personalizado com seus dados.

***

### 📌 Dicas úteis

* Sempre selecione o template pela lista de sugestões, nunca digite o código manualmente.
* **Modo de prévia:** ative a tela cheia no painel de configuração para conferir como o template ficará antes de publicar o fluxo.
* Como não há uma saída de erro, teste o fluxo para confirmar que os e-mails estão sendo entregues corretamente.
* Os arquivos anexados precisam estar acessíveis por uma URL pública ou autenticada — o módulo não faz upload de arquivos, apenas busca o arquivo na URL informada.

***

### 📝 Resumo

* O módulo **SendGrid** envia e-mails usando um Dynamic Template já cadastrado na sua conta SendGrid.
* O layout, assunto e corpo do e-mail vêm do template — o módulo só envia as variáveis de substituição.
* Aceita múltiplos destinatários e anexos por URL.
* O fluxo sempre continua normalmente após este módulo, mesmo em caso de falha no envio.