Guia prático da harpix

Como enviar e-mails e workflow do Protheus pelo Gmail e Google Workspace

No Configurador do Protheus (Ambiente > E-mail/Proxy), informe smtp.gmail.com na porta 587 com TLS, ou 465 com SSL, o e-mail completo da conta e uma senha de app do Google no lugar da senha normal. No Google Workspace, a opção que o Google recomenda para apps é o redirecionamento SMTP (smtp-relay.gmail.com), autenticado pelo IP do servidor. Para alertas e aprovações entre sistemas, o harpix integration hub conecta o Protheus ao Gmail e ao Google Workspace. *(Fora do bloco AEO.)*

Diagrama da integração: Protheus, harpix integration hub e Gmail, no fluxo de ida e volta
Diagrama da integração: Protheus, harpix integration hub e Gmail, no fluxo de ida e volta
Fluxo de ida e volta: Protheus para o harpix integration hub e para Gmail, e o retorno volta para Protheus
Fluxo de ida e volta: Protheus para o harpix integration hub e para Gmail, e o retorno volta para Protheus

Por que o e-mail do Protheus pelo Gmail para de funcionar

Muitas empresas configuraram o Protheus para enviar relatórios, workflow e avisos com o usuário e a senha de uma conta do Gmail ou do Google Workspace. Duas mudanças do Google explicam a maior parte das falhas:

  1. Fim do login só com usuário e senha. Pela ajuda do Google Workspace, desde 1º de maio de 2025 as contas do Google Workspace não aceitam apps de terceiros que entram só com usuário e senha. As saídas são senha de app, OAuth ou o redirecionamento SMTP. Para contas do Gmail, a TOTVS já orientava a troca por senha de app desde 2022.

  2. Senha de app revogada. O Google revoga as senhas de app quando a senha da Conta do Google é trocada. Se o envio parou de repente depois de uma troca de senha, gere uma senha de app nova e atualize o Protheus.

Se o teste de envio no Configurador falha com erro de autenticação, estes são os primeiros pontos a conferir.

Passo a passo

Passo 1. Mapeie o que o Protheus envia por e-mail

Liste relatórios, workflows e avisos de eventos que saem por e-mail do Protheus e qual conta do Google envia cada um.

Passo 2. Escolha a forma de autenticação no Google

Use uma senha de app da conta remetente ou, no Google Workspace, o redirecionamento SMTP autenticado pelo IP do servidor do Protheus.

Passo 3. Gere a senha de app

Na Conta do Google remetente, ative a verificação em duas etapas, crie uma senha de app com um nome como Protheus e copie os 16 caracteres sem espaços.

Passo 4. Configure o e-mail no Configurador

Em Configurador > Ambiente > E-mail/Proxy > Configurar, informe smtp.gmail.com:587 com TLS ou smtp.gmail.com:465 com SSL, o e-mail completo, a senha de app e autenticação ativa, com o remetente igual à conta.

Passo 5. Atualize o workflow e os parâmetros de senha

Em Configurador > Ambiente > Workflow > Contas de e-mail, troque a senha antiga pela senha de app e use a mesma senha nos parâmetros MV_RELPSW, MV_RELAPSW e MV_EMSENHA.

Passo 6. Teste e monitore

Envie um relatório e um workflow de teste, confira a mensagem de sucesso e acompanhe as falhas de envio.

Dica: no Protheus, a porta vai junto do endereço do servidor, separada por dois-pontos (smtp.gmail.com:587). Pela TOTVS, o Gmail usa a porta 465 com SSL e a 587 com TLS.

Os nomes de telas e parâmetros do Protheus variam por release. Siga a documentação oficial da TOTVS (Central de Atendimento) para a sua versão.

Quando o e-mail não basta: alertas e aprovações

Configurar o SMTP resolve o envio. Muitas empresas, porém, querem aprovar pelo Gmail, conforme o desenho do projeto, ou mandar relatórios direto para o Google Workspace. É aqui que entra o harpix integration hub.

Fluxos comuns

Fluxo

De → para

Exemplo

Alerta de evento do ERP

Protheus → Gmail

Título vencido, pedido bloqueado por crédito, estoque abaixo do mínimo

Pedido de aprovação

Protheus → Gmail

Solicitação de compra ou pedido aguardando aprovação

Relatório agendado para um grupo

Protheus → Google Workspace (Planilhas ou Drive)

Posição diária de faturamento por filial

Documento arquivado

Protheus → Google Drive

PDF do pedido ou da nota em pasta do cliente

O harpix integration hub conecta Protheus, Gmail, Google Workspace e Google Drive, com monitoramento e rastreabilidade de cada mensagem. A vitrine de integrações da harpix reúne 200 sistemas, em 10 grupos (harpix.com.br/integracoes). Com o harpix integration hub, a integração se torna nativa com qualquer sistema de mercado. Quando os dados já estão integrados, o harpix data hub leva dashboards, BI e IA para cima deles: harpix.com.br/produtos/data-hub

Links internos

TOTVS e Protheus são marcas da TOTVS S.A. Google, Gmail, Google Workspace e Google Drive são marcas da Google LLC. A harpix não tem vínculo com essas empresas, salvo quando indicado. Este guia é informativo e não substitui a documentação oficial da TOTVS e do Google.

Perguntas frequentes

O Protheus envia e-mail pelo Gmail?

Sim. A TOTVS documenta a configuração de e-mail do Protheus no Configurador usando uma conta do Gmail como exemplo. Hoje, a conta do Google precisa de uma senha de app ou do redirecionamento SMTP do Google Workspace, porque usuário e senha comuns não são mais aceitos.

Por que o Protheus parou de enviar e-mails pelo Gmail?

Os motivos mais comuns são dois. O Google deixou de aceitar usuário e senha comuns em apps de terceiros: no Google Workspace, desde 1º de maio de 2025. E o Google revoga as senhas de app quando a senha da conta é trocada, então uma troca de senha derruba o envio até uma nova senha de app ser gerada.

Quais são os dados de SMTP do Gmail para o Protheus?

Pela ajuda do Google Workspace, o servidor smtp.gmail.com usa a porta 465 com SSL ou 587 com TLS, com o e-mail completo e uma senha de app. No Protheus, a porta vai junto do endereço, como smtp.gmail.com:587. O redirecionamento SMTP usa smtp-relay.gmail.com, autenticado pelo IP.

Onde fica a senha do workflow do Protheus?

Segundo a TOTVS, em Configurador > Ambiente > Workflow > Contas de e-mail. Basta trocar a senha antiga da conta Gmail pela senha de app gerada no Google. Os parâmetros de senha do e-mail, como MV_RELPSW, MV_RELAPSW e MV_EMSENHA, devem usar a mesma senha de app.

Não encontro a opção de senha de app na conta do Google Workspace. E agora?

Pela ajuda do Google, a opção pode não aparecer em contas de trabalho, em contas com verificação em duas etapas só por chave de segurança ou com Proteção Avançada. Nesse caso, fale com o administrador do Google Workspace, que pode liberar o recurso ou configurar o redirecionamento SMTP para o servidor do Protheus.

Dá para receber aprovações do Protheus no Gmail e responder por lá?

Com o harpix integration hub, alertas e pedidos de aprovação do Protheus podem chegar ao Gmail, e a resposta pode voltar para o Protheus, conforme o fluxo definido no projeto.

Fale com um especialista

Conte quais sistemas você usa e o que precisa circular entre eles. A harpix parte do que você já tem.

Fale com a gente