---
title: SMTP
slug: smtp
docTags: 
createdAt: 2026-02-24T12:18:37.678Z
---

## Objetivo

O conector **E-mail (SMTP)** permite enviar e-mails transacionais ou notificações diretamente da plataforma Fluid utilizando um servidor SMTP configurado via conexão.
Suporta envio em **Texto** ou **HTML**, com anexos e imagens inline.

Principais cenários:

- Notificações transacionais (ex: pedido aprovado, erro de processamento).
- Alertas internos (ex: falha de integração).
- Disparo de comunicações automatizadas.
- Envio de relatórios com anexos.

***

## Configuração da conexão

### Como configurar no painel da Fluid

1. Acesse Conexões > Nova conexão > E-mail (SMTP).
2. Preencha os campos de conexão:
   - Host: Nome do host ou IP do servidor SMTP.
   - Porta: Porta do servidor SMTP (default: 587).
   - Tipo de autenticação: `basic` ou `none`.
3. (Opcional) Configurações avançadas e Proxy: configure apenas se sua rede exigir.
4. Clique em Salvar conexão e utilize Testar para validar.

::Image[]{src="https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/TJKDu6bfzsg5S-czaF2rm-20260225-142859.png" darkSrc="https://archbee-image-uploads.s3.amazonaws.com/G1NTw6yAi4RDUYbsU8csp/TJKDu6bfzsg5S-czaF2rm-20260225-142859.png" size="70" width="762" height="823" darkWidth="762" darkHeight="823" position="center" showCaption="false"}

### Requisitos (criando conexão)

A conexão define como a Fluid se conectará ao servidor SMTP.

### Campos da conexão

| Campo                | Tipo    | Obrigatorio | Descrição                                          |
| -------------------- | ------- | ----------- | -------------------------------------------------- |
| Host                 | string  | Sim\*       | Nome do host ou IP do servidor SMTP.               |
| Port                 | string  | Sim\*       | Porta do servidor SMTP. Default: `587`.            |
| Tipo de autenticação | object  | Sim\*       | Tipo de autenticação (`basic` ou `none`).          |
| Ignorar erros de SSL | boolean | Não         | Ignora erros de certificado SSL. Default: `false`. |

***

### Tipo de autenticação

### 1) Basic Authentication

| Campo                | Tipo   | Obrigatorio | Descrição                                     |
| -------------------- | ------ | ----------- | --------------------------------------------- |
| Nome de usuário      | string | Sim\*       | Usuário SMTP.                                 |
| Senha                | string | Sim\*       | Senha SMTP.                                   |
| Modo de criptografia | string | Sim         | `SSL/TLS` ou `STARTTLS`. Default: `STARTTLS`. |

***

### 2) Sem autenticação

| Campo                | Tipo   | Obrigatorio | Descrição                                             |
| -------------------- | ------ | ----------- | ----------------------------------------------------- |
| Modo de criptografia | string | Sim         | `SSL/TLS`, `STARTTLS` ou `NONE`. Default: `STARTTLS`. |

***

### Observações de segurança

- Evitar usar `Ignorar erros de SSL = Ativo` em ambientes de produção, pois pode expor a conexão a ataques man-in-the-middle.
- Preferir `STARTTLS` ou `SSL/TLS`.
- Validar limites de envio (rate limit) do provedor SMTP.

***

## Configurando um fluxo

### Operação: Enviar

**Campos de entrada para operação "Enviar"**

| Campo                         | Tipo   | Required | Descrição                                                               |
| ----------------------------- | ------ | -------- | ----------------------------------------------------------------------- |
| Remetente                     | string | Sim      | Remetente (ex: [remetente@dominio.com](mailto\:remetente@dominio.com)). |
| Destinatários                 | array  | Sim      | Lista de destinatários.                                                 |
| Destinatários Em Cópia        | array  | Nao      | Lista de destinatários em cópia.                                        |
| Destinatários Em Cópia Oculta | array  | Nao      | Lista de destinatários em cópia oculta.                                 |
| Assunto                       | string | Sim      | Assunto da mensagem.                                                    |
| Responder Para                | string | Não      | Endereço de e-mail para respostas.                                      |
| Configuração do Corpo         | object | Sim      | Configuração do corpo da mensagem.                                      |
| Anexos                        | array  | Não      | Lista de arquivos ou conteúdos a anexar.                                |

::Image[]{src="https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/XL7gVvrNQQ4uIbOlHpaCr-20260225-142923.gif" darkSrc="https://archbee-image-uploads.s3.amazonaws.com/G1NTw6yAi4RDUYbsU8csp/XL7gVvrNQQ4uIbOlHpaCr-20260225-142923.gif" size="80" width="1920" height="1080" darkWidth="1920" darkHeight="1080" position="center" showCaption="false"}

***

**Configuração do corpo**

O campo `Configuração do Corpo` é um objeto que define o formato e conteúdo da mensagem. Ele pode ser configurado para enviar mensagens em texto simples ou HTML. A configuração detalhada do corpo é essencial para garantir que a mensagem seja formatada corretamente e entregue ao destinatário conforme esperado.

1. **Texto**

-  Texto simples
- Template
  - Utiliza a configuração de template da Fluid para gerar o conteúdo do e-mail, oferecendo flexibilidade para criar mensagens ricas e dinâmicas com base em dados do fluxo.

***

2. **HTML**

- Template HTML
  - Utiliza a configuração de template da Fluid para gerar o conteúdo HTML do e-mail, permitindo criar mensagens visualmente atraentes e personalizadas com base em dados do fluxo.

***

**Inline images (opcional)**

Cada item pode ser:

1. **Arquivo**

| Campo   | Tipo   | Obrigatorio |
| ------- | ------ | ----------- |
| Nome    | string | Sim         |
| Caminho | string | Sim         |
| CID     | string | Sim         |

![]()

2. **Base64**

| Campo    | Tipo   | Obrigatorio |
| -------- | ------ | ----------- |
| Nome     | string | Sim         |
| Conteúdo | string | Sim         |
| CID      | string | Sim         |

![]()

**Anexos**

Cada item pode ser:

1. **Arquivo**

| Campo   | Tipo   | Obrigatorio |
| ------- | ------ | ----------- |
| Nome    | string | Sim         |
| Caminho | string | Sim         |

![]()

2. **Base64 (**`base64`**)**

| Campo    | Tipo   | Obrigatorio |
| -------- | ------ | ----------- |
| Nome     | string | Sim         |
| Conteudo | string | Sim         |

![]()

***



### Operação: Enviar com Template

****

**Exemplo de payload para envio de e-mail com anexos:**

:::BlockQuote
\{
  "from": "financeiro\@suaempresa.com",
  "to": \["cliente\@hotmail.com"],
  "subject": "Seus Documentos Seguem em Anexo",
  "body\_format": "text/html",
  "body": \{
    "type": "text",
&#x20;   "value": "\<h1>Olá!\</h1>\<p>Conforme solicitado, seguem em anexo os documentos gerados pelo sistema.\</p>"
&#x20; },
&#x20; "attachment": \[
&#x20;   \{
&#x20;     "filename": "relatorio\_vendas.pdf",
&#x20;     "source\_type": "file",
&#x20;     "content": "vendas\_2024.pdf"
&#x20;   },
&#x20;   \{
&#x20;     "filename": "comprovante.xml",
&#x20;     "source\_type": "base64",
&#x20;     "content": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz4KPGNvbXByb3ZhbnRlPjEyMzQ1NjwvY29tcHJvdmFudGU+"
&#x20;   }
&#x20; ]
}
:::

**Exemplo de payload para envio de e-mail simples:**

:::BlockQuote
\{
&#x20; "from": "no-reply\@suaempresa.com",
&#x20; "to": \["cliente1\@gmail.com", "cliente2\@gmail.com"],
&#x20; "cc": \["copia\@suaempresa.com"],
&#x20; "bcc": \[],
&#x20; "reply\_to": "suporte\@suaempresa.com",
&#x20; "subject": "Boas-vindas ao nosso sistema",
&#x20; "body\_format": "text/plain",
&#x20; "body": \{
&#x20;   "type": "text",
&#x20;   "value": "Olá!\n\nSeja muito bem-vindo ao nosso sistema. É um prazer ter você conosco.\n\nAtenciosamente,\nEquipe."
&#x20; }
}
:::

**Explicação dos campos do payload:**

**Objeto Principal: config**

Configurações de envio da mensagem.

- **from**: Endereço de e-mail do remetente (quem está enviando).
- **to**: Lista (array) de strings contendo os endereços de e-mail dos destinatários principais.
- **cc** *(opcional)*: Lista (array) de strings com os endereços de e-mail que receberão cópia.
- **bcc** *(opcional)*: Lista (array) de strings com os endereços de e-mail que receberão cópia oculta.
- **reply\_to** *(opcional)*: Endereço de e-mail para o qual as respostas dos usuários devem ser direcionadas.
- **subject**: Assunto do e-mail.
- **body\_format**: Define o formato do corpo do e-mail. Valores aceitos: text/plain ou text/html.

**Objeto: body (dentro de config)**

- **type**: Define a origem do dado. Valores aceitos: "text" (valor literal).
-

**Nota:** O value deve ser uma string escapada corretamente, especialmente se contiver caracteres especiais ou HTML.

**value**: O conteúdo em si do corpo do e-mail (HTML ou texto). Obrigatório não ser vazio.

**Objeto: attachment (Lista dentro de config - *opcional*)**

Lista de arquivos anexos.

- **filename**: Nome do arquivo com a sua extensão (ex: relatorio\_mensal.pdf).
- **source\_type**: Formato de origem do anexo. Valores aceitos: file (para referenciar arquivos no disco gerados no fluxo) ou base64 (para enviar os bytes codificados).
- **content**: O conteúdo real do anexo. Se source\_type para file, deve ser o caminho (path) do arquivo. Se for base64, deve ser a string em Base64.

**Objeto: inline\_image (Lista dentro de config - *opcional*)**

Lista de imagens para serem embutidas diretamente no corpo HTML do e-mail. *(Nota: só é permitido se body\_format for text/html)*.

- **filename**: Nome do arquivo de imagem (ex: logo.png).
- **source\_type**: Formato de origem da imagem. Valores aceitos: file ou base64.
- **content**: Caminho do arquivo da imagem ou a sua respectiva string Base64.
- **cid**: Identificador único (Content-ID) usado para referenciar a imagem no código HTML do body (ex: se o cid for logo1, no HTML da mensagem você usará \<img src="cid\:logo1">).



##

***

## Na prática

### Envio de e-mail simples:

![]()

### Envio de e-mail com HTML e Inline Images:

![]()

### Envio de e-mail com anexos:

![]()

### Reply-To:

![]()



## Observações adicionais

- Rate limits: Verificar limites de envio do provedor SMTP para evitar bloqueios.
- Tamanho de mensagens: Depende do servidor SMTP, mas geralmente recomendado manter abaixo de 10-25MB.
- Utilizar templates para mensagens mais ricas e personalizadas, melhorando a experiência do destinatário.
- Validar conteúdo do e-mail para evitar erros de formatação ou problemas de renderização em diferentes clientes de e-mail.
- Segurança: Usar conexões seguras (SSL/TLS) sempre que possível.

## Conclusão

O conector E-mail (SMTP) é uma ferramenta poderosa para integrar o envio de e-mails diretamente em fluxos da plataforma Fluid, permitindo automação de comunicações, notificações e relatórios. Com suporte a texto, HTML e anexos, ele oferece flexibilidade para atender a diversos cenários de comunicação. A configuração adequada da conexão e do corpo da mensagem é essencial para garantir entregabilidade e segurança.