Microsoft – Citrus.cx https://hml-docs.citrus.cx Base de Conhecimento Mon, 03 Nov 2025 14:00:20 +0000 pt-BR hourly 1 https://wordpress.org/?v=6.9.4 https://hml-docs.citrus.cx/wp-content/uploads/2023/08/cropped-doc-citrus_LOGO-FAVICON-1-32x32.png Microsoft – Citrus.cx https://hml-docs.citrus.cx 32 32 Versão 2.109.31.1 https://hml-docs.citrus.cx/docs/releases-notes/release-notes/versoes-2-109-1-a-2-109-0/versao-2-109-31-1/ https://hml-docs.citrus.cx/docs/releases-notes/release-notes/versoes-2-109-1-a-2-109-0/versao-2-109-31-1/#respond Fri, 09 May 2025 14:21:00 +0000 https://docs.citrus.cx/docs/releases-notes/release-notes/versoes-2-109-1-a-2-109-0/versao-2-109-31-1/
CORREÇÃO

Login: Ajuste evitará que sessão de Atendente com Microsoft seja encerrada automaticamente

O processo de login com Provedor de Identidade Microsoft foi ajustado para garantir que sessões de Atendentes na plataforma Citrus sejam corretamente criadas e armazenadas nos cookies do navegador. 

O tratamento garantirá o funcionamento contínuo do sistema após login, evitando que sessões expirem e Atendentes sejam desconectados da plataforma automaticamente. 

Acesse o Guia de Integração com Provedor de Identidade

]]> https://hml-docs.citrus.cx/docs/releases-notes/release-notes/versoes-2-109-1-a-2-109-0/versao-2-109-31-1/feed/ 0 Login com conta corporativa Microsoft https://hml-docs.citrus.cx/docs/guia-do-administrador/gestao-de-usuarios/integracao-com-provedor-de-identidade/login-com-conta-corporativa-microsoft/ https://hml-docs.citrus.cx/docs/guia-do-administrador/gestao-de-usuarios/integracao-com-provedor-de-identidade/login-com-conta-corporativa-microsoft/#respond Tue, 29 Apr 2025 02:58:00 +0000 https://docs.citrus.cx/docs/guia-do-administrador/gestao-de-usuarios/integracao-com-provedor-de-identidade/login-com-conta-corporativa-microsoft/

A autenticação na plataforma Citrus com credenciais de conta corporativa da Microsoft respeita algumas regras. 

Quando critérios de pré-requisitos não são cumpridos, alertas são mostrados na tela para notificar o usuário sobre o motivo de falha na tentativa de login. 

A seguir são apresentadas demonstrações sobre o funcionamento do login com conta da Microsoft: 

Tela de login Citrus com a opção Entrar com Microsoft

A opção Entrar com Microsoft só é exibida na tela de login quando existe cadastro ativo do Provedor de Identidade no Citrus. 

Consulte Integração com Provedor de Identidade

No momento que um usuário clicar no botão Entrar com Microsoft, o painel de login on–line da Microsoft será carregado na tela, e permitirá selecionar ou inserir o endereço de e-mail. 

Antes do acesso ao Citrus ser permitido, ou não, será realizada verificação para confirmar se o e-mail informado existe no Banco de Dados do Citrus. 

Caso este pré-requisito seja atendido, o login será concluído com sucesso. 

Se algum critério não for respeitado, alertas serão carregados na tela. Confira: 

1. Fechar tela de login on-line da Microsoft

Quando o usuário clicar em Entrar com Microsoft e fechar a tela de login on-line da Microsoft, verá a notificação de falha no login e será orientado a tentar novamente. 

2. Conta de e-mail não encontrada

Se a conta não for encontrada, o alerta de “e-mail não cadastrado no sistema” será carregado na tela. 

Recuperação de senha com conta Microsoft

Quando um usuário de ambiente que utiliza Microsoft como Provedor de Identidade não lembrar suas credenciais de acesso poderá clicar em “Esqueceu sua senha?” na tela de login. 

Ao fazer isso, uma mensagem na tela informará que precisa entrar em contato com o Administrador da conta Microsoft na sua organização.

Confira também Autenticação de e-mail Microsoft Office 365

]]> https://hml-docs.citrus.cx/docs/guia-do-administrador/gestao-de-usuarios/integracao-com-provedor-de-identidade/login-com-conta-corporativa-microsoft/feed/ 0 Integração com Provedor de Identidade https://hml-docs.citrus.cx/docs/guia-do-administrador/gestao-de-usuarios/integracao-com-provedor-de-identidade/ https://hml-docs.citrus.cx/docs/guia-do-administrador/gestao-de-usuarios/integracao-com-provedor-de-identidade/#respond Tue, 29 Apr 2025 01:28:00 +0000 https://docs.citrus.cx/docs/guia-do-administrador/gestao-de-usuarios/integracao-com-provedor-de-identidade/

Visão Geral

A integração com Provedores de Identidade (inicialmente Microsoft), pode ser configurada por Administrador para que usuários acessem a plataforma Citrus com as mesmas credenciais de conta corporativa do provedor. 

Pré-requisitos e Permissões

Para configurar e utilizar a integração é necessário:  

 

Configuração 

  • Ter perfil de Administrador na plataforma Citrus. 
  • Ter uma conta no Provedor de Identidade que será integrado. 

 

Utilização 

  • Possuir Integração com Provedor de Identidade ativa na plataforma Citrus. 

Integração com Provedor de Identidade Microsoft

  1. Na plataforma Citrus acesse os menus Administração > Usuários > Provedor de Identidade.
  2. Em “Tipos de Provedores” selecione o que será usado na integração.

    *Neste momento, a integração está disponível para Microsoft Entra ID (Azure), que já aparecerá selecionado no campo.

  3. Marque a caixa de seleção de “Ativo” para habilitar a integração.

    * É possível configurar a integração e só habilitá-la posteriormente. Basta deixar a opção desmarcada.

  4. Preencha os demais campos do cadastro, como a seguir:

    • Client Id: É o identificador único e público de um aplicativo registrado no Azure Active Directory.

    O valor do ID do aplicativo é exibido após o registro no Azure. Serve para o Citrus saber qual aplicação registrada no Azure está tentando autenticar os usuários.

    Exemplo:: 311b2d83-a22e-4040-8953-133a79f7619c


    • Client Secret: Senha secreta gerada para o aplicativo no Azure. Usada junto com o Client ID para autenticação segura.

    Exemplo: 30L8Q~DBED1FLPMu.xJU2W9kQUFJB9rwANcYZcYH


    • Tenant Id: Identifica o ID do Locatário ou diretório do Azure AD (empresa/organização).

    No Citrus, para Microsoft, por padrão o campo é autopreenchido com o valor fixo "organizations" porque apenas conta organizacional (e-mail empresarial) é permitida.


    • Callback URL: Endereço para o qual a Microsoft irá redirecionar o usuário após ele realizar o login com sucesso, durante o processo de autenticação.

    Exemplo: https://app.sistemax.com/auth/callback


    Após o login, a Microsoft redirecionará o usuário autenticado de volta para esse endereço. Esse endpoint é onde o Citrus:

    - Receberá o código de autorização.

    - Trocará o código por um token de acesso.

    - Validará o login e autenticará o usuário na plataforma.


    Outros exemplos comuns:

    https://plataforma.empresa.com.br/login/oauth2/callback

    https://meusistema.com/callback

    https://portal.organizacao.net/oauth2/redirect


    IMPORTANTE

    IMPORTANTE

    O Callback URL precisa ser exatamente o mesmo que foi cadastrado na configuração do aplicativo no portal da Microsoft Azure, ou a autenticação falhará com erro de segurança.

  5. Pressione Salvar no topo direito da tela para concluir a configuração da integração. Ou, Cancelar, caso desista de registrar.

A Integração com Provedor de Identidade respeita as seguintes regras de funcionamento: 

Quando a integração estiver habilitada 

  • Todos os campos de preenchimento se tornam obrigatórios. 
  • O sistema bloqueia o salvamento caso algum campo esteja vazio. 

Quando a integração estiver desabilitada 

  • Os campos podem ficar vazios. 
  • Não será exigido nenhum preenchimento. 

Registrar aplicativo e obter dados no Azure

  1. Acessar o portal Azure .
  2. Registrar aplicativo: No menu da lateral esquerda clique em Azure Active Directory > Registros de aplicativos e pressione Novo registro.

    Preencha os campos:

    • Nome: Escolha um nome para identificar a integração (ex.: Login Citrus)

    •Tipos de conta compatíveis: Selecione "Contas em qualquer diretório organizacional (qualquer diretório do Azure AD) e contas pessoais da Microsoft".

    • URI de Redirecionamento: (opcional nessa etapa, pode ser ajustado depois).

  3. Obter Client ID para a integração no Citrus:

    - Acesse o portal Azure com suas credenciais corporativas.

    - No menu lateral, clique em Azure Active Directory, depois em App registrations.

    - Selecione o aplicativo desejado na lista de App registrations.

    - Na aba Overview, localize o campo "Application (client) ID". Este é o valor do seu Client ID.

  4. Gerar o Client Secret:

    - No aplicativo registrado acesse Certificados e segredos e em Segredos do cliente clique em “+ Novo segredo de cliente”.

    - Digite uma descrição (Ex: “Login Citrus”) e defina um período de expiração (6, 12 ou 24 meses).

    - Pressione Adicionar.

    - Copie imediatamente o valor do segredo gerado (o campo “Valor”, não o Secret ID). Este é o Client Secret a ser inserido no Citrus.


Confira também Autenticação de e-mail Microsoft Office 365

Informações reunidas nesta documentação

]]> https://hml-docs.citrus.cx/docs/guia-do-administrador/gestao-de-usuarios/integracao-com-provedor-de-identidade/feed/ 0 Versão 2.98.0 https://hml-docs.citrus.cx/docs/releases-notes/release-notes/versao-2-98-0/ https://hml-docs.citrus.cx/docs/releases-notes/release-notes/versao-2-98-0/#respond Mon, 27 May 2024 19:12:00 +0000 https://docs.citrus.cx/docs/releases-notes/release-notes/versao-2-95-0/
NOVIDADES

Atendimentos: Anexar múltiplos arquivos simultaneamente

A partir de agora é possível selecionar e anexar múltiplos arquivos para enviá-los ao cliente na Tela do Atendente e nos Atendimentos. Esta melhoria na interface auxilia no tempo médio de atendimento (TMA) dos Atendentes, diminuindo o número de cliques na tela. 

Na Tela do Atendente, quando o Atendente logar na plataforma, clicar no ícone Canais de Atendimento e logar em WhatsApp e/ou Webchat, durante uma conversa em tempo real com o cliente: 

  • Na sessão do chat, clique no ícone Anexos para selecionar e adicionar mais de um arquivo simultaneamente ao clicar no botão +Adicionar arquivos selecionados. 
  • Ao lado da sessão do chat, selecione vários arquivos de uma só vez ao clicar no ícone Anexo do atendimento abaixo do Protocolo, e em seguida no botão Arquivo. 
  • Na parte superior da tela, clique no botão Enviar informação para o cliente, em seguida da abertura do pop-up abaixo do campo “Comentário” clique no botão Anexo para selecionar e anexar mais de um arquivo simultaneamente, sendo possível também visualizá-los através do ícone Olho, ao lado de cada arquivo, antes de clicar no botão Enviar para o cliente. 

Na tela Atendimentos (LemonDesk > Atendimentos > (selecionar um Protocolo da listagem) > Atendimentos): 

  • Ao clicar no ícone Anexos e em seguida no botão Selecione o arquivo, selecione e adicione mais de um arquivo simultaneamente ao clicar no botão +Adicionar arquivos selecionados. 

Atendimentos: Implementada a exibição "Remetente" e "Destinatário" dos emails

O Remetente é o endereço de email utilizado para notificações dos Atendimentos, configurado pelo Administrador na tela Configurações de comunicação (Administração > Configurações Gerais > Configurações de comunicação > (aba) Servidor de email).  

A plataforma passa a exibir agora o endereço de email do Remetente nos comentários adicionados pelo Atendente via opção “Email” selecionado no campo Mídia. 

Foi ajustado também o nome do campo “Email” para “Destinatário” no arquivo PDF do “Relatório de atendimento” gerado pela plataforma. 

O Atendente/Supervisor seleciona um Atendimento na listagem da tela Atendimentos (LemonDesk > Atendimentos), clica no botão | V | da coluna Ações no lado direito da tela, e na opção Exportar históricos de atendimentos. Após isso na abertura do pop-up preenche o campo obrigatório “Abertura de atendimento”, e clica no botão Dados públicos para o cliente. 

* Este mesmo botão | V | com a opção Exportar históricos de atendimentos é encontrado durante a edição de um Atendimento, no canto superior direito da tela Atendimentos (LemonDesk > Atendimentos > (selecionar na listagem para editar) > Atendimentos). 

Com este novo recurso fica registrado nos comentários por qual endereço de email foi enviada a notificação do Atendimento, e promove o bom entendimento do “Relatório de atendimento” que exibe o endereço de email do cliente (Destinatário), podendo ser o mesmo endereço de email que já consta em seu cadastro ou um diferente utilizado no momento de envio do comentário em Atendimentos. 

Atendimentos: Novo filtro "Identificar palavras e expressões indicativas de possíveis fraudes"

A plataforma passa a ter um novo filtro na tela Atendimentos (LemonDesk > Atendimentos > botão Filtro). 

Se o Atendente/Supervisor selecionar no bloco Identificar palavras e expressões indicativas de possíveis fraudes a opção “Palavras expressões”, e clicar no botão Pesquisar, é realizada a busca na “Descrição” dos Atendimentos pelas palavras cadastradas na tela Palavras e expressões (Administração > Atendimentos > Palavras e expressões indicativas de fraudes > Palavras e expressões > botão +Novo). 

É possível gerenciar esse cadastro com as seguintes Permissões habilitadas no Perfil do usuário: 

– Listar palavras expressões 

– Criar palavras expressões 

– Editar palavras expressões 

– Excluir palavras expressões 

Com esta nova funcionalidade, os Atendimentos que possuam as palavras cadastradas são exibidos no resultado da pesquisa auxiliando no monitoramento da segurança dos dados. 

Agendamentos: Novo campo "Modificar Endereço de Resposta" em Campanhas "Envio de email"

Foi implementado na tela Agendamentos (Administração > Atendimentos > Agendamentos > botão +Novo) para Campanhas do Tipo “Envio de email”, o campo opcional “Modificar Endereço de Resposta”. 

A partir de agora o usuário com as permissões habilitadas para Agendamentos (Administração > Usuários > Perfil > selecionar na listagem o “Nome” > ícone Permissões) consegue preencher neste novo campo outro endereço de email: 

– Listar agendamento 

– Criar agendamento 

– Editar agendamento 

– Excluir agendamento 

Se o campo não for preenchido permanece o cenário de resposta padrão. Caso o campo seja preenchido é adicionado à regra da plataforma o header reply-to (um elemento do cabeçalho de email que contém o endereço de email para onde a resposta da mensagem será enviada). 

Assim, quando o cliente responder à mensagem de notificação da Campanha, não é gerado um loop de emails (uma reação em cadeia indesejada que pode ocorrer durante a comunicação por email), pois o endereço de resposta é modificado. 

Atendimentos: Volume da notificação dos cards

A partir de agora a plataforma passa a ter o novo recurso para o ajuste de volume da notificação dos cards que chegam na tela do Atendente. 

O Atendente/Supervisor ao logar na plataforma pode realizar esta alteração com a barra de volume “Novo Atendimento – Volume da Notificação (100%)” na tela Modificar dados (ícone do usuário no canto superior direito da tela do Atendente > Meus dados > Modificar dados). Após o ajuste, clique no botão Salvar, é exibido o popup Validação de segurança para digitar a senha do usuário, e clique no botão Salvar. 

Dessa forma o Atendente/Supervisor pode decidir a porcentagem para o volume de notificação dos cards com melhor usabilidade e sem prejudicar as interações com os clientes. 

Configurações Gerais: Alteração do nome do campo "Teste de envio de mensagem whatsapp" para "Envio de mensagem whatsapp"

A partir desta versão foi alterado o nome do campo na tela WhatsApp – HSM (Administração > Configurações Gerais > WhatsApp – HSM > selecione na listagem o “Nome” com “Status” Aprovado). 

O campo “Teste de envio de mensagem whatsapp” passa a se chamar “Envio de mensagem whatsapp”, para melhor usabilidade. 

CORREÇÃO

Atendimentos: Erro ao enviar anexos pelo chat no registro de Atendimentos

Foi identificado erro durante os registros de atendimentos via chat quando o Atendente estava com mais de um card em atendimento. 

Ao enviar 01 (um) ou mais anexos via chat na tela do Atendente, estes anexos chegavam somente para o cliente do primeiro card aceito. E sendo necessário enviar múltiplos arquivos em anexo os botões: Visualizar, Adicionar e Cancelar não funcionavam. 

Após o ajuste realizado, os botões desta funcionalidade passam a funcionar corretamente, e os anexos são enviados para os referentes clientes quando o Atendente está com 01 (um) ou mais cards em atendimento. 

]]> https://hml-docs.citrus.cx/docs/releases-notes/release-notes/versao-2-98-0/feed/ 0 Versão 2.94.0 https://hml-docs.citrus.cx/docs/releases-notes/release-notes/versao-2-94-0/ https://hml-docs.citrus.cx/docs/releases-notes/release-notes/versao-2-94-0/#respond Wed, 17 Apr 2024 20:36:00 +0000 https://docs.citrus.cx/docs/releases-notes/release-notes/versao-2-94-0/
NOVIDADES

Agendamentos: Melhoria nos disparos de email

Em servidores de email Office365 configurados na plataforma, existe pela Microsoft um limite de disparo de 30 emails por minuto.  

Agendamentos de Campanhas do Tipo “Envio de email” configurados com grande número de lista de contatos para disparo, após execução da Campanha ao clicar no ícone Log de execução da tela Agendamentos era exibido na coluna Falha o status “SIM” e na coluna Detalhes a mensagem: “Sending the email to the following server failed : smtp.gmail.com:587“. 

Para melhoria na eficácia dos disparos de email foi implementado um cadenciador com o delay de 2,5 segundos no envio de emails pela plataforma. 

Dessa forma evita-se o cenário de falha das Campanhas do Tipo “Envio de email” por exceder o limite de envios durante a execução. 

Agendamentos: Mensagem de alerta sobre Agendamento em execução

Após configurar um Agendamento de Campanha do Tipo: “Campanha de SMS”, “Campanha de WhatsApp”, “Envio de email” e “Envio de pesquisa satisfação”, o usuário com esta permissão pode selecionar para editar este Agendamento durante o horário programado do disparo. 

Ao editar o Agendamento e clicar no botão Salvar a plataforma duplicava automaticamente a execução deste Agendamento. 

Para evitar este cenário foi implementado um pop-up com a seguinte mensagem de alerta: 

 “AGENDAMENTO EM EXECUÇÃO! Por favor, aguarde até que a execução atual seja concluída. Se você prosseguir, outra programação paralela será iniciada. Você deseja continuar?“ 

Quando o usuário editar o campo “Início do período de envio” e clicar no botão Salvar, a plataforma vai verificar se existe algum agendamento em execução para o mesmo horário. Se existir, a mensagem de alerta é exibida na tela. 

Dessa forma o usuário pode escolher na mensagem de alerta a ação da plataforma com cs botões: Continuar ou Cancelar, para criação ou não de uma execução paralela do Agendamento corrente. 

Ao clicar no botão Continuar, a plataforma cria uma execução paralela desse Agendamento em execução. Caso clique no botão Cancelar, o pop-up é fechado e o usuário permanece na tela Agendamentos para edição. 

Agendamentos: Melhoria nas mensagens de erro exibidas pela plataforma

Foram implementadas melhorias para o bom entendimento dos usuários sobre as mensagens de erro exibidas pela plataforma durante a execução de Agendamentos do Tipo: “Campanha de SMS”, “Campanha de WhatsApp”, “Envio de email” e “Envio de pesquisa satisfação”.  

Na tela Agendamentos (Administração > Atendimentos > Agendamentos > (selecionar na listagem) > Agendamentos) ao clicar no ícone Log de execução é exibida a listagem de possíveis mensagens de erro na coluna Detalhes. 

As seguintes mensagens de erro receberam ajustes sendo agora mais amigáveis ao usuário: 

–  “Ocorreu uma falha na tentativa de conexão com o servidor de e-mail e não foi possível processar o envio do e-mail.“ 

* Refere-se a conexão com o servidor de email. 

–  “Os dados retornados pela API estão em um formato incompatível com a plataforma.” 

* Refere-se a estrutura Json incorreta. 

–  “A API executada está fora do ar no momento.” 

* Refere-se a API que está indisponível. 

–  “Ocorreu um erro ao importar o arquivo .csv que foi selecionado. Certifique-se que foi utilizado o arquivo com o layout correto com base no botão “Download do layout” na tela de “Agendamentos”. “ 

* Refere-se ao template incorreto do Arquivo CSV ou a vários registros de contatos no Arquivo CSV sendo um desses registros com menos campos preenchidos do que o esperado. 

Além disso foi adicionado na coluna Detalhes ao lado direito das mensagens de erro o botão da Lupa. Este mesmo botão também foi adicionado no ícone Log de envio de email (Campanha do Tipo “Envio de email”) na coluna Links. 

Ao clicar neste botão Lupa é exibido na tela o pop-up com os detalhes técnicos da mensagem de erro em questão. No pop-up foi adicionado abaixo do detalhe técnico o botão Copiar.  

Assim os usuários podem copiar os detalhes técnicos exibidos em tela e compartilhar com o suporte técnico na solicitação de análise do erro, melhorando sua experiência com a plataforma. 

Agendamentos: Tratamento da abertura automática de Atendimento na falha de renovação do token para servidor de email Microsoft

Existe o serviço de autenticação da Microsoft para renovação do token e neste cenário se um Agendamento de Campanha do Tipo “Envio de email” estivesse com o recurso “Abertura automática de atendimento no envio do email” habilitado, em caso de falha no envio de email a plataforma não estava criando o Atendimento com a indicação da falha na categorização pelo campo Solução. 

Foi realizado o tratamento para servidor de email da Microsoft configurado na tela Configurações de comunicação (Administração > Configurações Gerais > Configurações de comunicação > (aba) Servidor de email). 

Ajustado também no ícone Log de envio de email as visualizações: do status de envio na coluna Status do broker e do Atendimento criado na coluna Link pelo botão Atendimento associado. 

Dessa forma a plataforma passa a criar corretamente os Atendimentos de forma automática vinculando a opção do campo Solução configurada pelo Administrador, mesmo existindo falha durante a execução da Campanha. 

Agendamentos: Implementado o novo botão "Conteúdo do SMS"

A partir de agora é possível que o usuário, com permissões para acessar os Agendamentos, visualize o conteúdo enviado ao cliente por mensagem de SMS. Foi implementado para o Tipo “Campanha de SMS” o novo botão Conteúdo do SMS. 

Na tela Agendamentos (Administração > Atendimentos > Agendamentos > (selecionar na listagem o Agendamento do Tipo “Campanha de SMS”) > Agendamentos), clique no ícone Log de envio de SMS. Na listagem exibida abaixo do dashboard de Resumo de envio é disponibilizado na coluna Links o botão Conteúdo do SMS. Ao clicar neste botão é exibido na tela o pop-up com o conteúdo enviado ao cliente por mensagem de SMS através dos disparos de Agendamentos. 

Este novo recurso facilita e garante a auditoria e o acompanhamento das mensagens de SMS enviadas via Agendamentos, contribuindo com a consistência da comunicação entre usuário e cliente, e melhorando a experiência do usuário com a plataforma. 

Configurações Gerais: Alerta na edição de Ocorrências

Na tela Tipo de ocorrência (Administração > Configurações Gerais > Tipo de ocorrência > (selecionar na listagem) > Tipo de ocorrência > (aba) Ocorrências) foi adicionado um alerta que valida a existência de algum Agendamento associado a um Grupo de campo extra do Tipo “Ocorrência”. 

O usuário com a permissão “Editar Tipo de ocorrência”, ao clicar sobre o Código de uma Ocorrência com status “Aprovado” para editá-la e clicar no botão Salvar dentro do mesmo bloco de edição, é exibido na tela o pop-up com a seguinte mensagem de alerta:  

“ATENÇÃO! A Ocorrência está associada a Agendamentos que possuem Campos extras mapeados. Caso continue com essa operação, todos os Agendamentos serão afetados e precisarão ser reconfigurados. Deseja continuar?“ 

Abaixo desta mensagem de alerta o usuário pode escolher clicar entre os botões Continuar ou Cancelar. 

Ao clicar no botão Continuar o usuário precisa acessar o módulo Agendamentos e reconfigurar Campanhas (de qualquer Tipo) que possuem Grupo de campo extra vinculado. Caso o usuário clique no botão Cancelar, as configurações de Agendamentos mapeados com o Grupo de campo extra da Ocorrência não são afetadas. 

Este recurso visa auxiliar o usuário no conhecimento de configurações realizadas na plataforma, evitando assim possíveis impactos nos disparos dos Agendamentos se desejar seguir com a edição de uma Ocorrência.

Agendamentos: Validação de tags insuficientes em Campanhas do Tipo "Envio de email"

Para Agendamentos de Campanha do Tipo “Envio de email” foi desenvolvida a regra de validação de tags. A plataforma passa a mapear a quantidade de tags configuradas na tabela Campos Extras Tags da tela Documento, e identifica se a quantidade de tags configuradas no campo Campo extra é menor na tela Agendamentos. 

Esta regra localiza na tela Agendamentos o template selecionado no campo Template para o email, faz na tela Documento o mapeamento das variáveis ${GCE_*} configuradas no campo de edição de texto, e compara com as tags da tabela ao lado Campos Extras Tags. A plataforma só permite salvar os Agendamentos de Campanha do Tipo “Envio de email” com todas as variáveis mapeadas. 

Se existir a condição de tags insuficientes no momento que o usuário clica no botão Salvar da tela Agendamentos, a plataforma exibe a seguinte mensagem na parte superior da tela: 

“Não é possível agendar esta Campanha, pois as configurações de mapeamento dos dados (Campos extras) para preencher as variáveis no template de email não são suficientes para preencher todos os dados.“ 

Esta implementação auxilia o usuário a salvar Campanhas com a quantidade correta de tags e evita o cenário de disparos dos Agendamentos com dados insuficientes. 

]]> https://hml-docs.citrus.cx/docs/releases-notes/release-notes/versao-2-94-0/feed/ 0 Autenticação de e-mail Microsoft Office 365 https://hml-docs.citrus.cx/docs/guia-do-administrador/administrador-configuracoes-10273/e-mail-microsoft-office-365-com-autenticacao-oauth-2-0-11022/ https://hml-docs.citrus.cx/docs/guia-do-administrador/administrador-configuracoes-10273/e-mail-microsoft-office-365-com-autenticacao-oauth-2-0-11022/#respond Fri, 09 Dec 2022 14:52:00 +0000 https://docs.citrus.cx/docs/guia-do-usuario/administrador-configuracoes-10273/configuracoes-adicionais-10526/e-mail-microsoft-office-365-com-autenticacao-oauth-2-0/

E-mail Microsoft com autenticação OAuth 2.0

Clientes que utilizam serviços de e-mail Microsoft precisam de autorização baseada em token OAuth 2.0 desde outubro de 2022, quando a empresa de tecnologia começou a desativar a autenticação básica para vários protocolos de locatários por vulnerabilidades de segurança (a interrupção definitiva se deu a partir de janeiro de 2023).

Consulte o comunicado emitido pela Microsoft.

A plataforma Citrus adequou-se à implementação da Microsoft a partir da versão 2.57.0. A adaptação permite aos clientes que utilizam o serviço de e-mail Microsoft 365 (Exchange Online) realizar integrações com a plataforma Citrus de acordo com as normas de segurança.

Benefícios

  • Segurança aprimorada (sem senhas expostas): O usuário nunca precisa compartilhar sua senha com o aplicativo. A autenticação ocorre diretamente no endpoint seguro da Microsoft.
  • Autenticação compatível com MFA: Totalmente compatível com Autenticação Multifator (MFA), FIDO2, Windows Hello, e outros métodos. Suporta Microsoft Entra Conditional Access, permitindo aplicar políticas por usuário, dispositivo, localização etc.
  • Acesso limitado e específico: Permite controlar se o acesso é delegado (em nome do usuário) ou em nome da aplicação.
  • Integração: O OAuth 2.0 é o padrão exigido para acessar serviços como: Outlook / Exchange Online; OneDrive e SharePoint; Microsoft Teams; Microsoft Graph API (para dados unificados de usuários, grupos e mensagens). Além de permitir integrações seguras com automações, Power Automate, N8N e sistemas próprios.
  • Tokens temporários e renováveis: O uso de access tokens e refresh tokens evita a necessidade de armazenar credenciais. O token expira automaticamente e pode ser renovado com segurança usando o refresh_token. Facilita a revogação e o controle de sessão.
  • Fluxos flexíveis para diferentes cenários: A Microsoft oferece múltiplos fluxos de autenticação, adaptáveis ao tipo de aplicação.

Ativar consentimento do usuário no Microsoft Office 365

Clientes que utilizam uma conta de e-mail do Microsoft 365, com privilégio de Administrador, precisam ativar o consentimento de uso para permitir que aplicativos utilizem o OpenID Connect e o OAuth 2.0. Essas permisões são necessárias para autenticação e solicitação de acesso a dados.

* A configuração deve ser feita somente nos endereços de e-mail com privilégios de Administrador da conta Microsoft 365.

Para liberar o acesso, siga o passo a passo:

  1. Acesse a sua conta corporativa do Microsoft Office 365, como Administrador Global .
  2. Navegue até Entra ID > Aplicativos Corporativos > Consentimento e permissões > Configurações de consentimento do Administrador.
  3. Em Solicitações de consentimento do Administrador selecione "Sim" para usuários que podem solicitar consentimento do Administrador para os aplicativos para os quais não podem consentir.
  4. Defina as seguintes configurações:

    • Quem pode examinar as solicitações de consentimento do Administrador: Selecione usuários, grupos ou perfis designados como revisores para solicitações de consentimento do Administrador.

    • Usuários que serão notificados por e-mail para solicitações: Habilite ou desabilite as notificações por e-mail para os revisores, quando uma solicitação for feita.

    • Usuários que receberão lembretes sobre expiração de solicitações: Habilite ou desabilite as notificações de e-mail de lembrete aos revisores quando uma solicitação estiver prestes a expirar.

    • Quando solicitações expiram: Especifique por quanto tempo (dias) as solicitações permanecem válidas.

  5. Pressione Salvar.


    IMPORTANTE

    IMPORTANTE

    • Pode levar até uma hora para que o fluxo de trabalho seja habilitado.

    • É possível adicionar ou remover revisores para este fluxo de trabalho, modificando a lista de quem pode revisar solicitações de consentimento de Administrador.

    • Uma limitação desse recurso é que os revisores mantêm a capacidade de revisar as solicitações feitas enquanto eles estavam designados como revisores, e receberão e-mails de lembrete de expiração para essas solicitações depois que eles forem removidos da lista de revisores. Além disso, novos revisores não serão atribuídos às solicitações criadas antes de serem definidos como revisores.

    Mais detalhes na documentação Microsoft .


Configurar autenticação de e-mail de saída no Citrus

Todas as interações nos atendimentos com o cliente e notificações de usuários da plataforma Citrus são disparadas através de um e-mail de saída configurado.

Para realizar este tipo de comunicação utilizando uma conta Microsoft Office 365 existem algumas etapas que precisam ser seguidas. 

Confira as próximas instruções:

  1. Acesse o menu Administração > Configurações Gerais > Configuração de Comunicação.
  2. Na aba Servidor de e-mail devem ser informados os dados de autenticação da conta de e-mail.
  3. Para realizar a autenticação Microsoft clique no botão Entrar abaixo de "Integração OAuth2".
  4. Será exibido um pop-up da Microsoft para selecionar qual conta de e-mail deverá ser associada.

    Insira/selecione os dados de acesso e, em seguida, clique em Aceitar nas permissões listadas para acesso.


  5. Após logar e concluir a ação no pop-up da Microsoft, clique em Salvar para finalizar a configuração no Citrus.
  6. Teste o envio para validar o funcionamento do servidor de e-mail.

    Caso seja exibido o aviso de "Necessidade de aprovação de Administrador", será preciso conceder permissões nas configurações da conta na Microsoft.

Integrar e-mail no canal de atendimento

Depois da ativação de consentimento do usuário na Microsoft Office 365 e configuração de autenticação do e-mail de saída no Citrus será necessário realizar a Configuração de integração do canal de atendimento (no Citrus), para vincular os canais de atendimento cadastrados a serviços externos usados por sua empresa. Neste caso, o “E-mail”.

A partir dessa configuração os Atendentes poderão centralizar todas as suas operações, facilitando e agilizando o contato com clientes.

Proceda como a seguir:

  1. Acesse o menu Administração > Atendimentos > Integração canal de atendimento. 
  2. Clique em +Novo para incluir um novo canal de atendimento.
  3. Serão exibidos os primeiros campos para cadastro, preencha conforme solicitado:

    • Nome*: Informe um nome para identificar o canal.

    • Canal de atendimento*: Selecione o canal “E-mail”.

    • Tipo*: Selecione o tipo de canal de atendimento que será cadastrado. No caso, “E-mail”.

  4. Presssione Salvar e continuar.

  5. Na próxima tela do cadastro a opção de "Integração OAuth2" será novamente exibida.

    Clique em Entrar, insira as credenciais de e-mail e pressione Aceitar para concordar com termos de uso.

  6. Ao finalizar as configurações, clique em Salvar no topo da tela de Integração canal de atendimento. 

Confira o Guia Integração com Provedor de Identidade

]]> https://hml-docs.citrus.cx/docs/guia-do-administrador/administrador-configuracoes-10273/e-mail-microsoft-office-365-com-autenticacao-oauth-2-0-11022/feed/ 0