Na tela de configuração do Omnichannel
Vá no menu Supervisor > E-mail de entrada > Setup e-mail.
Nesta tela, temos todas as contas de e-mail de entrada cadastradas. Contas que são usadas para receber e-mails externos para dentro do isoCRM.
Clicando em Adicionar conta, será aberto um formularios para entrar com as informações da conta.
Nesse formulário será necessário entrar com as seguintes informações:
Descrição da conta
Tipo de conta, se é IMAP, SMTP ou Formulário
IMAP: Para recebimento de e-mails
SMPT: Para envio de e-mails
Server: É alterado conforme o provedor de email
Porta: 99
Conta: É a conta de e-mail que será utilizada para receber ou enviar os e-mails pelo isoCRM
Senha: A senha do e-mail cadastrado
SSL : Protocolo de segurança
Canal Comunicação: Categoria da conta de e-mail
Diretório dos anexos: É a pasta onde ficaram salvos os anexos recebidos pelo e-mail.
Nome do Remetente
Endereço do remetente
Efetuando o cadastro da conta de e-mail, será necessário entrar com os usuários ou grupos que atenderam aquela conta
Para configurar o Gmail é necessário ativar o POP e o IMAP. (Ativar ou desativar o POP e o IMAP)
E configurar uma senha de aplicativo (Fazer login com senhas de aplicativo)
Na tela inicial do gmail, vá no ícone de configurações e em "Mostrar todas as configurações"
Em configurações vá na categoria "Encaminhamento e POP/IMAP"
Em seguida ative o Acesso IMAP em Ativar IMAP
Para configurar uma senha de aplicativo:
Clique no ícone de sua conta google
Vá em Gerenciar sua Conta do Google
No menu lateral entre na categoria Segurança
Desça a tela até chegar em Como você faz login no Google
Na linha de Verificação em duas etapas clique na seta
Irá solicitar para confirmar a sua identidade, confirme com sua senha.
Abrirá a pagina de Verificação em duas etapas
Vá em Senhas de app e clique na seta
Abrirá a pagina de Para adicionar uma nova senha de app
Adicione um nome para o aplicativo de sua preferência ex: Motor de email
Clique em Criar
Em seguida copie a senha gerada e cole nas Conta de Atendimento dentro do IsoCRM
Após a configuração da conta, e antes do cadastro dos parâmetros, é necessário a configuração do aplicativo no site da Azure, e o registro do aplicativo no ambiente Microsoft
Registrar o aplicativo
No portal do Azure, vá em Azure Active Directory → Registros de aplicativos → Novo registro.
Defina o nome do app (ex.: isoCRM Outlook Integration).
Configure o tipo de conta (normalmente “Contas nesta organização”).
Configurar autenticação (OAuth 2.0 / OpenID Connect)
Em Autenticação, adicione o Redirect URI (ex.: https://sandbox.isocrm.com.br/signin-oidc).
Esse URI é para onde o usuário será redirecionado após login.
Adicionar permissões delegadas
Vá em Permissões de API → Adicionar permissão → Microsoft Graph.
Escolha Delegadas e selecione User.Read, Mail.Read, Mail.Send, offline_access e Mail.ReadWrite .
Salve.
Conceder consentimento da administrador para a organização
Necessário estar logado com um usuário administrador da conta.
Vá em Permissões de API.
Clique na opção Conceder consentimento do administrador para [Nome da organização].
Gerar credenciais (segredo ou certificado)
Em Certificados e segredos, crie um segredo.
O app usará esse segredo para trocar o código de autorização por um token.
Copie para uma área de transferência o valor, pois será necessário para configuração no isoCRM.
Primeiramente, no portal Azure é necessário Clique na opção Registros de aplicativo
Então adicione um novo Aplicativo, e clique em Registrar
Efetuando o registro do aplicativo, você terá acesso á Visão Geral do seu aplicativo, onde mostrará algumas informações necessárias
Na opção de Proprietários, você poderá adicionar as pessoas quem terão acesso a configuração deste aplicativo
Na opção de Autenticação, você fará as Configurações de plataforma que será feito no aplicativo.
Selecione a opção Aplicativos móveis e de área de trabalho
Adicionar permissões delegadas
Vá em Permissões de API → Adicionar permissão → Microsoft Graph.
Escolha Delegadas e selecione User.Read e Mail.Read Mail.Send offline_access Mail.ReadWrite
Salve
Obs: é necessário pedir autorização do administrador para conceder esta permissão
Após a configuração da conta de e-mail é necessário definir os parâmetros de configuração de acesso às contas do Outlook.
Defina um nome para o parâmetro:
Parâmetro: Ex.: APLICATVO_OUTLOOK
Os detalhes devem ser os seguintes:
Pergunta: CLIENT_ID
Resposta: ID do aplicativo (cliente)
Pergunta: TENANT_ID
Resposta: ID do diretório (locatário)
Pergunta: SECRET_ID
Resposta: Valor do ID secreto
Pergunta: REDIRECT_URI
Resposta: https://[base URL do cliente]/isocrmws/aisowebhookms
Pergunta: SCOPES
Resposta: User.Read Mail.Read Mail.Send offline_access Mail.ReadWrite
É necessário definir qual parâmetro de configuração de acesso ao registro de aplicativo será utilizado.
Em configurações do Omnichannel no Setup email, selecione a conta de e-mail de entrada e vá para a aba de Parâmetros.
Defina o nome para o parâmetro com o mesmo nome da conta de atendimento:
Parâmetro: CONTA ATENDIMENTO
Grupo/Usuário: Definir um grupo que tenha um usuário com acesso às configurações do omnichannel. Será necessário para gerar os tokens de acesso.
O detalhe deve ser os seguintes:
Pergunta: CONFIG_OUTLOOK
Resposta: O nome do parâmetro com as configurações de acesso ao registro de aplicativo. Ex.: APLICATIVO_OUTLOOK
Com isso a conta de atendimento de e-mail de entrada irá utilizar as configurações de acesso ao registro de aplicativo configurado no parâmetro geral.
Com as contas configuradas, é necessário liberar acesso da conta Microsoft e gerar as credenciais de acesso ao registro do aplicativo.
Conta de atendimento com e-mail de entrada de um usuário do isoCRM.
Com o usuário logado, sendo que em seu cadastro de E-Contacts tenha o mesmo e-mail da conta de atendimento de e-mail de entrada configurado.
Abrir a tela de minhas configurações de usuário.
Clique na opção Integração Outlook (seuemail@emailoutlook.com.br).
Será redirecionado para a tela de login da Microsoft.
Efetuar o login, desta forma serão geradas as credenciais de acesso para a conta do usuário para o registro do aplicativo.
Caso efetue o login com uma conta Microsoft diferente da requisitada pelo isoCRM, será retornado um erro.
Conta de atendimento com e-mail do cadastro da empresa.
Com o usuário supervisor.
Abrir a tela de configurações do Omnichannel.
Selecionar a conta de atendimento para configuração.
No cadastro da conta de atendimento, clique na opção Integração Outlook (atendimento@emailoutlook.com.br).
Será redirecionado para a tela de login da Microsoft.
Efetuar o login com mesma conta de e-mail do cadastro da conta de atendimento, desta forma serão geradas as credenciais de acesso para essa conta ao registro do aplicativo.
Caso efetue o login com uma conta Microsoft diferente da requisitada pelo isoCRM, será retornado um erro.
Após gerar as credenciais elas serão registradas nos parâmetros da conta de atendimento, criando 3 novos detalhes:
ACCESS_TOKEN;
REFRESH_TOKEN;
DATE_EXPIRE;
Os valores desses parâmetros serão atualizados pelo motor de e-mail de entrada.
Após tudo isso configurado, é necessário rodar o motor de e-mail de entrada, para começar a receber e enviar e-mails dentro do isoCMR.
Execute o arquivo do motor.
Ao abrir pela primeira vez irá criar um arquivo iso_config.json com dados padrões.
Em seguida adicione os dados corretos ao arquivo config, sendo eles:
Url: Link para fazer as requisições de autenticação e de contas cadastradas. (Obrigatório)
Username: Nome da conta do usuário do ISOCRM que será usada como motor. (Obrigatório)
User Password: Senha do usuário do ISOCRM que será usada como motor. (Obrigatório)
Emp Code: Código da empresa. (Obrigatório)
Time: Tempo de processamento após cada recebimento de email.
Time Limit: Horário para o motor parar.
Data Inicial: Data para pegar os emails a partir dela.
Qtd Req: Quantidade de emails a serem requisitados por vez.
Aqui está um exemplo de configuração:
{
"url": "https://localhost/isocrmws/rest/",
"username": "isopadrao",
"user_password": "123",
"emp_code": "1",
"time": "10",
"time_limit": "23:59",
"data_inicial": "01/01/2020",
"qtd_req": "25"
}
Com isso o motor começará a rodar na aplicação baixando todos os e-mail recebidos pela conta que foi cadastrada.
Obs: A verificação de IMAP com azure é feita a partir do Client_id, se tiver este parâmetro ele identifica que vem do azure, se não tiver ele executa diretamente pelo email e senha.
Documentação original da Microsoft.
Documentação auxiliar
https://sites.google.com/isoenterprise.com/isocrmtreinamentos/release-notes/v-10-0-0-abr2023#h.rryxujl8vhi4
Problemas que podem ocorrer na conta da Microsoft
5.7.139 authentication unsuccessful smtpclientauthentication is disabled for the Tenant
Solução: Enable or disable SMTP AUTH in Exchange Online | Microsoft Learn