Data de publicação: 11/02/2026

🎯 Objetivo

Orientar a configuração do SMTP no TOTVS Protheus (Framework) para permitir o envio de relatórios por e-mail, garantindo que rotinas e impressões possam disparar mensagens com anexos (PDF/CSV/TXT, conforme cenário).

🧩 Quando usar

• Relatórios que precisam ser enviados automaticamente para gestores/áreas.

• Rotinas que disparam e-mails com anexos (relatórios, conferências, notificações).

• Ambientes que migraram de servidor/rede e perderam a configuração de envio.

🖥️ Ambiente

• TOTVS Protheus – Framework

• Linha Protheus

• A partir da versão 11 (conceito aplicável também às versões superiores)

✅ Pré-requisitos (antes de configurar)

• ✅ Endereço do servidor SMTP (ex.: smtp.empresa.com)

• ✅ Porta (25 / 587 / 465 — conforme a política da empresa)

• ✅ Tipo de segurança: TLS/STARTTLS ou SSL

• ✅ Credenciais (usuário/senha) e permissão de envio

• ✅ Liberação de rede/firewall do AppServer para o SMTP

• ✅ Endereço de remetente válido (from)

⚙️ Configuração do SMTP no Protheus

🧭 1) Configurar parâmetros de e-mail no ambiente

A configuração pode variar conforme arquitetura/versão, mas normalmente envolve definir o servidor SMTP, porta, autenticação e remetente no ambiente Protheus.

Recomenda-se validar/centralizar estas informações no Configurador (SIGACFG) quando disponível no seu cenário:

Caminho sugerido:

• SIGACFG → Ambientes → (Configurações / Parâmetros / E-mail / Internet)
  (Os nomes podem variar conforme versão e customizações.)

Preencha os campos típicos:

• Servidor SMTP

• Porta

• Requer autenticação (Sim/Não)

• Usuário

• Senha

• Segurança (TLS/SSL, quando disponível)

• Remetente (From) / Nome do remetente

Observação: dependendo do ambiente, parte dessas definições pode ser feita também no AppServer (arquivo de configuração), especialmente quando a estrutura de e-mail é tratada pelo servidor de aplicação.

🛠️ 2) Ajustar configurações no AppServer (quando aplicável)

Em muitos cenários, o AppServer precisa estar com as informações de e-mail definidas (principalmente servidor/porta/credenciais), para que as rotinas consigam efetivamente conectar no SMTP.

Itens que normalmente precisam estar coerentes:

• Host do SMTP

• Porta

• Autenticação

• Usuário/Senha

• TLS/SSL

• Remetente padrão

Se você possui múltiplos AppServers (ex.: Balance/Cluster), garanta que a configuração esteja replicada/consistente em todos.

🧪 3) Testar o envio por e-mail com um relatório

Após configurar:

1. Execute um relatório padrão do Protheus que tenha opção de envio por e-mail.

2. Utilize um destinatário interno para teste.

3. Verifique:

   • recebimento do e-mail

   • anexos gerados corretamente

   • remetente e assunto adequados

   • tempo de envio e possíveis mensagens de erro

🔎 Boas práticas recomendadas

• ✅ Use uma conta de serviço dedicada (ex.: [email protected])

• ✅ Prefira porta 587 com TLS/STARTTLS quando a política exigir

• ✅ Configure remetente coerente com SPF/DMARC (evita bloqueios e spam)

• ✅ Monitore falhas de envio em logs do AppServer

• ✅ Em ambientes críticos, utilize fila/rotina controlada para disparos em massa

🧯 Troubleshooting

🚫 “Falha ao conectar no servidor SMTP”

Verifique:

• servidor SMTP e porta corretos

• DNS resolvendo no servidor do AppServer

• firewall liberado para saída (porta 25/587/465)

• exigência de TLS/SSL compatível com o configurado

🔒 “Autenticação inválida” / “Usuário ou senha incorretos”

Verifique:

• credenciais corretas

• política de senha expirada

• MFA/2FA (se houver, use senha de aplicativo quando aplicável)

• permissões de envio dessa conta

📎 E-mail vai, mas sem anexo / anexo corrompido

Verifique:

• caminho/geração do arquivo do relatório

• permissões de gravação em diretórios temporários do AppServer

• tamanho máximo permitido no SMTP/Exchange/Gmail corporativo

• antivírus/quarentena bloqueando anexos

📭 E-mail cai no spam

Verifique:

• remetente (from) alinhado ao domínio

• SPF/DMARC/DKIM do domínio configurados na infraestrutura

• conteúdo/assunto/assinatura padrão que dispare filtros

❓ FAQ

1) Preciso configurar SMTP no Configurador e no AppServer?

Depende do seu ambiente. Em muitos casos, o Configurador define parâmetros funcionais e o AppServer garante a conectividade efetiva. O importante é tudo estar coerente (host/porta/credenciais/segurança).

2) Qual porta devo usar?

Depende do seu provedor/infra:

• 25: comum em redes internas, frequentemente bloqueada para saída externa

• 587: padrão moderno para envio autenticado com TLS/STARTTLS

• 465: SMTPS (SSL) — usado em alguns provedores

3) Posso usar e-mail pessoal (ex.: Gmail) no Protheus?

Em ambiente corporativo, o ideal é conta corporativa/serviço. Provedores com MFA e políticas rígidas podem exigir configurações adicionais (senha de app, políticas de segurança, etc.).

4) O envio de relatório por e-mail depende de mais alguma configuração?

Além do SMTP, depende da rotina/relatório suportar envio e o ambiente conseguir gerar o arquivo (permissões e diretórios temporários do AppServer).

👤 Autor

Fabrizio Augusto Ventavolo — Mastersiga Consultoria