SMTP

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 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 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" "financeiro\@suaempresa com", "to" \["cliente\@hotmail com"], "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" "no reply\@suaempresa com", "to" \["cliente1\@gmail com", "cliente2\@gmail com"], "cc" \["copia\@suaempresa com"], "bcc" \[], "reply to" "suporte\@suaempresa com", "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