Guia prático da harpix

Como enviar e-mails do Sankhya pelo Gmail e Google Workspace

Crie um aplicativo no Google Cloud e obtenha o Client ID e o Client Secret. No Sankhya Om, crie uma configuração na tela Configurações OAuth com o provedor Gmail e vincule essa configuração à conta na tela Servidor SMTP, marcando "Autenticar com OAuth". Depois, envie um e-mail de teste.

Diagrama: o Sankhya Om envia e-mails ao Gmail do Google Workspace com autenticação OAuth, usando Client ID e Client Secret
Diagrama: o Sankhya Om envia e-mails ao Gmail do Google Workspace com autenticação OAuth, usando Client ID e Client Secret
Passo a passo em 6 etapas para enviar e-mails do Sankhya pelo Gmail: mapear os envios, criar o aplicativo no Google Cloud, configurar o OAuth no Sankhya Om, informar endereços e Redirect URI, vincular o Servidor SMTP e testar
Passo a passo em 6 etapas para enviar e-mails do Sankhya pelo Gmail: mapear os envios, criar o aplicativo no Google Cloud, configurar o OAuth no Sankhya Om, informar endereços e Redirect URI, vincular o Servidor SMTP e testar

Para alertas e aprovações entre sistemas, o harpix integration hub conecta o Sankhya ao Google Workspace.

Aviso: Este guia descreve a configuração de OAuth do Sankhya e do Google. Não é uma declaração sobre os métodos de autenticação do harpix integration hub, que são avaliados em cada projeto.

Por que o e-mail do Sankhya pelo Gmail parou de funcionar

Muitas empresas configuraram o envio de e-mails do Sankhya Om com usuário e senha de uma conta do Gmail. A ajuda da Sankhya registra que, desde 30 de maio de 2022, o Google deixou de aceitar apps de terceiros que entram só com usuário e senha e passou a exigir o protocolo OAuth. Por isso o envio pelo Gmail passa pela tela Configurações OAuth do Sankhya Om.

Passo a passo

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

Liste as rotinas, relatórios e avisos do Sankhya Om que saem por e-mail e qual conta do Google envia cada um.

Passo 2. Crie o aplicativo no Google Cloud

No Google Cloud, crie um cliente OAuth do tipo “Aplicativo da Web”, cadastre em “URIs de redirecionamento autorizados” o endereço do seu Sankhya seguido de /mge/genericOAuth.mge e copie o Client ID e o Client Secret. Os passos detalhados estão no artigo da Sankhya “Obtenção das credenciais do aplicativo Google para o protocolo OAuth” e na documentação do Google.

Passo 3. Crie a configuração OAuth no Sankhya Om

Na tela Configurações OAuth, crie um registro com o provedor Gmail e informe o nome da API, o Client ID e o Client Secret.

Passo 4. Preencha os endereços e o Redirect URI

Preencha os campos do Gmail conforme a ajuda oficial da Sankhya: URL da API do Google, URL para obter o Access Token, URL da API do Google People, Redirect URI /mge/genericOAuth.mge e Scopes. Salve.

Passo 5. Vincule a conta na tela Servidor SMTP

Na conta de e-mail cadastrada em Servidor SMTP, marque “Autenticar com OAuth”, selecione a configuração criada e faça a autenticação na tela do Google.

Passo 6. Teste o envio

Envie um e-mail de teste para confirmar que a configuração funcionou e repita o vínculo nas outras contas que enviam pelo Gmail.

Os nomes de tela e de campo seguem a ajuda oficial da Sankhya (Configurações > Avançado > Envio de Mensagens; Configurações OAuth; Servidor SMTP; “Autenticar com OAuth”). Podem variar conforme a versão do Sankhya Om. Os valores exatos de cada campo estão no artigo “Configurações OAuth” da ajuda da Sankhya.

O que é configuração do Sankhya e o que é integração

Situação

Onde se resolve

E-mail do Sankhya não sai pelo Gmail

Configuração do Sankhya Om e do Google, como neste guia

Pedido ou título precisa de aprovação de alguém que não usa o Sankhya

Integração: aviso no Gmail, conforme o desenho do projeto

Falha de integração precisa chegar ao time certo

Integração: alerta por e-mail, com registro de cada movimentação

Relatório recorrente em planilha

Integração: envio agendado para Google Planilhas ou Google Drive

Fluxos comuns com o harpix integration hub

Fluxo

Origem → destino

Quando

Aprovação de pedido de compra

Sankhya → Gmail

Quando o pedido entra em aprovação

Aviso de título a vencer para o financeiro

Sankhya → Gmail

Agendado

Alerta de falha de integração

harpix integration hub → Gmail

Quando ocorrer

Posição de vendas por vendedor

Sankhya → Google Planilhas

Agendado

Quando alguma informação do Sankhya ainda não está disponível por API, a harpix também integra por arquivo, via SFTP, FTP, CSV e TXT.

Onde entra cada produto harpix

  • harpix integration hub: conecta o Sankhya ao Google Workspace e aos demais sistemas da empresa, com monitoramento e registro de cada movimentação. Página do produto: harpix.com.br/integration-hub

  • harpix data hub: dashboards, BI e IA sobre os dados do Sankhya já integrados. Página do produto: harpix.com.br/produtos/data-hub

  • harpix consulting: quando há várias empresas e filiais no Sankhya e as alçadas pedem desenho antes da integração.

Leia também

Quer que pedidos, títulos e alertas do Sankhya cheguem a quem decide, no Gmail? Fale com um especialista · Conheça o harpix integration hub

Perguntas frequentes

Por que o e-mail do Sankhya parou de sair pelo Gmail?

Porque o Google deixou de aceitar apps de terceiros que entram só com usuário e senha e passou a exigir OAuth. A ajuda da Sankhya indica criar uma configuração OAuth com o provedor Gmail e vinculá-la à conta em Servidor SMTP.

Onde fica a tela Configurações OAuth no Sankhya Om?

A ajuda da Sankhya coloca a tela no módulo Configurações > Avançado > Envio de Mensagens. Ali se escolhe o provedor, Gmail ou Outlook, e se informam as credenciais do aplicativo.

Que dados do Google o Sankhya pede?

O nome da API como foi cadastrado no Google Cloud, o Client ID e o Client Secret do aplicativo, além dos endereços, do Redirect URI /mge/genericOAuth.mge e dos Scopes indicados na ajuda da Sankhya.

Como ligo a configuração OAuth à conta de e-mail?

Na tela Servidor SMTP, localize a conta, marque “Autenticar com OAuth”, selecione a configuração criada e faça a autenticação na tela do Google. Um e-mail de teste confirma o processo.

Quem faz essa configuração na empresa?

Quem administra o Google Workspace ou a conta do Google, que cria o aplicativo no Google Cloud, e quem administra o Sankhya Om, que cria a configuração OAuth e vincula a conta remetente.

Dá para aprovar pelo Gmail a partir do Sankhya?

Pode ser desenhado como um fluxo de integração: o harpix integration hub conecta o Sankhya ao Gmail, com monitoramento e registro de cada movimentação. O desenho e o escopo são definidos no diagnóstico.

A harpix configura o e-mail do Sankhya?

A configuração de e-mail é feita no próprio Sankhya Om e no Google, como neste guia. A harpix entra quando o e-mail faz parte de um fluxo entre sistemas, como aprovações, alertas e relatórios.

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