📅 Data de publicação: 19/02/2026

🎯 Objetivo

Orientar a configuração do SMTP no Protheus para permitir o envio de relatórios por e-mail, usando a rotina E-mail/Proxy do Configurador.

🧩 Ambiente

• Microsiga Protheus

• Framework / Configurador

• Versão: 12 (aplicável a cenários equivalentes)

✅ Pré-requisitos

• Conta de e-mail com permissão de envio via SMTP (Gmail, Office 365/Exchange Online, ou outro provedor)

• Informações do provedor SMTP:

  • Servidor/host SMTP

  • Porta

  • Usuário (conta)

  • Senha

  • Tipo de segurança (TLS/SSL)

• Se houver Proxy no servidor do AppServer, ter os dados do proxy (host, porta, usuário/senha se exigido)

🛠️ Passo a passo

1) 🧭 Acessar a rotina de configuração

1. Abra o Configurador (SIGACFG)

2. Acesse: Ambiente > E-mail/Proxy > Configurar

Essa rotina grava as configurações e, ao final, pode gerar/atualizar a seção correspondente no appserver.ini.

2) 🔌 Informar servidor SMTP e porta corretamente

⚠️ Atenção às portas

Atualmente, a maioria dos provedores utiliza portas diferentes da “padrão”. As mais comuns são:

• 465 (geralmente com SSL)

• 587 (geralmente com TLS)

✅ Informe a porta junto ao servidor, no formato:

• smtp.seuprovedor.com:587

Exemplo (Gmail)

• Para SSL: porta 465

• Para TLS: porta 587

O tipo de segurança (TLS/SSL) normalmente é definido nas telas seguintes da configuração.

3) 🧾 Preencher credenciais e autenticação

Na configuração do E-mail/Proxy:

• Conta: e-mail completo (ex.: [email protected])

• Senha: senha da conta (ou senha de app, se aplicável)

• Servidor necessita autenticação?: SIM (na maioria dos casos)

4) 🕒 Ajustar parâmetros complementares

Recomendações comuns:

• Time-out: 120 segundos (ajuste conforme latência/infra)

• FROM (Remetente): obrigatoriamente o mesmo e-mail da conta configurada

5) 🛡️ Selecionar protocolo e segurança (TLS/SSL)

Defina conforme seu provedor:

• Protocolo de envio: SMTP

• Opções típicas em provedores modernos:

  • SMTP Extended: Sim

  • AUTH LOGIN: Sim

  • TLS: Sim (quando usando 587)

  • SSL: Sim (quando usando 465)

Em alguns ambientes, pode ser necessário habilitar opções adicionais como NTLM, dependendo do provedor e da política da empresa.

6) 🌐 Configuração com Proxy (se existir)

Se o AppServer estiver em um servidor com Proxy configurado:

1. Ative a opção “Utilizar servidor de Proxy”

2. Preencha os dados do proxy conforme a infraestrutura (host, porta e credenciais quando necessário)

7) 🧷 Exemplo pronto: Office 365 (Exchange Online)

Se o provedor for Office 365, utilize como referência:

Página 1 (Servidor/Conta)

• Servidor SMTP: smtp.office365.com:587

• Conta: seu e-mail (ex.: [email protected])

• Senha: sua senha

• Servidor necessita autenticação?: Sim

Página 2

• Time-out: 120

• FROM: o mesmo e-mail da conta

Página 3 (Segurança/Autenticação)

• Protocolo: SMTP

• SMTP Extended: Sim

• AUTH LOGIN: Sim

• TLS: Sim

• SSL: Sim (dependendo das opções do ambiente)

• NTLM: conforme necessidade

⚠️ Importante (Office 365)

Algumas organizações exigem habilitação explícita de envio por SMTP/cliente no usuário do Microsoft 365. Se o envio falhar, valide no admin do M365 se o usuário tem permissão para usar SMTP/autenticação conforme a política aplicada.

8) ⚖️ Cenário com balanceamento de carga (AppServer)

Se seu ambiente utiliza balanceamento, a recomendação operacional é:

1. Acesse o Configurador apontando para a porta de um serviço Slave

2. Finalize a configuração do E-mail/Proxy

3. Copie a seção [MAIL] criada/atualizada no appserver.ini desse Slave

4. Aplique a mesma seção nos demais appserver.ini do balanceamento

Exemplo de seção [MAIL]

[MAIL]
PROTOCOL=POP3
TLSVERSION=1
SSLVERSION=3
TRYPROTOCOLS=0
AUTHLOGIN=1
AUTHPLAIN=1
AUTHNTLM=1

Os parâmetros podem variar conforme o cenário, mas o ponto principal é uniformizar a configuração entre os nós.

🧪 Validação (teste de envio)

Após configurar:

1. Execute o teste de envio na própria rotina

2. Se estiver correto, o Protheus deve exibir uma mensagem de confirmação de sucesso

❓ FAQ

1) Qual porta devo usar no SMTP?

Na prática, as mais comuns são 465 (SSL) e 587 (TLS). Use a recomendada pelo seu provedor e pela política de segurança da empresa.

2) O campo FROM pode ser diferente da conta?

Em geral, não. O recomendado (e frequentemente obrigatório) é usar o mesmo e-mail da conta configurada.

3) Se o servidor tiver Proxy, é obrigatório configurar?

Sim, se o AppServer depende do Proxy para sair para a internet, habilite “Utilizar servidor de Proxy” e informe os dados corretamente.

4) Em ambiente com balanceamento, basta configurar em um AppServer?

Não. Após configurar em um nó (preferencialmente Slave), copie a seção [MAIL] para os demais appserver.ini, garantindo padronização.

5) Office 365 falha mesmo com dados corretos. O que verificar?

Além de servidor/porta/TLS, valide se o usuário do M365 está habilitado para envio conforme as políticas de autenticação/SMTP da organização.

👤 Autor

Fabrizio Augusto Ventavolo
Consultor Especialista TOTVS — Mastersiga Consultoria