Guia prático · TOTVS Protheus

SMTP no Protheus: como configurar o envio de e-mail

O Protheus envia e-mail de relatórios, workflow e de várias rotinas usando um conjunto de parâmetros que começam com MV_REL. Quase todo problema de envio vem da combinação de servidor, porta, SSL e TLS. Abaixo, o que é cada parâmetro e as configurações prontas para Office 365, Gmail e relay SMTP.

Pela equipe técnica do Sender25 Atualizado em 14/10/2026 Leitura: 7 min

Quais parâmetros configuram o e-mail no Protheus?

Os parâmetros MV_REL do módulo Configurador (SIGACFG). Eles dizem ao Protheus por qual servidor enviar, com qual conta, se precisa de autenticação e qual tipo de conexão segura usar. Segundo a própria TOTVS, os parâmetros que começam com MV_REL são, em sua maioria, os responsáveis pela configuração de e-mail.

MV_RELSERV: servidor de envio (SMTP). A porta costuma ir junto, no formato servidor:porta.
MV_RELACNT: conta de e-mail usada no envio.
MV_RELPSW: senha dessa conta.
MV_RELAUTH: o servidor exige autenticação? .T. ou .F.
MV_RELAUSR: usuário para autenticar no servidor.
MV_RELAPSW: senha para autenticar no servidor.
MV_RELFROM: e-mail que aparece no campo "De" (remetente).
MV_RELSSL: usa conexão segura do tipo SSL? .T. ou .F.
MV_RELTLS: o servidor usa conexão segura do tipo TLS? .T. ou .F.
MV_PORSMTP: porta do servidor SMTP, usada por algumas rotinas.

Alguns módulos têm parâmetros próprios com a mesma função (no RH, por exemplo, MV_RHSERV, MV_RHCONTA e MV_RHAUTEN). Se um módulo específico não envia, confira se ele não lê um conjunto próprio.

Fontes: TDN, configuração de envio de e-mail e Central de Atendimento TOTVS, parâmetros de envio de e-mail (atualizado em 04/09/2026).

Qual porta usar e quando ligar SSL ou TLS?

A regra que evita a maior parte dos erros: porta 465 é SSL; portas 587 e 2525 são TLS (STARTTLS). Nunca ligue os dois juntos.

Porta 587 ou 2525 (STARTTLS)

MV_RELTLS = .T.
MV_RELSSL = .F.
É o caso do Office 365 (587) e dos relays SMTP (2525).

Porta 465 (SSL direto)

MV_RELSSL = .T.
MV_RELTLS = .F.
É a configuração que a TOTVS documenta para o Gmail.

Coloque a porta no MV_RELSERV (por exemplo, smtp.office365.com:587) e, se o parâmetro MV_PORSMTP existir no seu ambiente, repita a mesma porta nele. A própria TOTVS mostra os dois preenchidos.

Como configurar o Protheus com o Office 365?

Parâmetros: Office 365

MV_RELSERV = smtp.office365.com:587
MV_RELACNT = nfe@suaempresa.com.br
MV_RELPSW  = (senha da caixa)
MV_RELAUTH = .T.
MV_RELAUSR = nfe@suaempresa.com.br
MV_RELAPSW = (senha da caixa)
MV_RELFROM = nfe@suaempresa.com.br
MV_RELTLS  = .T.
MV_RELSSL  = .F.
MV_PORSMTP = 587

O SMTP AUTH precisa estar ligado na caixa usada. Se der 535 5.7.139, ele está desligado. E atenção: a Microsoft passa a desligar o SMTP AUTH por padrão no fim de dezembro de 2026. Veja o guia SMTP do Office 365 parou no ERP.
Se o MV_RELFROM for diferente da conta que autentica, essa conta precisa da permissão Enviar como na caixa do remetente. Sem ela, a Microsoft devolve o erro 5.7.60.
Contas com verificação em duas etapas não autenticam com a senha normal.

Como configurar o Protheus com o Gmail?

A configuração documentada pela TOTVS usa SSL na porta 465:

Parâmetros: Gmail / Google Workspace

MV_RELSERV = smtp.gmail.com:465
MV_RELACNT = nfe@suaempresa.com.br
MV_RELPSW  = (senha de app)
MV_RELAUTH = .T.
MV_RELAUSR = nfe@suaempresa.com.br
MV_RELAPSW = (senha de app)
MV_RELFROM = nfe@suaempresa.com.br
MV_RELSSL  = .T.
MV_RELTLS  = .F.
MV_PORSMTP = 465

O artigo da TOTVS (de 2024) manda ativar o acesso a "aplicativos menos seguros". Essa opção não existe mais: o Google a desativou no Workspace em setembro de 2024. Hoje o caminho é ligar a verificação em duas etapas na conta e gerar uma senha de app para o Protheus. Lembre também que o Google Workspace limita o envio por usuário a 2.000 mensagens por dia.

Fonte: Central de Atendimento TOTVS, configuração do Gmail no Protheus.

Como configurar o Protheus com um relay SMTP?

Um relay SMTP é um servidor feito para envio de sistemas. Ele continua aceitando usuário e senha, não esbarra no limite diário de uma caixa de usuário e registra cada envio. Com o Sender25:

Parâmetros: Sender25

MV_RELSERV = smtp-a.sender25.com:2525
MV_RELACNT = nfe@suaempresa.com.br
MV_RELPSW  = (senha da credencial SMTP)
MV_RELAUTH = .T.
MV_RELAUSR = (usuário da credencial SMTP)
MV_RELAPSW = (senha da credencial SMTP)
MV_RELFROM = nfe@suaempresa.com.br
MV_RELTLS  = .T.
MV_RELSSL  = .F.
MV_PORSMTP = 2525

A credencial SMTP é gerada no painel do Sender25. O remetente (MV_RELFROM) precisa ser de um domínio autenticado no painel, com SPF e DKIM.
A caixa de e-mail da empresa continua onde está (Office 365, Google ou outro), e as respostas dos clientes continuam chegando nela.
Se a rede do servidor do Protheus bloquear a porta 2525, use a 25.

Como testar o envio?

O teste mais simples usa um recurso que o próprio Protheus já tem: emitir qualquer relatório escolhendo Tipo de impressão › E-mail e informar um destinatário seu no campo Para. Se o relatório chegar, os parâmetros MV_REL estão certos.

Quais são os erros mais comuns?

Falha na conexão com o servidor

Quase sempre é porta e segurança trocadas (465 com TLS, 587 com SSL), servidor digitado errado ou porta bloqueada no firewall da rede do Protheus.

535 5.7.139

Office 365 com SMTP AUTH desligado na empresa ou na caixa. Veja como resolver.

535 ou "autenticação falhou"

Usuário ou senha errados em MV_RELAUSR/MV_RELAPSW, MV_RELAUTH = .F. num servidor que exige login, ou conta com verificação em duas etapas.

5.7.60

No Office 365, a conta que autentica não tem permissão para enviar como o endereço do MV_RELFROM.

O XML e o DANFE da NF-e saem por esses parâmetros?

Não necessariamente. Os parâmetros MV_REL valem para relatórios, workflow e diversas rotinas. O envio automático do XML e do DANFE ao destinatário da nota costuma ser feito pelo TSS (TOTVS Service SPED), que tem configuração de e-mail própria, feita no assistente de configuração da rotina de documentos eletrônicos. Se a nota é autorizada mas o e-mail não chega ao cliente, o lugar para olhar é o TSS, não os MV_REL.

Os mesmos dados de servidor, porta, TLS e autenticação desta página valem lá. O passo a passo está em Como enviar XML e DANFE por e-mail no Protheus (TSS).

Perguntas frequentes

Onde configuro o SMTP no Protheus?

Nos parâmetros MV_REL do módulo Configurador (SIGACFG): MV_RELSERV (servidor), MV_RELACNT e MV_RELPSW (conta e senha), MV_RELAUTH, MV_RELAUSR e MV_RELAPSW (autenticação), MV_RELFROM (remetente), e MV_RELSSL e MV_RELTLS (segurança).

Qual porta usar no Protheus para enviar e-mail?

Depende do servidor. Com STARTTLS, o comum é 587 (ou 2525 em relays), com MV_RELTLS = .T. e MV_RELSSL = .F. Com SSL direto, a porta é 465, com MV_RELSSL = .T. e MV_RELTLS = .F. A porta costuma ir junto do servidor no MV_RELSERV, no formato servidor:porta.

Como configurar o Protheus com o Office 365?

Use smtp.office365.com:587 no MV_RELSERV, MV_RELTLS = .T., MV_RELSSL = .F. e MV_RELAUTH = .T., com a caixa e a senha nos parâmetros de autenticação. O SMTP AUTH precisa estar habilitado na caixa, e a Microsoft passa a desligá-lo por padrão no fim de dezembro de 2026.

Por que o Protheus mostra falha na conexão com o servidor de e-mail?

Normalmente é a combinação errada de porta com SSL ou TLS (por exemplo, porta 465 com TLS ligado), servidor digitado errado ou a porta bloqueada no firewall da rede onde o Protheus roda.

O XML e o DANFE da NF-e saem por esses parâmetros?

Não necessariamente. Os parâmetros MV_REL valem para relatórios, workflow e várias rotinas. O envio do XML e do DANFE ao destinatário costuma ser feito pelo TSS, que tem configuração de e-mail própria.

Protheus enviando sem depender da caixa de um usuário

Troque o servidor nos MV_REL e acompanhe a entrega de cada e-mail: status, código de resposta, tempo e provedor de destino. Teste 30 dias grátis, sem cartão.

Testar grátis por 30 dias Falar com a gente