OAuth 2.0 – 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 OAuth 2.0 – Citrus.cx https://hml-docs.citrus.cx 32 32 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 Versão 2.57.0 https://hml-docs.citrus.cx/docs/releases-notes/release-notes/versao-2-57-0-8701/ https://hml-docs.citrus.cx/docs/releases-notes/release-notes/versao-2-57-0-8701/#respond Fri, 09 Dec 2022 12:20:00 +0000 https://docs.citrus.cx/docs/releases-notes-2/versao-2-57-0/
NOVIDADES

Atendimentos: Implementado recurso de Distribuição automática do responsável pelo atendimento

Existe uma configuração opcional para que os atendimentos recebidos pelo canal de E-mail já sejam convertidos de forma automática em Atendimentos (LemonDesk > Atendimentos). Saiba mais em Como configurar a Conversão Automática no canal de E-mail.  

Associado a este recurso implementamos a funcionalidade de Distribuição Automática dos Protocolos recebidos para os usuários configurados. Com essa melhoria, não será mais necessário atribuir manualmente ou direcionar para que o atendente interaja no atendimento para ficar indicado como responsável, otimizando ainda mais o tempo do atendimento e produtividade das equipes. 

Para habilitar a configuração, acesse Configuração de integração do canal de atendimento (Administração > Atendimentos > Integração canal de atendimento), nas Configurações de conversão automática de pré-atendimento para atendimento, após selecionar uma Ocorrência será exibida a flag Habilitar distribuição automática do responsável pelo atendimento, em seguida, indique se a distribuição será feita entre os Usuários do Setor ou Grupo de Solução.

Agora, com a configuração habilitada, assim que o atendimento for recebido por E-mail e disponibilizado na tela de Atendimentos (LemonDesk>Atendimentos), já irá automaticamente aparecer um usuário como Responsável para aquele atendimento. 

Para saber mais informações e regras sobre essa configuração, consulte a documentação Como configurar a Conversão Automática no canal de E-mail e Distribuição Automática de Atendimentos.  

Configurações Gerais: Autenticação de e-mail da Microsoft Office 365 será pelo OAuth 2.0

Conforme o comunicado feito pela Microsoft, será desativado esse tipo de autenticação básica para serviços de E-mail nos clientes que os utilizam. A partir de Janeiro de 2023, o acesso às funcionalidades da Microsoft se dará exclusivamente através de mecanismos de autenticação moderna.

A autenticação moderna (autorização baseada em token OAuth 2.0) tem muitos benefícios e melhorias que ajudam a atenuar os problemas na autenticação básica.

Por exemplo, os tokens de acesso OAuth têm um tempo de vida útil limitado e são específicos para os aplicativos e recursos para os quais são emitidos, portanto, não podem ser reutilizados.

A partir desta versão, será possível utilizar o serviço de e-mail da Microsoft Office 365 com a autenticação OAuth 2.0, além disso existem algumas ações que precisam ser realizadas.

Saiba mais informações em Configurando e-mail Microsoft Office 365 com autenticação OAuth 2.0

Padronizações de Atendimento: Incluído campo de "Classificação do Atendimento" na tela de cadastro

As Padronizações de Atendimento são utilizadas para agilizar o processo de preenchimento das informações de novos atendimentos, pré-definindo os campos ou a descrição que deverão ser preenchidos ao registrar um novo Atendimento.

Saiba mais em Como Configurar Padronizações de Atendimento

Além dos campos Canal de Atendimento, Tipo de Ocorrência, Ocorrência, Solução e Descrição, agora será possível selecionar uma classificação para o registro do atendimento preenchendo o campo Classificação do Atendimento.

Para configurar novas padronizações com Classificações pré-definidas, acesse a tela de Padronizações de Atendimento (Administração > LemonDesk > Padronização de Atendimento), selecione o Tipo de Ocorrência e Ocorrência e será possível escolher uma Classificação do Atendimento por meio do campo disponibilizado.

 

IMPORTANTE: As classificações devem ser do tipo Atendimento e previamente configuradas em Administração > LemonDesk > Classificação.

Tipo de Ocorrência: Classificação de Atendimento poderá ser associada a uma Ocorrência

As Ocorrências (Administração > Configurações Gerais > Tipo de Ocorrência > aba Ocorrência) são os assuntos mais específicos de um Tipo de Ocorrência utilizados pelo atendente para registrar as solicitações dos clientes que os Clientes buscam ao abrir novas solicitações. 

Através destas categorizações é possível ter uma visão específica dos assuntos mais demandados nos relatórios e evoluir os processos de atendimento.. Saiba mais em Como Configurar Tipos de Ocorrência e Ocorrências.

A Classificação do Atendimento (Administração > LemonDesk > Classificação) pode ser utilizada de forma associada às ocorrências para segmentar os tipos de tratativas recebidas, como exemplo: 

Uma mesma ocorrência pode ser classificada como Elogio, Sugestão, Reclamação, Informação ou Denúncia ou apenas como Reclamação ou Denúncia. 

Na tela do Atendimento (LemonDesk > Atendimentos), as classificações configuradas com o tipo Atendimento eram exibidas para todas as Ocorrência configuradas, não permitindo direcionar o atendente para selecionar as classificações específicas para determinada ocorrência. 

Com esse cenário, implementamos uma nova melhoria para associar uma ou mais classificações específicas para uma Ocorrência, facilitando e direcionando o atendente para realizar classificações mais assertivas e rápidas. 

 

Na tela de registro do Atendimento, o comportamento será o seguinte: 
– Quando o atendente classificar o atendimento e clicar no campo Classificação do Atendimento, aparecerá a listagem de classificações do tipo “Atendimento” associadas a uma Ocorrência.
– Se não houverem classificações associadas a uma ocorrência no campo Classificação do Atendimento, serão exibidas todas as opções do tipo Atendimento configuradas na tela de Classificação (Administração > LemonDesk > Classificação). 

 

Para adicionar uma ou mais classificações de Atendimento específicas para  uma Ocorrência, acesse  a tela de Tipo de ocorrência (Administração > Configurações Gerais > Tipo de Ocorrência) e na aba Ocorrência estará disponível o campo Classificação do Atendimento para que seja selecionada a opção de classificação desejada.

 

IMPORTANTE: As classificações devem ser do tipo Atendimento e previamente configuradas em Administração > LemonDesk > Classificação

Tipos de Ocorrência de mesmo nome poderão ser cadastradas para diferentes Setores

Os Tipos de Ocorrência para realizar o registro dos assuntos dos atendimentos já são segmentados por setores, mas não era possível utilizar a mesma nomenclatura na configuração para setores diferentes. 

A partir desta versão será possível realizar o cadastro de Tipos de Ocorrência (Administração > Configurações Gerais > Tipo de Ocorrência) com o mesmo nome, porém sendo diferenciado pelo Setor que for vinculado. 

Esse recurso, atendente cenários de atendimento que necessitam emitir relatórios padronizados a partir de diretrizes específicas, como por exemplo, as mesmas nomenclaturas nas categorizações dos atendimentos nos setores de SAC e Ouvidoria. 

Para mais informações sobre o cadastro, consulte a documentação Como Configurar Tipos de Ocorrência e Ocorrências. 

Configurações Gerais: Logo do Menu Principal poderá ser personalizado

Atualmente é possível personalizar a plataforma, alterando os temas de cores de menus, logotipo e ações para tornar a identidade personalizada para cada empresa. 

A partir desta versão, será possível inserir um logo maior para o Menu Principal.

Saiba mais sobre a personalização na documentação Como personalizar a identidade do Citrus.cx

CORREÇÕES

Formulário web: Múltiplos Protocolos de Formulário Web

Com o canal de Formulário Web (LemonDesk> Pré-Atendimento > aba Formulário Web) é possível receber solicitações de atendimento 24 horas por dia, através da disponibilização de um link.  Saiba mais em Como Configurar um Formulário Web.

No registro dos atendimento deste canal, ocorria um cenário onde o usuário clicava mais de uma vez para enviar os dados e com isso eram registrados uma sequência de protocolos com a mesma solicitação com a diferença de segundos.   

Realizamos melhorias nesta funcionalidade exibindo uma mensagem de confirmação ao realizar o primeiro envio de dados, evitando o registro de vários protocolos iguais em sequência. 

Grupos de campos extras: Informações de campos extras de Etapas dos Atendimentos estão sendo salvas corretamente

Dependendo da necessidade de cada cliente, pode ocorrer que ao realizar a abertura de um novo atendimento um Grupo de Campos Extras (Adminstração > Configurações Gerais > Grupo de Campos Extras) pode não estar configurado no registro do atendimento, porém nas Etapas do Fluxo de Soluções pode ser que o Grupo de Campos Extras estejam associados. 

Ocorria um cenário nos atendimentos que possuíam Grupo de Campos Extras apenas na etapa do Fluxo de Soluções, onde ao preencher as informações nos campos realizar a ação de Salvar, era exibida uma mensagem de erro e as informações eram perdidas.  

Realizamos melhorias na validação de atendimentos que possuem apenas campos extras nas etapas dos atendimentos, para que as informações sejam salvas corretamente.  

Atendimentos: Seleção automática do script na tela do Atendente

Os scripts de atendimento podem ser utilizados para direcionar os atendentes de forma assertiva na condução dos atendimentos. 

Nas configurações de uma Ocorrência (Administração > Configurações Gerais> Tipo de Ocorrência > aba Ocorrência) , é possível associar um script específico para ser utilizado com aquele determinado assunto, ao preencher o campo Script de Atendimento.   (Saiba mais em Como Configurar Scripts de Atendimento). 

Havia um cenário na tela de Atendimento (LemonDesk > Atendimentos), onde ao selecionar uma Ocorrência, o Script associado não era automaticamente selecionado.

Realizamos melhorias na regra de exibição, para ter os seguintes comportamentos: 

  • Quando o atendente aceitar um card de atendimento e houver um script associado a Fila de Atendimento, esse script será automaticamente selecionado na tela de Atendimentos (LemonDesk > Atendimentos). 
  • Após o preenchimento do campo Ocorrência, caso haja um script associado, será substituído o script da fila de atendimento pelo da Ocorrência. 
  • Caso a fila ou a ocorrência não possua scripts associados, aparecerá selecionado o primeiro configurado e a listagem das demais opções configuradas.    

Envio de Informações para o Cliente

Na Tela de Atendimento, com o botão Enviar informação para o cliente é possível enviar informações adicionais e anexos durante o atendimento em tempo real através dos canais de E-mail e SMS. Após o registro do atendimento, as informações enviadas ficam salvas como um comentário dentro do protocolo.  

Com a realização desta ação, ocorria um cenário onde ao utilizar este botão para envio de informações tanto por E-mail ou por SMS, era exibida a Tag de Falha no envio,  porém o E-mail ou o SMS eram enviados corretamente para o cliente. 

Realizamos melhorias para que essa indicação de falha não fosse apresentada incorretamente e que fosse exibida apenas nos momentos em que as informações não fossem enviadas corretamente para os clientes. 

Observação sobre o Cliente nos Atendimentos

Na tela de cadastro de Clientes (Administração > Configurações Gerais > Clientes) existe a aba de Observação onde podem ser inseridas informações sobre o cliente para serem consultadas durante o atendimento na tela de Atendimentos (LemonDesk > Atendimentos) no botão Observação ().

Ocorria um cenário onde este ícone não estava disponível em atendimentos que não permitiam edições (Status Finalizado, Cancelado e Improcedente) mesmo se houvessem observações preenchidas na tela de cadastro do Cliente.

Realizamos melhorias para que o ícone fosse disponibilizado normalmente na tela de Atendimentos (LemonDesk > Atendimento) em todos os status.

Edição de Cadastro dos Clientes no Atendimento

Nos Atendimentos (LemonDesk > Atendimento), é possível realizar a edição dos dados cadastrais de contato do Cliente (Administração > Configurações Gerais > Cliente) no botão Atualizar Dados do Cliente. 

Essa permissão de alteração era global para todos os usuários que possuíam permissão para editar os atendimentos, impactando nos cenários em que os dados cadastrais do cliente são enviados através de uma API de Integração ( Administração > Configurações Gerais > Integração com cliente). 

Para resolver este cenário em que os dados cadastrais não podem ser alterados, criamos a permissão Editar cadastro do cliente no atendimento (Administração> Usuários> Perfil) para que a funcionalidade fique disponível para os usuários essenciais. Para mais informações acesse Como Configurar Perfis de Acesso

Prévia da Descrição de Atendimentos

Ao acessar a tela de Atendimento (LemonDesk > Atendimentos) e clicar no ícone + é possível expandir as informações e obter uma prévia da descrição, comentários entre outras informações sobre o atendimento que foi aberto. 

Ocorria um cenário onde a descrição não era exibida ao clicar no ícone para expandir os detalhes. Realizamos melhorias para que as informações sejam exibidas corretamente: 

Atendente: Fluxo de Atendimento por WhatsApp está ocorrendo conforme o esperado

No atendimento por canal de WhatsApp (HSM) existe um determinado fluxo configurado em que o usuário precisa informar alguns dados necessários para dar continuidade no atendimento.   

Ocorriam alguns cenários onde o cliente iniciava o atendimento pelo canal de WhatsApp, dava as informações necessárias para ser transferido para algum atendente, porém ficava preso no fluxo de atendimento, sem conseguir dar continuidade.

Realizamos melhorias no fluxo de atendimento por este canal, para que o cliente seja direcionado normalmente conforme a necessidade do seu atendimento.

]]> https://hml-docs.citrus.cx/docs/releases-notes/release-notes/versao-2-57-0-8701/feed/ 0