configurações omnichannel
OBJETIVO: CADASTROS BÁSICOS conta e-mail entrada
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
Configuração Gmail IMAP
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)
Ativando o IMAP na conta de Gmail
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
Configurando uma senha de aplicativo
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
Configuração aplicativo azure
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
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
Na opção de Permisões de APIs, você precisará adicionar a permissão Mail.ReadWrite (Delegado) para dar acesso ao motor, permitindo ler e editaras as mensagens de email, podendo marca-las como lidos
Obs: é necessário pedir autorização do administrador para conceder esta permissão
ATENÇÃO. ANTES DE SEGUIR A PARTIR DESTE PONTO, LEIA A DOCUMENTAÇÃO SOBRE COMO GERAR O 'CODE' OU REFRESH_TOKEN DE UMA MANEIRA MAIS SIMPLES
A partir desse ponto é configuração realizada pela isoCRM.
Com essas configurações feitas, será necessário acessar essa URL com os parâmetros do seu aplicativo:
Obs: Entre nessa URL com a ferramenta de desenvolvedor aberta (F12) pois nessa tela, será disponibilizado um codigo necessário no proximo passo.
https://login.microsoftonline.com/organizations/oauth2/v2.0/authorize?
client_id=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx (Aqui entra o client_id que está na opção Visão Geral do aplicativo Azure)
&response_type=code
&redirect_uri=https%3A%2F%2Flogin.microsoftonline.com%2Fcommon%2Foauth2%2Fnativeclient
&response_mode=form_post
&scope=offline_access%20&scope=offline_access%20https%3A//graph.microsoft.com/.default
&state=12345
A url ficaria assim:
https://login.microsoftonline.com/organizations/oauth2/v2.0/authorize?client_id=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx&response_type=code&redirect_uri=https%3A%2F%2Flogin.microsoftonline.com%2Fcommon%2Foauth2%2Fnativeclient&response_mode=form_post&scope=offline_access%20https%3A//graph.microsoft.com/.default&state=12345
Caso não esteja logado com a conta de email, será solicitado a conta que será vinculada ao aplicativo
Entre com o e-mail e senha e clique em avançar.
Aqui temos a Microsoft pedindo permissão para associar a conta com o aplicativo.
Perceba que a ferramenta de desenvolvedor esta aberta na lateral direita.
Clicando em Aceitar, a tela será recarregada e então será entregue o Code que será usado no proximo passo.
Com todos estes dados, iremos até o Postman para conseguir os tokens de acesso, que serão cadastrados posteriormente nos Parâmetros do isoCRM
No Postman adicione esta URL onde o {tenant} é o ID do diretório (locatário) que você encontra na opção Visão geral do aplicativo Azure.
https://login.microsoftonline.com/{tenant}/oauth2/v2.0/token
Coloque os seguintes parâmetros no Postman
--header "Content-Type: application/x-www-form-urlencoded" ^
--data-urlencode "scope=https://graph.microsoft.com/.default
--data-urlencode "code=0.xxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxxxx" ^ ( Esse é o code que encontramos no passo anterior)
--data-urlencode "client_id=xxxxx-xxxxx-xxxxx-xxxxx-xxxxxxx" ^ (ID do cliente que você encontra na opção Visão geral do aplicativo Azure.)
--data-urlencode "grant_type=authorization_code" ^
--data-urlencode "redirect_uri=https://login.microsoftonline.com/common/oauth2/nativeclient"
Configuração de parâmetros
O nome parâmetro obrigatoriamente deve ser o mesmo nome da conta de e-mail, e deve-se cadastrar os detalhes para todos os usuários ou grupos que tem acesso a conta
Os detalhes devem ser os seguintes:
Pergunta: CLIENT_ID
Resposta: CLIENT_ID
Observação: - O conjunto de caracteres da Microsoft
Pergunta: REFRESH_TOKEN
Resposta: REFRESH_TOKEN
Observação: - O conjunto de caracteres da Microsoft
Pergunta: TENANT_ID
Resposta: TENANT_ID
Observação: - O conjunto de caracteres do locatário
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.
Para rodar o motor de e-mail:
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