JavaScript – Citrus.cx https://hml-docs.citrus.cx Base de Conhecimento Fri, 08 Aug 2025 13:58:29 +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 JavaScript – Citrus.cx https://hml-docs.citrus.cx 32 32 Versão 2.86.8 https://hml-docs.citrus.cx/docs/releases-notes/release-notes/versoes-2-86-10-a-2-86-0-28176/versao-2-86-8-28317/ https://hml-docs.citrus.cx/docs/releases-notes/release-notes/versoes-2-86-10-a-2-86-0-28176/versao-2-86-8-28317/#respond Fri, 08 Dec 2023 21:00:00 +0000 https://docs.citrus.cx/docs/releases-notes/versoes-2-86-10-a-2-86-0-28176/versao-2-86-8/

Alertas de monitoramento: Novos tipos de Alertas de monitoramento disponíveis para Supervisores

O recurso de Alertas de monitoramento (menu Administração > Atendimentos > Alertas de monitoramento) recebeu melhorias com a implementação de novos tipos de alerta que auxiliam e otimizam as atividades de monitoramento em tempo real dos atendimentos realizados na plataforma, facilitando a atuação do Supervisor e garantindo a qualidade dos serviços prestados. 

Foi adicionado à aba Alertas das filas de chats da tela de configuração de Alertas de monitoramento o campo “Tempo dos agentes em pausa”, onde deverá ser informado o tempo de pausa dos agentes de uma determinada Fila para cada nível de criticidade, considerando que quanto maior o tempo de pausa dos agentes, maior o nível de criticidade.

Foi implementada a aba Alertas dos agentes, onde deverão ser preenchidos os campos “Agente”, “Tempo de agente disponível” e “Tempo de agente em atendimento”, considerando que quanto maior o tempo do agente em atendimento ou disponível, mas sem receber atendimentos, maior o nível de criticidade.

Para a visualização desses alertas na aba Detalhes da tela de Monitoramento, foram adicionadas as colunas: “Tempo de disponibilidade” na listagem de Atendentes; e, “Tempo do atendimento” na listagem de Sessões.

Para permitir a criação de alertas para as Filas de Voz, foi adicionada ainda a aba Alertas das filas de vozes, onde deverão ser preenchidos os campos: “Fila”, “Quantidade de agentes logados”, “Quantidade de clientes em espera”, “Quantidade de agentes em pausa”, “Quantidade de agentes em atendimento”, “Tempo dos clientes em espera” e “Tempo dos agentes em pausa”.

Dica: Em todos os alertas, é preciso configurar os limites de quantidade e tempo para cada nível de criticidade:
  • Nível 1 (amarelo): Menor criticidade.
  • Nível 2 (laranja): Criticidade média.
  • Nível 3 (vermelho): Maior criticidade.

Na prática, os alertas visuais e sonoros configurados serão emitidos na listagem de Atendentes da aba Detalhes na tela de Monitoramento (menu Estatísticas > Monitoramento).

IMPORTANTE! Só poderão criar Alertas de monitoramento os usuários com Perfil de Supervisor que estejam associados a um Grupo de monitoramento, adicionado na aba Supervisor (menu Administração > Atendimentos > Grupo de monitoramento > (selecionar) Grupo de monitoramento > (aba) Supervisor), e que possuam as seguintes permissões habilitadas para o seu Perfil de acesso (menu Administração > Usuários > Perfil > (perfil de) Supervisor > (aba) Atendimento):
  • Listar alerta de monitoramento
  • Criar alerta de monitoramento
  • Editar alerta de monitoramento
  • Deletar alerta de monitoramento

Atendimentos: Otimizado o preenchimento automático do campo “Tipo de Cliente” a partir de Integração com cliente

O recurso de preenchimento automático do campo “Tipo de Cliente” do formulário de registro de atendimentos recebeu melhorias juntamente com a funcionalidade de Integração com cliente (menu Administração > Configurações Gerais > Integração com cliente).

Com as mudanças, além de identificar os Tipos de Cliente “Pessoa física” e “Pessoa jurídica” por meio da máscara configurada para o campo, a plataforma passa a identificar também indivíduos com perfil de “Não cliente” a partir da busca na integração e na base local de contatos.

Exemplos de uso nas rotinas de atendimento

Primeiramente, para que o recurso funcione adequadamente, é necessário realizar algumas configurações básicas:

  1. Criar Tipo de Cliente “Não cliente” (menu Administração > Configurações Gerais > Tipo de cliente > +Novo).
  2. Criar Integração com cliente, marcando a flag “Habilitar o preenchimento automático do Tipo de Cliente” e selecionando a opção “Não cliente” no campo “Tipo de cliente” (menu Administração > Configurações Gerais > Integração com cliente > (selecionar) Integração > (aba) Dados para consulta).
  3. Criar Tipo de Cliente “Pessoa física”, associado à Integração com o cliente criada anteriormente, com “Máscara para campo de código” de 11 dígitos numéricos, correspondente a um CPF (menu Administração > Configurações Gerais > Tipo de cliente > +Novo).
  4. Criar Tipo de Cliente “Pessoa jurídica”, associado à Integração com o cliente criada anteriormente e com “Máscara para campo de código” de 14 dígitos numéricos, correspondente a um CNPJ (menu Administração > Configurações Gerais > Tipo de cliente > +Novo).

Cliente Pessoa Física

Finalizadas as configurações, o cadastro de novos atendimentos acontecerá da seguinte forma: 

  1. O Atendente abre a tela de cadastro de Atendimentos (menu LemonDesk > Atendimentos > +Novo).
  2. No campo “Código”, insere um valor de 11 dígitos numéricos e clica em Pesquisar.
  3. A máscara é reconhecida e o campo “Tipo de Cliente” é preenchido de maneira automática com a opção “Pessoa física”.
  4. É realizada uma busca na integração e na base local de contatos pelo valor inserido.
  5. Se o valor identificado pela máscara do campo como CPF for localizado na integração ou na base local, o campo “Tipo de Cliente” permanecerá com a opção “Pessoa física”. Se o valor não for encontrado, o campo será preenchido automaticamente com a opção “Não cliente”.

Cliente Pessoa Jurídica

O mesmo ocorre no caso de clientes que forem pessoas jurídicas, conforme o fluxo abaixo:

  1. O Atendente abre a tela de cadastro de Atendimentos (menu LemonDesk > Atendimentos > +Novo).
  2. No campo “Código”, insere um valor de 14 dígitos numéricos e clica em Pesquisar.
  3. A máscara é reconhecida e o campo “Tipo de Cliente” é preenchido de maneira automática com a opção “Pessoa jurídica”.
  4. É realizada uma busca na integração e na base local de contatos pelo valor inserido.
  5. Se o valor identificado pela máscara do campo como CNPJ for localizado na integração ou na base local, o campo “Tipo de Cliente” permanecerá com a opção “Pessoa jurídica”. Por outro lado, se o valor não for encontrado, o campo será preenchido automaticamente com a opção “Não cliente”.

Template de E-mail: Templates do Tipo “Assentamento do atendimento” passam a permitir o uso de tags variáveis

A partir de agora, passa a ser possível utilizar tags variáveis nos Templates de E-mail (menu Administração > Configurações Gerais > Template de e-mail) do Tipo “Assentamento do atendimento”. 

As tags incluídas nesses Templates são substituídas pelas informações correspondentes nos Comentários enviados por e-mail para outros colaboradores e registrados nos Protocolos de atendimentos, facilitando a sua personalização e agilizando o envio de informes internos para as equipes da instituição.

Com a melhoria, poderão ser inseridas nos Templates de E-mail de Assentamento do atendimento tags das seguintes categorias:

 

  • Dados do Cliente

Cliente: ${NOME_CLIENTE}

Tipo do Cliente: ${TIPO_CLIENTE}

Código do Cliente: ${CODIGO_CLIENTE}

Telefone do Cliente: ${TELEFONE_CLIENTE}

Segundo telefone do Cliente: ${TELEFONE2_CLIENTE}

Celular do Cliente: ${CELULAR_CLIENTE}

Email do Cliente: ${CLIENTE_EMAIL}

 

  • Dados do Atendimento

Protocolo: ${PROTOCOLO} 

Link do Protocolo: ${PROTOCOLO_LINK}

Tipo de Ocorrencia: ${TIPO_OCORRENCIA}

Ocorrencia: ${OCORRENCIA}

Data de abertura: ${DATA_ABERTURA}

Descrição do atendimento: ${DESCRICAO}

Canal de Atendimento: ${CANAL_ATENDIMENTO}

Status do Atendimento: ${STATUS_ATENDIMENTO}

Solução: ${SOLUCAO}

Responsável do Atendimento: ${RESPONSAVEL_ATENDIMENTO}

Se a tag ${PROTOCOLO_LINK} estiver configurada, no Comentário registrado e enviado por e-mail para outro(s) colaborador(es) será exibido um número clicável com o link de acesso ao Protocolo do respectivo atendimento na plataforma.

  • Dados do Fluxo de etapas

Setor: ${SETOR}

Setor responsável pela etapa: ${SETOR_ETAPA}

Etapa atual: ${ETAPA_ATUAL}

Responsável pela etapa: ${RESPONSAVEL_ETAPA}

 

  • Dados de Campos extras

Na configuração de um Template de E-mail, após adicionar uma Ocorrência que possua campos extras associados, será exibida a mensagem clicável “Campos extras disponíveis no Template de e-mail”, informando ao usuário que ele poderá configurar tags de campos extras no Template de E-mail que está sendo criado. Ao clicar na mensagem, ele será redirecionado à aba Template e-mail, onde poderá selecionar no campo “Grupo de campo extra” um campo extra associado a alguma das Ocorrências adicionadas.

IMPORTANTE! Para o correto funcionamento das tags cadastradas, é necessário que as tags inseridas no formulário de cadastro do Template de E-mail sejam as mesmas pertencentes ao Grupo do campos extras selecionado.

Após inserir as tags dos campos extras no texto do Template de E-mail e pressionar Salvar, essas tags serão listadas na tela de cadastro, abaixo da listagem de Tags.

ATENÇÃO!

  • Quando uma Ocorrência for excluída da listagem da aba Ocorrência da tela de cadastro do Template de E-mail, o Grupo de campos extras associado a ela também será removido do campo correspondente na aba Template e-mail.
  • Quando um Grupo de campos extras de uma Ocorrência for desvinculado dela, ele também será removido do campo de seleção da aba Template e-mail, sendo seus itens excluídos da listagem de Tags e do texto do Template.

Ao cadastrar um novo atendimento, caso o Atendente selecione uma Ocorrência que esteja associada a um Template de E-mail do Tipo “Assentamento do atendimento”, estando suas tags configuradas, após selecioná-lo no campo “Template de E-mail”, a mensagem configurada e suas tags serão exibidas no campo “Comentário”. 

Em seguida, ao clicar em +Adicionar, o Comentário será registrado no Protocolo de atendimento e as tags serão substituídas pelos valores inseridos nos campos correspondentes.

Implementado Tipo de Template de E-mail “Enviar informação para o cliente"

Além disso, foi implementada na plataforma uma nova categoria de Template de E-mail destinada exclusivamente ao envio de informações para o cliente durante o registro de um atendimento em curso, facilitando a atuação do Atendente.

Na implementação, foi adicionada a opção “Enviar informação para o cliente” ao campo “Tipo” da tela de cadastro de Template de E-mail (menu Administração > Configurações Gerais > Template de E-mail > +Novo). 

Com isso, na tela do formulário de registro de atendimentos, ao clicar no botão Enviar informação para o cliente, no campo “Template de E-mail” do pop-up aberto serão listados apenas Templates de E-mail do Tipo “Enviar informação para o cliente” cadastrados na plataforma. 

Quando o Atendente enviar um e-mail para o cliente durante um atendimento em curso, ao salvar o card, o Comentário enviado ficará registrado no Protocolo de atendimento. Do mesmo modo, quando o cliente responder a esse e-mail, as informações serão registradas no Protocolo de atendimento que foi salvo.

O recurso se aplica à tela do formulário de registro no caso de Atendimentos recebidos por meio dos canais de Voz, WebChat e WhatsApp, bem como daqueles cadastrados manualmente pelo menu LemonDesk > Atendimentos > +Novo

Avisos: Tela de listagem e Quadro de avisos estão exibindo seus itens corretamente

A tela de listagem de Avisos (menu Administração > Configurações Gerais > Avisos) e o Quadro de avisos do Dashboard da tela do Atendente (Menu Principal > Atendente) estão exibindo seus itens conforme o esperado.

Foi corrigido o cenário de erro em que, no cadastro de um novo Aviso (menu Administração > Configurações Gerais > Avisos > +Novo), caso fossem injetados scripts nos campos “Nome” e/ou “Mensagem”, os comando eram registrados e executados na plataforma, ocasionando quebra na tela de listagem e a exibição de alertas de falha.

O mesmo cenário também era observado na tela do Atendente, no Quadro de avisos do Dashboard e na tela de edição do cadastro de um Aviso com script injetado.

Feitas as correções, o Quadro de avisos e as telas de listagem e de edição de Avisos não estão mais executando scripts nem exibindo alertas de injeções.

Atendente: Dados de campos extras do formulário de registro estão sendo carregados após transferência de atendimento de WhatsApp pelo Bot

Os dados dos campos extras e demais campos auxiliares estão sendo carregados normalmente no formulário de registro de atendimento, mesmo depois de um atendimento de WhatsApp ser transferido para um Atendente pelo Bot.

Foi corrigido o cenário em que os campos extras do formulário de registro de atendimento não eram carregados após a transferência do Bot para um Atendente humano em Atendimentos via WhatsApp. 

DICA: Quando o formulário de registro era aberto após o clique no card de WhatsApp, os campos extras apareciam em branco. No entanto, ao clicar no botão de Pesquisar ao lado dos campos de “Código” e/ou “Nome”, os campos extras eram preenchidos.

Agora, feitos os ajustes necessários, após aceitar um atendimento de WhatsApp iniciado no Bot, os dados serão retornados ao se buscar pelo cliente na criação do atendimento e o Atendente conseguirá visualizá-los no formulário de registro do atendimento criado.

]]>
https://hml-docs.citrus.cx/docs/releases-notes/release-notes/versoes-2-86-10-a-2-86-0-28176/versao-2-86-8-28317/feed/ 0
Versão 2.61.0 https://hml-docs.citrus.cx/docs/releases-notes/release-notes/versao-2-61-0-8709/ https://hml-docs.citrus.cx/docs/releases-notes/release-notes/versao-2-61-0-8709/#respond Wed, 21 Jun 2023 12:23:41 +0000 https://docs.citrus.cx/docs/releases-notes-2/versao-2-61-0/

Base de conhecimento: Criado status “Em validação” para artigos

O cadastro de artigos da Base de conhecimento (Menu Principal > Base de Conhecimento) passa a contar com o novo status “Em validação” para ser utilizado na visualização dos conteúdos de apoio aos fluxos de atendimento. 

O novo status permite que conteúdos que passaram por atualizações e estão em etapa de validação ainda fiquem disponíveis para serem visualizados pelo Atendente. 

Para realizar ajustes nos artigos com pendência de validação, com os status anteriores da plataforma (Rascunho e Aprovado), era necessário alterar para o status “Rascunho” que restringia a visualização.

Os artigos com o status “Em validação” podem ser identificados com o ícone na cor laranja na aba da Base de conhecimento da tela do Atendente e na tela do menu Base de conhecimento.

Exemplo: Na prática, os artigos “Em validação” ficam disponíveis para uso do Atendente como apoio nos Atendimentos, mas com a observação de que algumas informações podem ter a necessidade de serem confirmadas com o Supervisor.

IMPORTANTE:

  • Apenas os usuários cadastrados com o Perfil (Administração > Usuários > Perfil) do tipo Sistema terão acesso aos artigos com o status “Em validação”.
  • Usuários com Perfil do tipo Cliente não terão acesso aos artigos com status “Em Validação”.
  • Para os artigos serem visualizados no ícone da Base de conhecimento, a flag “Visível para o cliente” deve estar habilitada e um dos status “Aprovado” ou “Em Validação” selecionados.

Para mais informações, acesse Como Cadastrar Artigos na Base de Conhecimento

Agendamentos: Campo de data final para campanhas de SMS e WhatsApp passa a ser de preenchimento opcional

Os Agendamentos (Administração > Atendimentos > Agendamentos) configurados para os canais de SMS WhatsApp passam a ter o campo de data final (“Fim”) da campanha como opcional.  

Anteriormente, ao cadastrar uma nova campanha para esses canais, era obrigatório informar uma data final para o seu encerramento. 

Com a melhoria, é possível manter o Agendamento ativo com recorrência e sem, necessariamente, uma data limite para finalizar os disparos.

LimeSales: Corrigido erro de execução de JavaScript

As telas de Clientes (Administração > Configurações Gerais > Clientes) e Contas (LimeSales > Contas) passaram por melhorias para corrigir a mensagem de erro sobre execução de JavaScript que era exibida ao acessá-las

A partir de agora, a mensagem de erro não será mais exibida quando o usuário acessar qualquer uma das telas. 

Estatísticas: Atualizações estão sendo pausadas normalmente na tela de Monitoramento

O recurso de Pausar atualização da funcionalidade Visualizar Chat, na tela de Monitoramento (Estatísticas > Monitoramento), foi ajustado para que todas as interações possam ser pausadas e visualizadas. 

A correção resolve o cenário em que, após clicar em Pausar atualização, as mensagens não paravam e continuavam sendo atualizadas, dificultando o acompanhamento das interações.  

Base de conhecimento: Pesquisas realizadas estão retornando resultados corretamente

O recurso de pesquisa da Base de conhecimento, utilizado na aba da tela do Atendente (Menu Principal > Atendente) e no ícone do menu do topo da tela (), recebeu melhorias para retornar corretamente os dados buscados. 

O ajuste resolve o cenário em que ao pesquisar diferentes termos, os artigos cadastrados retornavam com o mesmo resultado. 

Foram realizadas melhorias na forma de consulta da informação, acontecendo de forma mais ágil e assíncrona, em que uma nova busca é executada a cada novo caractere digitado. 

Atendimentos: Dados do campo de “Classificação do Tipo de Ocorrência” estão sendo exibidos normalmente após o registro de Protocolos

Os dados do campo Classificação do Tipo de Ocorrência, configurados em (Administração > Configurações Gerais > Tipo de Ocorrência), estão sendo salvos normalmente após o registro de um Protocolo de Atendimento. 

Foi corrigido o cenário em que, após registrar o Protocolo de Atendimento e visualizar a aba “Solução”, a informação de Classificação do Tipo de Ocorrência não era carregada na tela. 

Atendente: Usuário será notificado quando o cliente não possuir telefone celular cadastrado para envio de HSM via WhatsApp

O fluxo de envio de mensagens ativas pelo canal de WhatsApp através dos templates de HSM (Highly Structured Message) passou por melhorias para exibir uma mensagem de erro informando ao usuário que o cliente não possui telefone celular cadastrado.

Os ajustes resolvem o cenário em que ao incluir um comentário a partir de um template de HSM, sem um telefone cadastrado, era exibida uma mensagem de erro sem especificar o motivo da falha. 

Template de E-mail: Campo "Descrição" da tela de cadastro está sendo atualizado após alterações

O cadastro do recurso de Template de E-mail (Administração > Configurações Gerais > Template de E-mail) passou por melhorias para salvar corretamente a edição das informações do campo “Descrição” na etapa de configuração.  

A correção resolve o cenário em que ao alterar o texto desse campo e retornar a mensagem de sucesso, as informações não eram atualizadas.  

]]>
https://hml-docs.citrus.cx/docs/releases-notes/release-notes/versao-2-61-0-8709/feed/ 0
Versão 2.58.0 https://hml-docs.citrus.cx/docs/releases-notes/release-notes/versao-2-58-0-8703/ https://hml-docs.citrus.cx/docs/releases-notes/release-notes/versao-2-58-0-8703/#respond Wed, 21 Jun 2023 12:20:45 +0000 https://docs.citrus.cx/docs/releases-notes-2/versao-2-58-0/

Configurações Gerais: Plataforma passa a permitir a habilitação de Termo de Uso

A partir desta versão será possível habilitar a utilização de um Termo de Uso da plataforma, que será exibido para o usuário uma única vez após realizar o login de acesso.

Para habilitar o Termo de Uso, basta acessar a tela de Configurações Gerais (Administração > Configurações Gerais > Geral) e, no rodapé da página, marcar a flag “Habilitar aceite de termo de uso da plataforma” e, em seguida, utilizar o editor de texto para criação e edição do Termo de Uso. 

Para mais informações acesse Como personalizar a identidade do Citrus.cx

 

IMPORTANTE: Para realizar esta configuração, é necessário ter o acesso ao submenu Configurações Gerais (Administração > Configurações Gerais) liberado no Perfil de acesso do usuário 

Saiba mais em Como Configurar Perfis de Acesso.

Base de conhecimento: Usuário será notificado quando um item for movido e deixado fora da hierarquia

Na Base de Conhecimento, podem ser criadas várias subcategorias e artigos dentro de uma categoria. Também é possível arrastar os itens para descer ou subir um nível na hierarquia. 

Foi identificado um cenário de erro em que, ao arrastar os itens e soltar por engano fora da hierarquia, o item não era mais exibido na tela.

Feitas as correções, caso um item seja solto fora de uma hierarquia, será exibida a mensagem: Atenção: Esse artigo só poder ser movido entre pastas. Por favor, tente novamente.

Configurações Gerais: Alguns campos da plataforma não poderão ser preenchidos com tags HTML e/ou JavaScript

Os campos de “Nome” (do cliente) da tela de cadastro de Atendimentos (LemonDesk > Atendimentos), de “Modificar dados” na tela de cadastro do Usário (Dados do Usuário > Meus Dados) e de “Login” (na tela de acesso à plataforma) não poderão mais ser preenchidos com tags em linguagem de programação.

Foi corrigido o cenário em que esses campos aceitavam tags em linguagens como HTML e JavaScript, o que podia ocasionar a quebra de tela.

LemonDesk: E-mails de Pré-atendimentos com anexos estão sendo convertidos em Atendimentos

Atualmente, existe uma configuração opcional para que todos os Pré-atendimentos recebidos através das caixas de e-mails configuradas, já sejam convertidos automaticamente na listagem geral de Atendimentos (LemonDesk > Atendimentos).

Foi verificado um cenário onde não estavam sendo convertidos os e-mails que possuíssem anexos.

Feitas as correções necessárias, todos os e-mails recebidos com anexos passam a ser convertidos em Protocolos de Atendimentos.  

Saiba mais em Como configurar a Conversão Automática no canal de E-mail e Distribuição Automática de Atendimentos

Conteúdo de e-mails de respostas de clientes estão sendo exibidos corretamente no Histórico dos Protocolos de Atendimentos

Nos processos de Atendimentos, é possível receber e-mails fornecendo informações sobre o andamento do Protocolo ou solicitando informações.

Quando o cliente responde um e-mail automático, a sua resposta é enviada para o Histórico do Protocolo no submenu Atendimentos (LemonDesk > Atendimentos). 

Verificou-se um cenário em que, quando o cliente respondia um e-mail automático, essas informações não eram exibidas na tela de cadastro do Protocolo de Atendimento, apenas a data e hora de resposta, ficando o conteúdo dessa resposta suprimido. 

Realizadas as correções, as respostas enviadas pelo cliente por e-mail passam a ser exibidas normalmente na tela de cadastro do Protocolo de Atendimento. 

Campos extras do formulário de Atendimentos convertidos automaticamente estão sendo exibidos

Na tela de cadastro de Atendimentos (LemonDesk > Atendimentos), estão sendo exibidos campos extras em todos os Protocolos de Atendimentos gerados pela conversão automática de e-mails.

Foi resolvido o cenário em que esses campos não eram mostrados para alguns usuários ao abrir um Protocolo gerado pela conversão automática.

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