SMTP

25 min

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

Acesse Conexões > Nova conexão > E-mail (SMTP).

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.

(Opcional) Configurações avançadas e Proxy: configure apenas se sua rede exigir.

Clique em Salvar conexão e utilize Testar para validar.

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: [email protected]).
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.

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.

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.

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:

Arquivo

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

Base64

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

Anexos

Cada item pode ser:

Arquivo

Campo	Tipo	Obrigatorio
Nome	string	Sim
Caminho	string	Sim

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:

{ "from": "[email protected]", "to": ["[email protected]"], "subject": "Seus Documentos Seguem em Anexo", "body_format": "text/html", "body": { "type": "text", "value": "<h1>Olá!</h1><p>Conforme solicitado, seguem em anexo os documentos gerados pelo sistema.</p>" }, "attachment": [ { "filename": "relatorio_vendas.pdf", "source_type": "file", "content": "vendas_2024.pdf" }, { "filename": "comprovante.xml", "source_type": "base64", "content": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz4KPGNvbXByb3ZhbnRlPjEyMzQ1NjwvY29tcHJvdmFudGU+" } ] }

Exemplo de payload para envio de e-mail simples:

{ "from": "[email protected]", "to": ["[email protected]", "[email protected]"], "cc": ["[email protected]"], "bcc": [], "reply_to": "[email protected]", "subject": "Boas-vindas ao nosso sistema", "body_format": "text/plain", "body": { "type": "text", "value": "Olá!\n\nSeja muito bem-vindo ao nosso sistema. É um prazer ter você conosco.\n\nAtenciosamente,\nEquipe." } }

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.