Templates de execução, SMTP e notificações

Separar conteúdo, transporte e política

O conteúdo de email, o transporte SMTP e a política de notificações são configurações distintas. Execution email template define assunto e corpos; Email delivery define o transporte de plataforma; Notifications escolhe eventos, canais e condições. Um preview válido não comprova entrega, e uma conexão SMTP aceita não prova que um evento deva gerar uma mensagem.

Confirme tenant, escopo e herança, além da autorização de consulta ou gerenciamento. A administração global de SMTP exige Platform Administrator autorizado. Use dados de execução sintéticos e um destinatário de laboratório sob seu controle, sem enviar testes a clientes reais.

Editar o template de execução

1. Abra Preferences → Notifications → Execution email template.
2. Confira o escopo e a herança antes de alterar um template que possa ser compartilhado.
3. Escolha pelo menos um resultado: succeeded, failed ou cancelled.
4. Preencha assunto e preheader opcional, sem quebras de linha.
5. Edite HTML e texto simples. O texto é obrigatório e deve transmitir o mesmo resultado útil do HTML.
6. Insira variáveis do catálogo do editor na sintaxe com percentuais.
7. Confira preview em largura estreita, títulos, contraste, links e equivalência entre os corpos.
8. Salve, recarregue e confirme a persistência antes de testar o envio.

Campos e variáveis

Esses limites não são metas de tamanho. Prefira mensagens curtas que apontem para o detalhe autorizado, sem logs completos ou informações sensíveis. O preview pode representar imagens remotas de forma restrita; sua ausência não autoriza enfraquecer controles de conteúdo ativo.

Assunto: Resultado %STATUS% de %WORKFLOW_NAME%
Execução: %RUN_ID%
Linhas de saída: %OUTPUT_ROWS%
Detalhe autorizado: %EXECUTION_URL%

Use cada nome entre percentuais, como %WORKFLOW_NAME%. Variáveis desconhecidas são rejeitadas; não invente sintaxe de template ou trate o corpo como código executável. O HTML permitido é restrito e sanitizado.

Configurar o transporte SMTP

1. Abra Preferences → Email delivery com a autoridade de plataforma exigida.
2. Revise SMTP host, Port, Encryption, Username, From name, From email e Reply-to email.
3. Preencha Replace password somente se for substituir a credencial armazenada; em branco preserva o valor atual conforme a indicação do formulário.
4. Defina Test recipient email com uma caixa controlada.
5. Use Save email e o Test SMTP suportado pelo formulário.
6. Use Send test email e confira recebimento, assunto, texto e leitura dos links, além da aceitação inicial do transporte.

Configurar a política

Em Notifications, revise Show action notifications, Position, Duration (seconds) e Maximum visible. Configure Delivery channels, Events and severity, papéis destinatários, limites, deduplicação, escalonamento e digest conforme a necessidade. Webhooks e endpoints de canais são sensíveis e não devem aparecer em exemplos ou capturas.

Nos horários silenciosos, confira fuso e ambos os limites de horário. Preview, Test channels e Save preferences verificam aspectos diferentes. Consulte Delivery history: sent, failed, suppressed e acknowledged não são equivalentes. Uma entrega suprimida pela política não deve ser diagnosticada automaticamente como falha SMTP.

Exemplo e recuperação

Em laboratório, prepare uma execução fictícia com falha e renderize os dois corpos do template. Confira substituição de variáveis e rejeição de uma variável desconhecida. Em um sandbox separado, envie a uma caixa controlada e verifique conteúdo e recebimento. Registre persistência, política e entrega como resultados separados, sem credenciais ou dados reais de execução.

Se o teste falhar, preserve a mensagem segura e investigue uma camada por vez: conteúdo, conexão e autenticação, depois política. Confira seleção de eventos, horário silencioso e deduplicação antes de repetir. Uma alteração de senha sem identificar a causa pode introduzir outra falha.

Consulte também: Preferences, Users, Audit.