Protocolo – Citrus.cx https://hml-docs.citrus.cx Base de Conhecimento Thu, 23 Oct 2025 13:28:16 +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 Protocolo – Citrus.cx https://hml-docs.citrus.cx 32 32 Versão 2.109.4 https://hml-docs.citrus.cx/docs/releases-notes/release-notes/versoes-2-109-1-a-2-109-0/versao-2-109-4/ https://hml-docs.citrus.cx/docs/releases-notes/release-notes/versoes-2-109-1-a-2-109-0/versao-2-109-4/#respond Tue, 29 Oct 2024 22:53:20 +0000 https://docs.citrus.cx/docs/releases-notes/release-notes/versoes-2-109-1-a-2-109-0/versao-2-109-4-3/

LemonDesk: Visualização de Atendimentos de voz sem a gravação de áudio está funcionando como esperado

Ao acessar o menu LemonDesk > Atendimentos e clicar no número do Protocolo de um atendimento feito pelo canal de voz, ele será aberto e exibido como esperado mesmo que não exista o áudio no banco de dados. 

Foi resolvido o cenário em que, ao não localizar a gravação da chamada de voz, o atendimento não abria e apenas era mostrado o alerta “Não foi possível recuperar o áudio com PABX: {0}”. 

A partir deste ajuste realizado a abertura do atendimento ocorrerá normalmente e, caso a reprodução do áudio falhe (gravação não seja encontrada), o alerta “Não foi possível recuperar o áudio” será apresentado no topo direito da tela. 

Monitoramento: Normalizada a exibição de clientes que aguardam por atendimento

Clientes que aguardam por atendimento estão sendo apresentados na tela de Monitoramento com o status “Na fila”. A falha que fazia clientes em espera deixarem de ser exibidos foi resolvida. 

Com a correção, esses clientes podem ser identificados normalmente na coluna “Status” de Sessões. 

Além disso, ajuste foi feito para quando o atendimento for pelo WhatsApp, a coluna “Clientes” (seção Atendentes) mostrar o código que identifica o cliente ou o número de WhatsApp ao invés de seu ID (Identificador) em Banco de Dados. 

Outra mudança aplicada foi a remoção da coluna “Código” que ficava em Sessões. 

A partir das melhorias a usabilidade e funcionamento da tela devem acontecer sem comportamentos inesperados. 

Cliente em espera “Na Fila” por atendimento.
Cliente atendido pelo WhatsApp é identificado pelo código de cliente ou número usado no aplicativo.
Confira também a Release notes da versão 2.109.0
]]>
https://hml-docs.citrus.cx/docs/releases-notes/release-notes/versoes-2-109-1-a-2-109-0/versao-2-109-4/feed/ 0
Versão 2.91.0 https://hml-docs.citrus.cx/docs/releases-notes/release-notes/versoes-2-91-0-e-2-91-1/versao-2-91-0/ https://hml-docs.citrus.cx/docs/releases-notes/release-notes/versoes-2-91-0-e-2-91-1/versao-2-91-0/#respond Mon, 04 Mar 2024 20:56:36 +0000 https://docs.citrus.cx/docs/releases-notes/release-notes/versoes-2-91-0-e-2-91-1/versao-2-91-0/

Perfil de acesso: Nova permissão "Visualizar campo cliente especial"

Com a nova permissão de acesso habilitada o Atendente pode visualizar o campo Cliente Especial no momento de registro dos Atendimentos na Tela do Atendente e no acesso a Atendimentos pelo menu (LemonDesk > Atendimentos > (selecionar na listagem) > Atendimentos).

O Administrador na tela Perfil (Administração > Usuários > Perfil > (selecionar o Perfil Atendente) > aba Permissões > bloco LemonDesk) pode habilitar a flag “Visualizar campo cliente especial”. 

Na tela Configurações de atendimento (Administração > LemonDesk > Configurações de atendimento) preencha no bloco Configuração label dos campos do cliente no atendimento o campo “Vulnerabilidades” com a nomenclatura “Cliente Especial”. 

Assim, para Clientes que possuem em seu cadastro alguma vulnerabilidade associada, a plataforma exibe a lista com estas opções para seleção pelo Atendente.

]]>
https://hml-docs.citrus.cx/docs/releases-notes/release-notes/versoes-2-91-0-e-2-91-1/versao-2-91-0/feed/ 0
Versão 2.90.1 https://hml-docs.citrus.cx/docs/releases-notes/release-notes/versoes-2-90-0-e-2-90-1/versao-2-90-1/ https://hml-docs.citrus.cx/docs/releases-notes/release-notes/versoes-2-90-0-e-2-90-1/versao-2-90-1/#respond Wed, 28 Feb 2024 17:51:11 +0000 https://docs.citrus.cx/docs/releases-notes/release-notes/versoes-2-90-0-e-2-90-1/versao-2-90-1/

Tela do Atendente: Erro na entrega de notificações dos cards

Foi corrigido o cenário em que o Atendente logado nos canais de atendimento deixava de receber na Tela do Atendente as notificações de cards ao abrir uma nova página pelo menu Área de Trabalho.

Isso acontecia porque a cada nova página da plataforma que fosse aberta, o websocket de referência desse Atendente era sobrescrito. 

Com o ajuste as notificações dos cards estão sendo entregues corretamente na Tela do Atendente, independente da quantidade de páginas abertas no navegador.

]]>
https://hml-docs.citrus.cx/docs/releases-notes/release-notes/versoes-2-90-0-e-2-90-1/versao-2-90-1/feed/ 0
Versão 2.90.0 https://hml-docs.citrus.cx/docs/releases-notes/release-notes/versoes-2-90-0-e-2-90-1/versao-2-90-0/ https://hml-docs.citrus.cx/docs/releases-notes/release-notes/versoes-2-90-0-e-2-90-1/versao-2-90-0/#respond Tue, 27 Feb 2024 17:50:58 +0000 https://docs.citrus.cx/docs/releases-notes/release-notes/versoes-2-90-0-e-2-90-1/versao-2-90-0/

Atendimentos: Conversão automática dos Formulários Web em Atendimentos

A plataforma passa a converter automaticamente em Atendimentos os Formulários Web antes recebidos apenas no Pré-atendimento. Esta nova funcionalidade aumenta a produtividade com a redução de tempo no registro dos Atendimentos que já são convertidos e distribuídos aos Atendentes. 

Na tela Formulário Web (Administração > LemonDesk > Formulário web) o Administrador/Supervisor pode habilitar os 03 (três) recursos opcionais: 

  • Habilitar conversão automática do Formulário Web e atendimento.
    * Ao habilitar esta opção a plataforma converte automaticamente os Formulários Web da tela Pré-atendimentos para tela Atendimentos.

  • Habilitar a inclusão das Configurações de Cadastro do Cliente no formulário.
     *Ao habilitar esta opção os campos Tipo de Cliente e Região são adicionados ao corpo do Formulário Web para preenchimento do Cliente.
 
  • Habilitar distribuição automática do responsável pelo atendimento. 

     * Ao marcar esta opção a plataforma distribui automaticamente os Formulários Web convertidos em Atendimentos pelos Atendentes do Setor ou do Grupo de Solução. 

Processos: Falha de duplicação dos protocolos com Fluxo de Etapas

Os registros da tela Processos (Processos > botão +Novo > Processos) estavam sendo exibidos de forma duplicada quando o usuário com permissões habilitadas para este módulo Processos clicava no botão “Salvar e continuar” para registrar um protocolo.

O cenário acontecia com Processos que tinham Fluxo de Etapas configurados. Eram duplicadas as Etapas e os registros do protocolo.  

Com a adição de um load na tela de criação dos Processos, todos os elementos da tela são carregados na execução de salvar um protocolo. Assim a plataforma exibe corretamente apenas um 01 (um) registro de protocolo sem duplicar também as Etapas.

]]>
https://hml-docs.citrus.cx/docs/releases-notes/release-notes/versoes-2-90-0-e-2-90-1/versao-2-90-0/feed/ 0
Versão 2.89.7 https://hml-docs.citrus.cx/docs/releases-notes/release-notes/versoes-2-89-0-a-2-89-4/versao-2-89-7/ https://hml-docs.citrus.cx/docs/releases-notes/release-notes/versoes-2-89-0-a-2-89-4/versao-2-89-7/#respond Thu, 22 Feb 2024 20:42:00 +0000 https://docs.citrus.cx/docs/releases-notes/release-notes/versoes-2-89-0-a-2-89-4/versao-2-89-7/

Agendamentos: Falha no disparo de Campanhas com templates WhatsApp HSM

Corrigida a falha em disparos de campanhas que possuem template WhatsApp HSM nas configurações de Agendamentos do Tipo: 

  • Campanha de WhatsApp 
  • Campanha Envio de pesquisa satisfação 

Nos cenários os valores configurados nas tags do template HSM não eram substituídos corretamente e a plataforma exibia no Log de execução da campanha a seguinte mensagem: “Quantidade processada: 0 registro(s), Quantidade processada erro: X registro(s)”. 

Com o ajuste nos layouts de CSV e Webservice, foram adicionados campos e colunas referentes às possíveis tags a serem configuradas e os disparos agora ocorrem sem erros. 

DICA

A tag “Protocolo” pode ser utilizada no template HSM para substituir o valor do número de protocolo de atendimento pelo link da pesquisa de satisfação em campanhas do Tipo “Envio de pesquisa satisfação”. 

Estatísticas: Falha ao gerar o arquivo do relatório 

Ao clicar no botão Gerar relatório estava sendo exibida na tela Relatórios a seguinte mensagem: “Ocorreu uma falha ao gerar o arquivo do relatório, entre em contato com o administrador do sistema”. 

 A plataforma passa a gerar corretamente arquivos de relatórios nos formatos: PDF, HTML, CSV e XLSX, após o ajuste na regra do nome colunas que estava com valor nulo, ocorrendo assim o erro no processamento de documento dos relatórios. 

]]>
https://hml-docs.citrus.cx/docs/releases-notes/release-notes/versoes-2-89-0-a-2-89-4/versao-2-89-7/feed/ 0
Versão 2.87.7 https://hml-docs.citrus.cx/docs/releases-notes/release-notes/versoes-2-87-2-a-2-87-0-28234/versao-2-87-7/ https://hml-docs.citrus.cx/docs/releases-notes/release-notes/versoes-2-87-2-a-2-87-0-28234/versao-2-87-7/#respond Mon, 29 Jan 2024 19:21:13 +0000 https://docs.citrus.cx/docs/releases-notes/versoes-2-87-2-a-2-87-0-28234/versao-2-87-7/

Padronização de atendimento: Corrigida falha na ordenação dos itens do campo na tela de registro de Atendimentos

O campo “Padronização de atendimento” está listando suas opções para seleção conforme o esperado na tela de registro de Atendimentos, seguindo a ordem alfabética.

Foi corrigido o cenário em que, ao aceitar um card na tela do Atendente (menu lateral > Atendente) ou abrir um chamado manualmente (menu LemonDesk > Atendimentos > +Novo), e clicar no campo “Padronização de atendimento”, os itens listados não eram exibidos em ordem alfabética, o que dificultava a sua localização.

Na resolução, foi realizada a melhoria para ordenar as padronizações disponíveis no campo pelo nome. Com isso, a listagem passa a ser feita por ordem alfabética.

As Padronizações de atendimento podem ser cadastradas por meio do menu Administração > LemonDesk > Padronização de atendimento.

Monitoramento: Código do cliente está sendo exibido corretamente na tabela Sessões da aba Detalhes

A tabela de Sessões da aba Detalhes na tela de Monitoramento (menu Estatísticas > Monitoramento > (aba) Detalhes) está apresentando apenas números de telefone para contato nos campos da coluna “Código”.

Foi verificado que alguns itens da listagem de Sessões do Monitoramento estavam apresentando um ID no campo da coluna “Código”, onde deveria constar o número de contato do cliente em atendimento. 

Assim, foram realizados ajustes para que os campos de “Código” das sessões apresentem o mesmo padrão de dados. Dessa forma, quando o Supervisor acessar a tela de Monitoramento, visualizará sempre um número de contato nessa coluna, seja nos atendimentos realizados pelo Bot ou por Atendentes humanos. 

Atendimentos: Anexos de Protocolos de atendimentos de WhatsApp estão sendo visualizados normalmente na aba Histórico do atendimento

Os arquivos de imagens anexados a Protocolos de atendimentos de WhatsApp, acessados pelo menu LemonDesk > Atendimentos, estão sendo visualizados normalmente na aba Histórico do atendimento.

Foi corrigido o cenário observado em alguns atendimentos recebidos pelo canal do WhatsApp em que, caso o cliente encaminhasse arquivos de imagens durante as interações, ainda que esses arquivos fossem anexados ao atendimento, não podiam ser visualizados no Histórico do atendimento do respectivo Protocolo. 

Na resolução, foi feito um ajuste na exibição do arquivo de imagem na aba Histórico do atendimento, e agora, ao acessá-la em um Protocolo de atendimento de WhatsApp, o usuário poderá clicar no ícone de Visualizar e as imagens serão exibidas normalmente. 

Monitoria de qualidade: Notas de avaliações não estão apresentando valores negativos

O recurso de Monitoria de qualidade recebeu ajustes para resolver o cenário em que, caso o Supervisor avaliasse um Atendente pontuando severamente casos graves, ao final da avaliação, a sua nota poderia constar como um valor negativo (menor que zero). 

Na correção, foi realizado ajuste para que, no caso de avaliações com oportunidades de melhoria, a nota do atendimento do usuário não fique negativa, mas com o valor zerado, sendo a nota mínima de 0% (zero porcento). 

Com isso, ao acessar a aba Monitoria de qualidade de um Protocolo de atendimento (menu LemonDesk > Atendimentos > (selecionar) Protocolo > (aba) Monitoria de qualidade), o Supervisor não irá visualizar notas com valores negativos.

Tags estão sendo substituídas corretamente nos e-mails de notificação

Os campos das tags de “Atendente”, “Monitor” e “Data de avaliação” estão sendo preenchidos corretamente no conteúdo dos e-mails de notificação encaminhados para Atendentes, depois de receberem do Supervisor avaliações da Monitoria de qualidade.

Foi resolvido o cenário em que as tags ${ATENDENTE}, ${MONITOR} e ${DATA_AVALIACAO} não estavam sendo substituídas pelos respectivos dados no corpo do texto da notificação, mesmo estando devidamente configuradas no template.

Feito isso, quando o Supervisor acessar um Protocolo de atendimento (menu LemonDesk > Atendimentos > (selecionar) Protocolo), abrir a aba Monitoria de qualidade e avaliar um Atendente, após marcar a caixa de seleção ao lado do nome do Atendente avaliado, o respectivo e-mail de notificação será enviado com todos os campos preenchidos e tags substituídas corretamente.

]]>
https://hml-docs.citrus.cx/docs/releases-notes/release-notes/versoes-2-87-2-a-2-87-0-28234/versao-2-87-7/feed/ 0
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
Consultar status de Atendimentos via API https://hml-docs.citrus.cx/docs/guia-do-administrador/administrador-configuracoes-10273/consultar-status-de-atendimentos-via-api-10825/ https://hml-docs.citrus.cx/docs/guia-do-administrador/administrador-configuracoes-10273/consultar-status-de-atendimentos-via-api-10825/#respond Mon, 13 Nov 2023 19:24:22 +0000 https://docs.citrus.cx/docs/get-started/api-10817/consultar-status-de-atendimentos-via-api/

Confira a documentação de uso da API para consultar o status de um protocolo de atendimento.

Pré-requisitos

Para utilizar esta API existe a seguinte regra:

  • O usuário precisa ter em seu perfil a permissão Consultar status de atendimento via api.
    Para liberar o acesso basta acessar:  Administração > Usuários > Perfil, escolher o perfil desejado e então habilitar a permissão Consultar status de atendimento via API.

Autenticação de usuário

Para autenticar um usuário na plataforma, utilize o seguinte endpoint: /api/usuario/login 

No retorno com sucesso para o método post será exibido uma mensagem contendo o token de acesso aos demais endpoints dessa API.

Parâmetros no JSON Descrição
login
Credencial de acesso do usuário na plataforma com permissão para alterar status de atendimentos
senha
Credencial de autenticação do usuário na plataforma com permissão para alterar status de atendimentos

Body

{

“login”: “user.api”,
“senha”: “1234”

}

O retorno da chamada para o endpoint poderá ser um dos status a seguir:

 

SUCESSO

  • Access token: código do token

 

ERRO

  • Usuário não encontrado
  • Senha inválida
  • Houve um problema para gerar um token
  • Este campo é obrigatório – login
  • Este campo é obrigatório senha
  • Access denied (Usuário sem permissão)
  • Token is missing (Request sem token)
  • JWT expired at ano-mes-data-hora Current Time: ano-mes-data-hora, a difference of number milliseconds. Allowed clock skew: number miliseconds. (Token expirado)
  • *JWT signature does not match locally computed signature. JWT validity cannot be asserted and should not be trusted. (Token com falha)

Consultar status de um Protocolo do Atendimento

Para consultar status de um protocolo de atendimento na plataforma, utilize o seguinte endpoint: api/atendimentos/status/numerodoprotocolo

No endpoint numerodoprotocolo deve ser informado o número do protocolo do Citrus para realizar a consulta. 

Este endpoint poderá ser usado para consultar protocolos de atendimento com os seguintes status:

  • Aberto
  • Em atendimento
  • Cancelado
  • Improcedente
  • Finalizado
  • Aguardando retorno

Exemplo de Requisição

Exemplo de Retorno


“protocolo”: “202301024000001”,
“status”: “Finalizado”,
}

O retorno da chamada para o endpoint poderá ser um dos status a seguir:

 

SUCESSO

  • [200] Message: Atendimento atualizado com sucesso

 

ERRO

  • [404] Atendimento não encontrado
  • [403] Access denied
]]>
https://hml-docs.citrus.cx/docs/guia-do-administrador/administrador-configuracoes-10273/consultar-status-de-atendimentos-via-api-10825/feed/ 0
Alterar status de Atendimentos via API https://hml-docs.citrus.cx/docs/guia-do-administrador/administrador-configuracoes-10273/alterar-status-de-atendimentos-via-api-10819/ https://hml-docs.citrus.cx/docs/guia-do-administrador/administrador-configuracoes-10273/alterar-status-de-atendimentos-via-api-10819/#respond Mon, 13 Nov 2023 17:53:05 +0000 https://docs.citrus.cx/docs/get-started/api-10817/alterar-status-de-atendimentos-via-api/

Confira a documentação de uso da API para alterar um Status de Atendimento.

Pré-requisitos

Para utilizar esta API existem as seguintes regras:

  • O usuário precisa ter em seu perfil a permissão Alterar status de atendimento via api.
    Para liberar o acesso basta acessar:  Administração > Usuários > Perfil, escolher o perfil desejado e então habilitar a permissão Alterar status de atendimento via API.
  • Para que seja possível visualizar essa permissão de acesso, um usuário Administrador (com permissões root) deve habilitá-la para os demais usuários na hierarquia.
  • É preciso possuir motivos cadastrados na tela Motivo (Administração > Configurações Gerais > Motivo)

Autenticação de usuário

Para autenticar um usuário na plataforma, utilize o seguinte endpoint: /api/usuario/login 

No retorno com sucesso para o método post será exibido uma mensagem contendo o token de acesso aos demais endpoints dessa API.

Parâmetros no JSON Descrição
login
Credencial de acesso do usuário na plataforma com permissão para alterar status de atendimentos
senha
Credencial de autenticação do usuário na plataforma com permissão para alterar status de atendimentos

Body

{

“login”: “user.api”,
“senha”: “1234”

}

O retorno da chamada para o endpoint poderá ser um dos status a seguir:

SUCESSO

  • Access token: código do token

ERRO

  • Usuário não encontrado
  • Senha inválida
  • Houve um problema para gerar um token
  • Este campo é obrigatório – login
  • Este campo é obrigatório senha
  • Acess denied (Usuário sem permissão)
  • Token is missing (Request sem token)
  • JWT expired at ano-mes-data-hora Current Time: ano-mes-data-hora, a difference of number milliseconds. Allowed clock skew: number miliseconds. (Token expirado)
  • *JWT signature does not match locally computed signature. JWT validity cannot be asserted and should not be trusted. (Token com falha)

Alterar status de um Protocolo de Atendimento

Para alterar status de um protocolo de atendimento na plataforma, utilize o seguinte endpoint: api/atendimentos/status

 

Este endpoint poderá ser usado para alterar status de um atendimento para:

  • Aberto
  • Em atendimento
  • Cancelado
  • Improcedente
  • Finalizado

 

Para os status Cancelado, Improcedente e para reabrir um atendimento que já estava com o status Finalizado deve ser enviado o parâmetro de Motivo para realizar a ação.

 

Os Motivos são utilizados para justificar determinadas ações executadas pelos usuários na plataforma, como alterações, exclusões e restrições.

Parâmetros no JSON Descrição
protocolo
Informe o número do protocolo do atendimento no Citrus que terá o status alterado
status
Informe o nome do status que deve alterado
motivoStatus
Informe o nome do motivo cadastrado na plataforma para os status “Cancelado”, “Improcedente” e a reabertura de um atendimento com o status “Finalizado”

Body

{

“protocolo”: “20221104000001”,
“status”: “Finalizado”,
“motivoStatus:”Atendimento já finalizado”

}

O retorno da chamada para o endpoint poderá ser um dos status a seguir:

 

SUCESSO

  • [200] Message: Atendimento atualizado com sucesso

 

ERRO

  • [404] Atendimento não encontrado
  • [404] Status não encontrado
  • [400] motivoStatus – esse campo é obrigatório

Incluir comentários nos Protocolos de Atendimento

A partir da versão 2.63.0 será possível adicionar comentários nos protocolos durante a atualização de status de atendimento. Devem ser enviados os parâmetros de comentario e visivelCliente para realizar a ação.

O comentário será utilizado para inserir as informações desejadas pelo usuário e o visivelCliente é necessário para informar se este é visível para o cliente.

Parâmetros no JSON Descrição
protocolo
Informe o número do protocolo do atendimento no Citrus que terá o status alterado
status
Informe o nome do status que deve alterado
motivoStatus
Informe o nome do motivo cadastrado na plataforma para os status “Cancelado”, “Improcedente” e a reabertura de um atendimento com o status “Finalizado”
comentario
Informe o comentário que será adicionado ao protocolo de atendimento
visivelCliente
Informe com “True” ou “False” se o comentário estará visível para o cliente

Body

{

“protocolo”: “20221104000001”,
“status”: “Finalizado”,
“motivoStatus:” “
“comentario:”Comentário de atendimento”
“visivelCliente:”true”

}

O retorno da chamada para o endpoint poderá ser um dos status a seguir:

 

SUCESSO

  • [200] Message: Atendimento atualizado com sucesso

 

ERRO

  • [404] Atendimento não encontrado
  • [404] Status não encontrado
  • [400] motivoStatus – esse campo é obrigatório
]]>
https://hml-docs.citrus.cx/docs/guia-do-administrador/administrador-configuracoes-10273/alterar-status-de-atendimentos-via-api-10819/feed/ 0
Destinatários de E-mails https://hml-docs.citrus.cx/docs/guia-do-administrador/configuracoes-de-atendimentos-gestao-de-atendimentos-10358/destinatarios-de-e-mails-10693/ https://hml-docs.citrus.cx/docs/guia-do-administrador/configuracoes-de-atendimentos-gestao-de-atendimentos-10358/destinatarios-de-e-mails-10693/#respond Fri, 10 Nov 2023 17:51:25 +0000 https://docs.citrus.cx/docs/guia-do-usuario/administrador-configuracoes-10273/configuracoes-de-atendimentos-gestao-de-atendimentos-10358/destinatarios-de-e-mails/

Os Destinatários de E-mails são contatos cadastrados na plataforma que estão associados ao campo “E-mail” da aba “Comentários” da tela de cadastro de Atendimentos (LemonDesk > Atendimentos).

Assim, quando a caixa de seleção “Enviar Cópia” na aba “Comentários” estiver habilitada, será possível selecionar, no campo multi-select “E-mail”, destinatários de e-mails já cadastrados. O usuário poderá, ainda, inserir um novo destinatário manualmente no referido campo, sendo esses dados automaticamente registrados na tela de Destinatários de E-mails.

 

A tela de Destinatários de E-mails pode ser acessada pelo menu Administração > Atendimentos > Destinatários de E-mails. Nela, poderão ser visualizados os destinatários de e-mails já cadastrados, listados e organizados nas colunas “Nome” e “E-mail”.

 

Na parte superior direita da tela, estão os botões:

  • +Novo: Para ir até a tela de cadastro, onde será possível registrar um novo destinatário de e-mail.
  • Excluir: Para remover um cadastro da lista após marcar a caixa de seleção ao lado do seu Nome.
  • Filtro: Para realizar consulta utilizando os campos “Nome” e/ou “E-mail” e clicando no botão Pesquisar.

Pré-requisitos

Para que seja possível fazer uso da tela de Destinatários de E-mails, é necessário que os seguintes requisitos sejam atendidos:

  • Ter perfil de usuário Supervisor ou Administrador;
  • Ter permissões para Destinatários de E-mails habilitadas no menu Administração > Usuários > Perfil > (aba) Atendimento.

Permissões

Para que a funcionalidade de Destinatários de E-mails fique acessível para outros usuários da plataforma, ela precisa ser habilitada para uso por um usuário com permissão para editar Perfil.

 

Para conceder pleno acesso à funcionalidade, o usuário Administrador deve: 

 

1. Acessar o menu Administração.

 

2. Clicar no submenu Usuários.

 

3. Clicar no link da tela de Perfil.

*A tela de Perfil será aberta e listará todos os tipos de perfis de usuário cadastrados na plataforma.

 

4. Criar um perfil (+Novo) ou editar um perfil já existente clicando no seu Nome na lista.

*A tela de cadastro de Perfil será aberta e permitirá a habilitação e desabilitação de diferentes permissões.

 

5. Localizar a aba “Atendimento” e habilitar as seguintes permissões:

  • Listar destinatários de e-mails
  • Criar destinatários de e-mails
  • Editar destinatários de e-mails
  • Excluir destinatários de e-mails

Criar Destinatários de E-mails

O cadastro de novos destinatários de e-mails é feito pela tela de Destinatários de E-mails, como a seguir:

 

1. Acesse o menu Administração.

 

2. Clique no submenu Atendimentos.

 

3. Clique no link da tela de Destinatários de E-mails.

*A tela de Destinatários de E-mails será aberta e listará todos os destinatários de e-mails já cadastrados.

 

4. Pressione o botão +Novo no topo direito da tela para abrir a tela de cadastro de Destinatários de E-mails.

 

5. Preencha os campos obrigatórios com o “Nome” do destinatário e o seu endereço de “E-mail” correspondente.

 

6. Clique em Salvar no topo direito da tela para finalizar o cadastro do destinatário de e-mails ou, Cancelar se desistir de criar o cadastro.

Localizar Destinatários de E-mails

Siga o passo a passo para encontrar um cadastro na listagem de Destinatários de E-mails.

 

1. Acesse o menu Administração.

 

2. Clique no submenu Atendimentos.

 

3. Clique no link da tela de Destinatários de E-mails.

*A tela de Destinatários de E-mails será aberta e listará todos os destinatários de e-mails já cadastrados.

 

4. Clique no botão Filtro no topo direito da tela.

*Os campos de Filtro serão exibidos para realizar a pesquisa pelo Nome e/ou E-mail.

 

5. Preencha o(s) campo(s) que deseja utilizar para fazer a busca e clique em Pesquisar.

*Os resultados serão listados na tela logo em seguida.

Editar Destinatários de E-mails

Após criar, salvar e fechar o cadastro de um destinatário de e-mails, ao precisar editar informações contidas nele, será necessário abrir o formulário pela tela de Destinatários de E-mails como a seguir:

1. Acesse o menu Administração.

 

2. Clique no submenu Atendimentos.

 

3. Clique no link da tela de Destinatários de E-mails.

*A tela de Destinatários de E-mails será aberta e listará todos os destinatários de e-mails já cadastrados.

 

4. Localize o cadastro que deseja Editar.

 

5. Clique no Nome do destinatário de e-mails para abrir sua tela de cadastro.

 

6. Faça os ajustes desejados e pressione Salvar no topo direito da tela. Caso desista da ação, clique em Cancelar.

Excluir Destinatários de E-mails

Siga o passo a passo para remover cadastro(s) de destinatário(s) de e-mails:

 

1. Acesse o menu Administração.

 

2. Clique no submenu Atendimentos.

 

3. Clique no link da tela de Destinatários de E-mails.

*A tela de Destinatários de E-mails será aberta e listará todos os destinatários de e-mails já cadastrados.

 

4. Marque a caixa de seleção ao lado do Nome do(s) destinatário(s) de e-mails que deseja remover da lista.

 

5. Pressione o botão Excluir no topo direito da tela.

*O sistema questionará se realmente deseja excluir o cadastro.

 

6. Pressione Sim para confirmar ou, Não, caso desista de remover o cadastro.

IMPORTANTE: Após Excluir um cadastro de destinatário de e-mail não será possível recuperá-lo.

]]>
https://hml-docs.citrus.cx/docs/guia-do-administrador/configuracoes-de-atendimentos-gestao-de-atendimentos-10358/destinatarios-de-e-mails-10693/feed/ 0