Tela de Configurações Gerais – 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 Tela de Configurações Gerais – Citrus.cx https://hml-docs.citrus.cx 32 32 Identidade visual da plataforma https://hml-docs.citrus.cx/docs/guia-do-administrador/administrador-configuracoes-10273/identidade-visual-da-plataforma-10543/ https://hml-docs.citrus.cx/docs/guia-do-administrador/administrador-configuracoes-10273/identidade-visual-da-plataforma-10543/#respond Fri, 20 Jun 2025 19:11:00 +0000 https://docs.citrus.cx/docs/guia-do-usuario/administrador-configuracoes-10273/configuracoes-adicionais-10526/identidade-visual-da-plataforma/

Visão Geral

A interface da plataforma Citrus pode ser personalizada para refletir a identidade visual de empresas clientes.  

É possível customizar desde o nome que aparecerá no navegador de internet até a tela de login, logomarcas, cores de planos de fundo e de textos, e nomes de alguns menus.  

As configurações permitem alinhar a plataforma ao padrão visual da marca cliente, para que ela fortaleça a experiência de seus usuários e consiga tornar sua comunicação mais consistente. 

 

Benefícios 

  • Reforça a consistência de marca, deixando a experiência alinhada ao manual de identidade visual da empresa. 
  • Faz com que usuários identifiquem rapidamente que estão no ambiente correto. 
  • Gera credibilidade e confiança. 
  • Facilita a navegação, já que cores e ícones familiares ajudam o usuário a se localizar. 
  • Favorece o engajamento do usuário por transmitir um ambiente mais próximo da marca com a qual já está acostumado. 
  • Transmite a percepção de exclusividade. 
  • Evita dependência de desenvolvimento sempre que acontecer mudança de layout ou atualização de branding. 

Acesso

A personalização pode ser aplicada na tela de Configurações Gerais, pelo menu Administração > Configurações Gerais > Geral.

Permissões e Pré-requisitos

Possuir Perfil com permissão habilitada para acessar o menu Configurações Gerais. A permissão precisa ser concedida por um Administrador em Administração > Usuários > Perfil > (selecionar) Perfil de usuário > (aba) Configurações Gerais. 

Configurar Identidade Visual

  1. No menu Configurações Gerais > Geral, siga para a seção de Personalização.

    Para iniciar, habilite a caixa de Personalização.

  2. Ao habilitar a opção, os campos customizáveis exibirão o botão Alterar. Serão aceitas imagens nos formatos JPG, PNG ou WEBP.
  3. Para adicionar as imagens, proceda como a seguir:

    *As dimensões exigidas na configuração são exibidas pela caixa de informação (i) de cada campo.

    • Logo: será exibido para o usuário após o login, no topo do menu principal (lateral esquerda da plataforma). Dimensões recomendadas: 1324 x 360 pixels.

    A partir da versão 2.57.0, também é possível incluir logos com altura máxima de 38 pixels.

    • BG Login: o background de login é a imagem de fundo que aparecerá na tela de acesso à plataforma. Dimensões recomendadas: 1920 x 920 pixels.

    • Logo Login: imagem da logo da empresa, que será mostrada na tela de login da plataforma. Dimensões recomendadas: 1320 x 510 pixels.

    • Favicon: é a imagem exibida como ícone do navegador. Dimensões recomendadas: 144 x 144 pixels.

  4. As cores de exibição de alguns recursos e de textos também podem ser personalizadas. Essas configurações podem ser desfeitas sempre que necessário, pressionando o botão Restaurar padrão de cores.

    É possível customizar cores dos seguintes recursos da interface:

    • Menu primário

    • Menu secundário

    • Fila Logada

    • Fila Deslogada

    • Botão (de) Login

  5. A personalização ainda permite alterar os textos (labels), que serão utilizados como nomes para identificar alguns menus da plataforma.

  6. Também é possível “Habilitar aceite de termo de uso da plataforma”, marcando a caixa de seleção do recurso. O campo permite configurar a exigência de que os usuários aceitem os Termos Gerais de Uso da Plataforma antes de utilizarem o sistema.

    O editor oferece opções de estilo e formatação para deixar o termo mais claro e organizado. É possível personalizar o conteúdo do termo de uso, com formatações de texto e inserção de informações adicionais.

  7. Clique em Salvar no topo da tela de Configurações Gerais, para registrar as configurações de personalização.

Consulte todas as atualizações da tela de Identidade Visual

]]> https://hml-docs.citrus.cx/docs/guia-do-administrador/administrador-configuracoes-10273/identidade-visual-da-plataforma-10543/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