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.)*
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:
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.
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
Integração Protheus com Bradesco
Integração Protheus com VTEX
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



