Configuração de Comunicação – 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 Configuração de Comunicação – Citrus.cx https://hml-docs.citrus.cx 32 32 Versão 2.109.35 https://hml-docs.citrus.cx/docs/releases-notes/release-notes/versoes-2-109-1-a-2-109-0/versao-2-109-35/ https://hml-docs.citrus.cx/docs/releases-notes/release-notes/versoes-2-109-1-a-2-109-0/versao-2-109-35/#respond Fri, 20 Jun 2025 15:26:00 +0000 https://docs.citrus.cx/docs/releases-notes/release-notes/versoes-2-109-1-a-2-109-0/versao-2-109-35/
NOVIDADES

Atendimentos: Novo recurso permite dar continuidade a atendimentos encerrados de forma inesperada

Agora o Citrus conta com o recurso Ligação de Callback para filas de Voz, dando mais autonomia para os Atendentes durante o atendimento.

Com essa novidade, quando uma chamada for encerrada de forma inesperada (por queda ou desligamento do cliente), o sistema exibirá um pop-up de decisão, permitindo ao Atendente escolher entre retomar ou encerrar a ligação. O atendimento manterá o mesmo Protocolo.

Principais Regras 

  • Se o Atendente desligar →  pop-up não aparece. 
  • Se o cliente desligar → pop-up aparece com opções de decisão. 
  • Se o Atendente escolher retomar → o atendimento segue no mesmo card/Protocolo. 
  • Se não retomar → só poderá encerrar o atendimento. 
  • Toda decisão escolhida é registrada identificando o Atendente.

Para ver como as chamadas com Callback funcionam acesse Atendimento em Fila com Callback no Guia de Usuário do Canal de Voz  

Administração | Atendimentos: Dados de cliente e de atendimento agora são tags rápidas para inserir em Grupos de mensagem

A criação de Grupos de mensagem passa a contar com listas de variáveis (tags) de cliente e de atendimento, que podem ser copiadas e inseridas em textos de mensagens padrão.

As mensagens padrão são utilizadas no campo “Comentário”, em formulários de atendimentos dos canais de chat (WhatsApp e WebChat).

Confira como configurar o recurso no Guia de Tags Rápidas para Grupos de mensagem WhatsApp e WebChat

Administração: Implementada configuração que permite selecionar Fila de Resposta para templates de WhatsApp enviados a clientes

Ao enviar um template HSM pelo WhatsApp, o Atendente poderá configurar uma fila de atendimento de retorno. Isso significa que, caso o cliente responda à mensagem, a resposta será direcionada automaticamente para a fila escolhida. 

Confira todos os detalhes e o passo a passo de uso no Guia Configurar Fila de Resposta para HSM 

MELHORIAS

Atendimentos: Cards de voz estão sendo exibidos na tela de Atendimentos após tratamento em renderização

O problema que impedia a exibição de cards do canal de voz na tela de Atendimentos foi solucionado com um tratamento na renderização (construção do card com dados do atendimento para exibição ao Atendente).

Agora, assim que uma chamada de voz tocar, o card será corretamente apresentado, com todas as informações necessárias para interação. 

Atendimentos: Falha em envio de e-mail não impedirá Atendente de “Salvar atendimento” após logout e login na plataforma

Se um Atendente fizer logout do Citrus sem Salvar atendimento, o que gera logout automático de todas as filas de atendimento, quando logar novamente na plataforma poderá realizar o salvamento do formulário de atendimento normalmente. 

Agora, mesmo que ocorra falha ao enviar e-mail como parte do processo de finalização de um atendimento, ao Atendente retornar ao sistema (após fazer logout), o atendimento será salvo. 

Permissão de Câmera: Eliminada exigência de habilitação de câmera

Agora o sistema não exige mais permissão ou a presença de uma câmera instalada para funcionar. Essa melhoria evita erros e interrupções quando o usuário não possui câmera em seu computador, garantindo uma experiência de uso mais fluida. 

CORREÇÕES

Administração: Ajustadas configurações de imagens para customização de ambientes de clientes

O dimensionamento de imagens carregadas pelo menu Administração > Configurações Gerais > Geral foi ajustado para garantir a qualidade de exibição em ambientes customizados para a identidade visual da marca de clientes Citrus.

O ajuste assegura que as dimensões recomendadas para a personalização reflitam com precisão o tamanho real de imagens utilizadas na interface da plataforma.

Tela para configurar a customização da interface da solução. 

Consulte o Guia de Identidade visual da plataforma 

Administração | Atendimentos: Atualizações no fluxo de aceite de formulários de Monitoria de qualidade estão normalizadas

As atualizações geradas a partir de ações do Supervisor e do Atendente no fluxo de Monitoria de qualidade (Administração > Monitoria de qualidade > Formulários de monitoria de qualidade pendentes de aceite do responsável) estão seguindo o comportamento esperado.

Mesmo que não exista configuração de e-mail em Administração > Configurações Gerais > Configuração de comunicação para notificar o Supervisor quando o Atendente aceita ou não aceita uma avaliação, o Supervisor poderá visualizar o retorno do Atendente pelo ícone de Monitoria de qualidade (representado por um ícone de like, na barra de ícones abaixo do contador de SLA) no topo do formulário do atendimento. 

Acesse Atendimentos com monitoria de qualidade 

Consulte Aceite do Atendente responsável 

LemonDesk: Tela de “Configurações de atendimento” está sendo carregada como esperado

A tela de Configurações de atendimento (Administração > LemonDesk > Configurações de atendimento) está acessível para usuários com permissão habilitada.

A falha que fazia um erro de “campo não existente” ser exibido ao tentar abrir a tela foi resolvida.

Atendimentos: Resolvida falha no disparo automático de e-mails com comentários adicionados aos atendimentos

Quando um novo comentário for adicionado a um atendimento o e-mail automático com conteúdo do comentário será disparado para os Atendentes associados ao chamado. 

Foi resolvida a falha que estava bloqueando o disparo automático de e-mails.  

Atendimentos: Cards de chamadas transferidas estão sendo exibidos para Atendente com Autoatendimento habilitado

Transferências de cards de atendimento do canal de voz estão funcionando normalmente para Atendente que possui Autoatendimento habilitado.

O cenário em que cards sumiam da tela de Atendimentos, durante ou após transferência de chamada, foi resolvido. 

Consulte também a Release notes da versão 2.109.30.

Atendimentos: Adicionada verificação para formulários associados a etapas

Agora, enquanto etapas de formulários de atendimentos não estiverem finalizadas, será possível editar seus campos pelo ícone de Formulários ao reabrir um formulário de atendimento com status Finalizado.

Após a finalização das etapas e o respectivo salvamento, será respeitada a regra de o formulário tornar-se bloqueado para edição, preservando a integridade do registro. 

Consulte Soluções e Etapas

Atendimentos: Recurso “Colocar em espera” está funcionando corretamente após tentativa de transferência chamada 

Resolvido o problema que impedia o uso da ação Colocar em espera (tela de Atendimentos),  depois do cancelamento de uma transferência em atendimentos de voz.

Agora, ao cancelar a transferência e acionar novamente o “Colocar em espera“, a chamada é silenciada corretamente e o cliente deixa de ouvir o Atendente.

O ajuste garante que o sistema recupere corretamente o ID (identificador) da ligação em andamento, permitindo a inserção da chamada em espera mesmo após a desistência de transferir um card de voz. 

Monitoramento: Status de cards de atendimento em transferência estão sendo atualizados da forma devida

Quando um card de atendimento estiver sendo transferido entre Atendentes na tela de Atendimentos, em Sessões da aba Detalhes  (tela de Monitoramento), os status desses cards serão atualizados respeitando os estados que devem ser apresentados: “Tocando”, “Em atendimento” ou “Salvando atendimento”. 

O cenário de falha em que o status “Transferindo” era erroneamente exibido em Sessões da aba Detalhes está resolvido.

Confira quais status são apresentados em cada etapa do fluxo de atendimentos de Voz, WhatsApp e WebChat no Guia de Monitoramento Citrus 

]]> https://hml-docs.citrus.cx/docs/releases-notes/release-notes/versoes-2-109-1-a-2-109-0/versao-2-109-35/feed/ 0 Autenticação de e-mail do Google https://hml-docs.citrus.cx/docs/guia-do-administrador/administrador-configuracoes-10273/autenticacao-de-e-mail-do-google-10997/ https://hml-docs.citrus.cx/docs/guia-do-administrador/administrador-configuracoes-10273/autenticacao-de-e-mail-do-google-10997/#respond Thu, 16 Nov 2023 12:46:03 +0000 https://docs.citrus.cx/docs/guia-do-usuario/administrador-configuracoes-10273/configuracoes-adicionais-10526/autenticacao-de-e-mail-do-google/

No Citrus.cx é possível utilizar a sua conta de e-mail do Google (Gmail) para recepcionar atendimentos e enviar notificações da plataforma. Por exemplo: notificações sobre novos comentários ou alteração de status dos atendimento e alertas para usuários que utilizam a plataforma. 

Existem duas formas de liberar essa autenticação do servidor do Gmail:

1. Ativando acesso para os aplicativos de e-mail

2. Gerando uma nova senha específica para a utilização na plataforma.

Vamos explicar as duas maneiras de realizar essa configuração, para que o usuário possa escolher a opção desejada.

1 Ativar acesso para os aplicativos de e-mail

A primeira opção seria ativar o acesso para os aplicativos de e-mail diretamente na conta do Gmail: 

 

1. Acesse a conta do Gmail https://accounts.google.com/

 

2. No canto superior à direita da tela, clique no ícone com a sua foto e depois em Gerenciar sua conta do Google: 

3. Clique no menu Segurança:

4. Localize a opção Acesso a app menos seguro e permita o acesso:

5. Realizada essa liberação será possível configurar o e-mail na tela de  Configurações de Comunicação (Administração> Configurações Gerais > Configuração de Comunicação) no Citrus.

2 Gerar nova senha para uso na plataforma

A segunda opção para configurar uma autenticação é gerar uma nova senha para ser utilizada exclusivamente na plataforma. 

Para utilizar esta opção, primeiramente será necessário configurar a autenticação em duas etapas. 

 

Ainda no menu Segurança do Gerenciamento da sua conta do Google, realize os procedimentos a seguir: 

 

1. Localize a opção Verificação em duas etapas

2. Clique em Começar:

3. Siga as etapas exibidas nas próximas tela, para cadastrar a etapa de segurança desejada.
Para mais informações acesse Ativar a verificação em duas etapas 


Realizada essa ativação, o próximo passo é configurar uma nova senha específica para ser utilizada na plataforma. Siga os próximos passos: 

 

1. Localize a opção Senhas de app: 

2. Na próxima tela, selecione a opção E-mail e depois Outro (nome personalizado):

3. Depois insira um nome de identificação para a senha que será cadastrada e clique em Gerar: 

4. Será exibida uma nova janela com a senha de 16 caracteres gerada:

5. Esta nova senha gerada, deve ser utilizada no campo senha das configurações dos servidores de e-mail no Citrus.

 

Após habilitar uma das formas de autenticação da sua conta do Gmail, siga o passo a passo para configurações do servidor de e-mail no Citrus:

]]> https://hml-docs.citrus.cx/docs/guia-do-administrador/administrador-configuracoes-10273/autenticacao-de-e-mail-do-google-10997/feed/ 0 Configurações de comunicação https://hml-docs.citrus.cx/docs/get-started/administracao/configuracoes-de-comunicacao-10764/ https://hml-docs.citrus.cx/docs/get-started/administracao/configuracoes-de-comunicacao-10764/#respond Mon, 13 Nov 2023 13:21:50 +0000 https://docs.citrus.cx/docs/get-started/plataforma-citrus-cx-10735/configuracoes-de-comunicacao/

Todas as interações nos atendimentos com o cliente, notificações de usuários da plataforma e campanhas podem ser disparadas através de um e-mail de saída configurado e algumas atualizações, como comentários no protocolo, por SMS. 

Na tela de Configurações de comunicação (Administração> Configurações Gerais > Configuração de comunicação) será possível configurar os serviços para o envio de e-mails e SMS para seus clientes diretamente pelo Citrus, seja para informar o andamento de algum atendimento ou envio de alguma campanha. 

Para iniciar a configuração, basta seguir as instruções:

1. Acesse o menu Administração > Configurações Gerais > Configuração de comunicação e será exibida a seguinte tela: 

2. Na aba Servidor de E-mail, poderá ser informado os dados do servidor de E-mail que realizará o envio de e-mails para os clientes. Basta preencher os dados solicitados:

– Servidor SMTP: Informar o servidor SMTP a ser configurado neste campo (campo obrigatório).
– Porta SMTP: Informar a porta de comunicação a ser utilizada pelo servidor SMTP, exemplo 587 (campo obrigatório).
– Servidor IMAP: Informar o servidor IMAP a ser configurado na integração do canal de atendimento em questão (campo obrigatório).
– Porta IMAP: Deverá ser informada a porta do servidor IMAP a ser configurada, exemplo 993 (campo obrigatório).
– Email de Saída: Deverá ser informado por qual conta de e-mail será realizado o envio.
– Identificador: Informar o endereço de e-mail que será identificado nas mensagens enviadas (campo obrigatório).
– Login: Informe o login de acesso do e-mail.
– Senha: Informe a senha de acesso do e-mail.
– Habilitar TLS: Caso o e-mail a ser configurado possua TLS essa flag deverá ser habilitada
– Integração OAuth2: Habilitar essa opção caso escolha utilizar um dos provedores de e-mail com suporte a IMAP e SMTP via XOAUTH2 (Office 365, Google Workspaces, etc)

 

3. Após preencher as informações da configuração do servidor de E-mail, clique em Salvar.

 

4. No canto direito, temos o campo Testar Envio de Email onde pode ser inserido um endereço de e-mail para testar o funcionamento da configuração, para utilizar insira o endereço de e-mail e clique em Enviar para o cliente.

 

5. Na aba Integração com SMS, será possível configurar o envio de mensagens de texto para os clientes diretamente pelo Citrus. Preencha os campos:

– Broker: Selecione a opção referente ao broker para envio de mensagens
– Token de Acesso*:  Informe o código token de acesso (campo obrigatório).
– Integration ID: Informe o código de integração registrado no DCS. Esse código somente é obrigatório para integração com o broker DCS (campo obrigatório).
– WebHook: Informe o endereço de webhook (campo obrigatório).
– Habilitado: Marque essa opção para manter o envio de SMS habilitado.

 

6. Após preencher as informações sobre o SMS, clique em Salvar

 

7. Na parte inferior à esquerda, temos o campo Teste de envio de SMS onde pode ser inserido um número de telefone com DDD para testar o funcionamento da configuração, basta informar o número de telefone celular e clicar em Enviar para o cliente. 

 

Realizada alguma dessas duas configurações, o Citrus já estará configurado corretamente para realizar o envio de notificações.  

]]> https://hml-docs.citrus.cx/docs/get-started/administracao/configuracoes-de-comunicacao-10764/feed/ 0 Versão 2.64.0 https://hml-docs.citrus.cx/docs/releases-notes/release-notes/versao-2-64-0-8715/ https://hml-docs.citrus.cx/docs/releases-notes/release-notes/versao-2-64-0-8715/#respond Wed, 21 Jun 2023 12:24:14 +0000 https://docs.citrus.cx/docs/releases-notes-2/versao-2-64-0/
NOVIDADES

Agendamentos: Dados do mailing poderão ser associados a Grupos de campos extras e enviados via WebService

O recurso de disparo ativo do tipos Campanha de SMS e Campanha de WhatsApp na tela Agendamentos (Administração > Atendimento > Agendamentos), passa possibilitar a associação de Dados do Mailing enviados via Webservice a um Grupo de Campos Extras da Ocorrência configurada para salvar um protocolo após retorno do cliente à mensagem enviada.

Com esse novo recurso, será possível salvar no atendimento registrado a partir da resposta do cliente informações específicas para cada campanha e assunto do disparo, facilitando a busca dos dados na plataforma e histórico do cliente. 

Pré-Requisitos:

1. Possuir Tipo de Ocorrência (Administração > Configurações Gerais > Tipos de Ocorrência) e Ocorrência (Administração > Configurações Gerais > Tipos de Ocorrência > aba Ocorrência) previamente configurado.
Para mais informações, consulte Como Configurar Tipos de Ocorrência e Ocorrências.

2. Configurar o Grupo de Campos Extras (Administração > Configurações Gerais > Grupo de campos extras) do tipo Ocorrência com os dados que serão enviados pelo Webservice. 
Para mais informações, consulte Grupo de Campos Extras.

Importante!
Recomendamos que os campos possuam os mesmo nomes dos campos enviados via integração.
Exemplo: No serviço será enviado o número do contrato, então recomendamos configurar o campo “Nº do contrato” para receber os dados. 

3. Associar o Grupo de campos extras à uma Ocorrência  (Administração > Configurações Gerais > Tipos de Ocorrência > aba Ocorrência).
Para mais informações, consulte Como Configurar Tipos de Ocorrência e Ocorrências. 

Após configurar os pré-requisitos mencionados, na tela de Agendamentos (Administração > Atendimento > Agendamentos) na aba Dados do atendimento, deverá ser selecionada a opção Abertura de atendimento automática no envio do SMS ou Abertura de atendimento automática na resposta do template de notificação(HSM) para ser selecionado o Tipo de Ocorrência e Ocorrência que possuem os campos extras associados para serem integrados com o Webservice. 

Feito isso, no bloco Dados do Mailing deverá ser selecionar a opção Webservice no campo Tipo de Mailing e serão exibidos os novos campos implementados: 

  • Grupo de campo extra: aparecerá a Grupo de Campos Extra associado à Ocorrência, selecionada no bloco Dados dos Atendimentos, para ser selecionado.
  •  Campo Extra:  aparecerá os campos individuais configurados no Grupo de Campo Extra
  •  Campo: deve ser inserido o parâmetro de retorno que será enviado pelo Webservice

Importante!
– Os campos extras obrigatórios precisam ser mapeados. 
– Os registros retornados do webservice e que não possuírem dados para preencher os campos extras que estão configurados como obrigatórios serão processados com falha.

Após a seleção e clique no botão de Adicionar, os campos parametrizados serão listados abaixo.  

 

Importante: Os campos padrões dos dados de cadastro do cliente permanecem na funcionalidade (Código, Nome, Telefone, Telefone 2, Celular, Data de Nascimento), recomendamos o uso de campos extras para o registro de informações específicas relacionadas ao assunto do disparo.

Veja um exemplo prático para alguns segmentos: 

Exemplo “Financeiro“

Cenário: Envio de um lembrete sobre o vencimento da parcela de um financiamento.

Dados do Mailing enviados pelo Webservice: Nome, Celular, CPF, Data de Vencimento, Número do Contrato, Número da Parcela. 

Campos enviados pelo Webservice e associados ao Grupo de Campos Extra: Data de Vencimento, Número do Contrato e Número da Parcela. 

Campos com Dados do Cliente enviados pelo Webservice:  Nome, Celular e CPF

Após execução do Agendamento e resposta do cliente, o atendimento será salvo com os dados do Tipo de Ocorrência Financiamento, Ocorrência Lembrete de Vencimento de Parcela, com os Campos Extras Data de Vencimento, Número do Contrato e Número da Parcela e associado ao cadastro do cliente.

Exemplo “Varejo”

Cenário: Envio de notificação sobre o status de um pedido realizado pelo e-commerce.

Dados do Mailing enviados pelo Webservice: Nome, Celular, CPF, Número do Pedido e Número da Nota Fiscal.

Campos enviados pelo Webservice e associados ao Grupo de Campos Extra: Número do Pedido e Número da Nota Fiscal.

Campos com Dados do Cliente enviados pelo Webservice: Nome, Celular e CPF

Após execução do Agendamento e resposta do cliente, o atendimento será salvo com os dados do Tipo de Ocorrência E-commerce, Ocorrência Notificação de Status do Pedido, com os Campos Extras Data de Vencimento, Número do Contrato e Número da Parcela e associado ao cadastro do cliente. 

 

DICA: Web Service é uma solução utilizada na integração de sistemas e na comunicação entre aplicações diferentes. Com esta tecnologia é possível que novas aplicações possam interagir com aquelas que já existem e que sistemas desenvolvidos em plataformas diferentes sejam compatíveis.

CORREÇÕES

Fluxo de HSM - WhatsApp: Campo "Template de Notificação (HSM)" está sendo exibido normalmente na tela de Atendimentos

O Fluxo de envio de mensagens Ativas HSM (High Structured Message) do WhatsApp recebeu melhorias para tratar diferentes cenários.

O campo “Template de Notificação (HSM)” está sendo exibido normalmente na tela de Atendimentos (LemonDesk > Atendimentos) para permitir adicionar Comentários em Protocolos registrados pelo canal de WhatsApp. 

Foram realizados ajustes nas validações da data de registro do atendimento e para permitir as ações do fluxo correto de 24 horas.

Atendimento registrado pelo WhatsApp nas últimas 24 horas

Comentário visível para o cliente enviado pela mídia WhatsApp sem a necessidade de enviar o Template de Notificação (HSM), ou seja, é possível continuar a conversa nos comentários com mensagem livres. Esse fluxo acontece por estar em uma janela de conversa de 24 horas aberta pelo cliente, premissa do uso do WhatsApp Business API . 

Neste cenário, um pop-up na tela informará quando o atendimento estiver dentro da janela de 24 horas. 

Atendimento registrado pelo WhatsApp, E-mail, WebChat, Formulário Web e Voz após 24 horas

Comentário visível para o cliente enviado pela mídia WhatsApp com um Template de Notificação (HSM), pré-aprovado pela Meta, e após resposta do cliente, será iniciada a sessão de 24 horas permitindo o envio de comentários livres.

Resposta do Fluxo de HSM após escolha de um protocolo não segue o fluxo definido 

A resposta do cliente após escolha do número de um protocolo na listagem do fluxo do do WhatsApp HSM está seguindo o fluxo conforme previsto.

Foram realizados ajustes na validação entre o número da listagem numérica com o protocolo correto para resolver o cenário em que o cliente recebia uma notificação ativa pelo WhatsApp, e ao selecionar um dos números da listagem para responder as informações, não acontecia retorno do fluxo conforme esperado. 

O cenário acontecia quando a notificação enviada por WhatsApp a partir de um comentário visível para o cliente em um protocolo de atendimento (LemonDesk > Atendimentos)  ou em um Agendamento (Administração > Atendimentos > Agendamentos).

Importante!
O fluxo para listar os protocolos para retorno ocorre quando o cliente possui mais de um atendimento pendente (status “Em atendimento”, “Aguardando Retorno” ou “Aguardando Autorização para finalizar”). 

Envio de anexos a partir de uma resposta do atendimento

O recebimento de anexos nos comentários do protocolo (LemonDesk > Atendimentos)  a partir de uma resposta do cliente no fluxo de WhatsApp HSM está normalizado para as interações  dentro da janela de 24 horas pela mídia WhatsApp ou a partir do envio de Template HSM.

Foram realizados ajustes no tratamento da identificação de arquivos durante a sessão de 3 minutos de resposta disponibilizada para o cliente. A correção resolve o cenário em que ao enviar um arquivo como resposta no fluxo, o documento não era anexado no comentário do protocolo.   

Campo “Enviar tempo médio de espera” no canal de atendimento WhatsApp

Para garantir a melhor experiência de usabilidade, a funcionalidade Enviar tempo médio de espera na Configuração de integração do canal de atendimento do tipo WhatsApp (Administração > Atendimentos > Integração canal de atendimento), passará por novas implementações para contemplar todos os cenários necessários para utilização do recurso. 

Por isso, a partir desta versão, a funcionalidade permanecerá oculta na interface e voltará a ser disponibilizada assim que todas as melhorias estiverem disponíveis para serem utilizadas. 

Envio do número de protocolo WebChat

O número de protocolo automático está sendo enviado normalmente após o atendente aceitar o card de Webchat e iniciar a interação com o cliente.

Foram realizadas melhorias no tempo de envio da mensagem atuomática para resolver o cenário em que o atendente aceitava o card para iniciar a conversa com o cliente e a mensagem automática de envio do protocolo não era enviada.

Máscaras em campos filhos de Grupos de Campos Extras

As máscaras aplicadas em campos filhos do tipo Caracter do  Grupo de Campos Extra (Administração > Configurações Gerais > Grupo de campos extra) estão sendo consideradas no preenchimento dos campos no bloco Atendimento da tela de registro de um atendimento. 

Foram realizados ajustes na consulta de retorno para resolver o cenário em que, após associar uma das máscaras disponíveis (E-mail, Telefone, CPF, CNPJ, CEP, Letras Maiúsculas, Letras Minúsculas ou Customizado)  no cadastro de campo filho do tipo Caracter, os formatos não eram considerados conforme preenchido no registro do atendimento.

Quantidade de caracteres do campo E-mail nas Configurações de Comunicação

Os dados de configuração de um Canal de E-mail de Entrada de Atendimento (Administração> Atendimentos> Integração Canal de Atendimento) ou de Saída (Administração > Configurações Gerais > Configuração de Comunicação) passam a permitir o cadastro com informações acima de 50 caracteres. 

Foram realizados ajustes para resolver o cenário em que a quantidade limite de caracteres que não permitiam o preenchimento nos campos Nome do remetente, Email do remetente . SMTP , IMAP e Usuário na configuração de E-mail de entrada (Administração> Atendimentos> Integração Canal de Atendimento) e dos campos Servidor SMTP, Servidor IMAP, Email de Saída , Identificador  e Login na configuração de um E-mail de saída (Administração > Configurações Gerais > Configuração de Comunicação). 

]]> https://hml-docs.citrus.cx/docs/releases-notes/release-notes/versao-2-64-0-8715/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