Squad – Citrus.cx

Versão 2.86.10

Fabiana Nonjah — Fri, 15 Dec 2023 21:00:00 +0000

Atendente: Solução de Colaboração só poderá ser acessada por meio de seu respectivo botão

A integração com a Solução de Colaboração (Squad) recebeu melhorias e, a partir de agora, a sua aba só poderá ser acessada por meio do botão () localizado na parte superior da tela do Atendente (Menu Principal > Atendente).

Para padronizar a utilização do recurso, foi descontinuada a possibilidade de abertura automática da aba da Solução de Colaboração, com login simultâneo, após o usuário logar na plataforma Citrus.

Feitos os ajustes necessários, agora, a aba da Solução de Colaboração (Squad) só será aberta quando o seu botão for acionado na tela do Atendente.

IMPORTANTE! O botão da Solução de Colaboração só ficará visível se:

A integração com a Solução de Voz (Unity) estiver configurada e ativa na plataforma (menu Administração > Configurações Gerais > Integração com o UNITY)
O usuário logado na plataforma possuir um usuário da Solução de Voz (Unity) associado a ele (menu Administração > Usuários > Associação com usuário do Unity) com permissões de Chat habilitadas para o seu perfil.

Atendente: Datas da listagem de Agendamento de Callback estão sendo exibidas corretamente

As datas dos agendamentos listados na aba Agendamento de Callback da tela de cadastro de Atendimentos estão sendo exibidas corretamente.

Foi corrigido o cenário em que, ao criar um agendamento, sua data era exibida na listagem como sendo do mês anterior.

Agora, ao cadastrar um novo agendamento de chamada de retorno na tela de cadastro de um atendimento, a data configurada será exibida corretamente na respectiva listagem.

Versão 2.86.7

Fabiana Nonjah — Thu, 07 Dec 2023 21:00:00 +0000

Atendente: Botão da Solução de Colaboração será exibido na tela quando integração estiver habilitada

A barra do menu de ferramentas e ações, localizado na parte superior da tela do Atendente (Menu Principal > Atendente), passa a contar com um ícone para acesso direto à Solução de Colaboração ().

Com isso, ao clicar no ícone, a página inicial da Solução de Colaboração (Squad) será aberta automaticamente e autenticada para o Atendente logado, desde que a sua integração esteja habilitada na plataforma.

A melhoria facilita o acesso a esse recurso, que permite uma comunicação instantânea entre colaboradores em diferentes formatos (Chat, Voz e Vídeo), individual ou coletivamente.

IMPORTANTE! O botão só será exibido se:

A opção de integração com a Solução de Voz (Unity) estiver ativada na área de Administração.
O usuário logado na plataforma possuir as permissões de Chat habilitadas para o seu usuário associado na Solução de Voz (Unity).

Integração com Solução de Colaboração

Fabiana Nonjah — Mon, 27 Nov 2023 18:23:41 +0000

O recurso de integração entre a plataforma e a solução de Colaboração permite uma comunicação fácil e imediata entre os colaboradores de uma organização por meio de chats individuais ou em grupo, bem como de chamadas e conferências de voz e vídeo.

Essa funcionalidade possibilita, por exemplo, que Atendentes, no curso de um atendimento, consigam estabelecer rapidamente um canal de comunicação interno com especialistas, supervisores e colaboradores de diferentes Setores para solucionar as demandas de maneira mais rápida e eficiente, reduzindo o tempo de resposta ao cliente e de resolução das solicitações.

Pré-requisitos

Para que o usuário da plataforma tenha acesso a esse recurso, é necessário que:

Seu usuário na plataforma esteja associado a um usuário da solução de Voz por meio da Associação com usuário do Unity (menu Administração > Usuários > Associação com usuário do Unity);
O usuário associado da solução de Voz possua as permissões de Chat da solução de Colaboração habilitadas para o seu Perfil;
As Configurações de integração com o UNITY (menu Administração > Configurações Gerais > Integração com o UNITY) sejam previamente definidas na plataforma;
Sejam realizadas configurações específicas no back-end do Citrus.

Permissões

Para garantir o pleno funcionamento da integração, é preciso que o usuário do Unity (associado ao usuário do Citrus) tenha as seguintes permissões de Chat, relacionadas à solução de Colaboração, habilitadas para o seu Perfil:

Visualizar grupo de chat

Criar grupo de chat

Editar grupo de chat

Excluir grupo de chat

IMPORTANTE: A habilitação das permissões deverá ser feita, na plataforma Unity, por um usuário capaz de concedê-las por meio do menu Configurações > Perfis > (selecionar Perfil) > (campo) Definir permissões para o domínio > (selecionar Domínio) > (aba) Squad.

Acessar solução de Colaboração

Para acessar a solução de Colaboração a partir da integração com a plataforma, siga as instruções abaixo:

1. Acesse o URL da plataforma Citrus.cx utilizado pela sua empresa, preencha os campos “Usuário” e “Senha”, e clique no botão Entrar para realizar o login.

*O usuário visualizará a tela padrão de Atendimento e, logo em seguida, será aberta uma nova aba do navegador com a solução de Colaboração, onde ele será automaticamente logado com a mesma conta de usuário do Citrus.

*Caso realize logout na plataforma, o usuário também será deslogado na aba aberta da solução de Colaboração e redirecionado para a tela de login do Citrus.cx.

Configurar Integração

Para que o usuário da plataforma possa acessar a solução de Colaboração sem precisar passar pela página de login do Squad, é necessário que o Citrus salve no localstorage uma chave chamada authorization no seguinte formato:

{

“access_token”: “6f9e88795081f9711978b8f7e923fc41”,

“baseUrl”: “https://api-labchat.digivox.com.br/api/v1/”,

“email”: “junior@labchat.digivox.com.br”,

“expires_in” : 2592000,

“user_id” : “e8b451a9-3e88-1651-aece-890f2efcb92e”,

“user_name”: “Nivaldo Junior”

}

/rest/api/3/attachment/content/16435

O URL que o Citrus usa para autenticar os usuários no Unity devolverá o seguinte response:

{

“access_token”: “cd7060f1e1a93990eac56bc4658b634d”,

“user_id”: “27e04f15-7076-4568-ab8e-91beb206189f”,

“user_name”: “agente.artur”,

“expires_in”: 2592000

}

Com a chave authorization armazenada no localstorage, após o login, o Citrus abrirá uma nova aba com o path /squad-v2/#/.

Na prática, quando o usuário logar no Citrus através de um domíno https://dominio.citrus.cx/ deverá ser aberta uma nova aba com o URL https://dominio.citrus.cx/squad-v2/#/

DICA: É recomendável que esse caminho seja configurado no .conf do Citrus, em uma nova propriedade.

Quando o usuário efetuar o logout no Citrus, a chave authorization será excluída do localstorage, evitando que a sessão da solução de Colaboração permaneça habilitada mesmo com o usuário do Citrus deslogado da plataforma.

IMPORTANTE: Não será possível utilizar esse recurso em duas hipóteses:

Se o path da solução de Colaboração (Squad) não estiver configurado no .conf do Citrus;
Se nas configurações recebidas via autenticação com o Unity, a propriedade chat (chat != “YES”) não estiver habilitada para o usuário.

Exemplo

{

“video” : “YES”,

“chat” : “YES”,

“sipDomain” : “”,

“sipPort” : 5061,

“sipPortLocal” : 5061,

“sipUser” : “”,

“sipPw” : “”,

“transferProtocol” : “udp”,

“imageUrl” : “https://labchat.digivox.com.br/avatar_photo/08347370-742d-081e-fee2-d395307c63f8/08347370-742d-081e-fee2-d395307c63f8”,

“webrtcUrl” : “wss://labtest01.digivox.com.br:8082”,

“profileName” : “Usuário”,

“nickname” : “Eddie”,

“webrtcUrl2” : “wss://labchat.digivox.com.br:4443”,

“operator” : true,

“createCustomer” : false,

“sipRegistration” : “YES”,

“proxy” : “labproxy.digivox.com.br”,

“audioCodecOrder” : [“OPUS”, “PCMU”, “PCMA”, “G729”],

“videoCodecOrder” : [“VP8”, “H264”],

“stunServer” : “stun.l.google.com:19302”,

“usePublicIp” : “YES”,

“sendKeepAlives” : “YES”,

“keepalivePeriod” : 60000,

“xmppDomain” : “labchat.digivox.com.br”,

“xmppPort” : 5422,

“xmppUser” : “08347370-742d-081e-fee2-d395307c63f8”,

“xmppPw” : “XHcHL6DhYk”,

“sipTransportProtocol” : “tls”,

“serviceUrlEnabled” : false,

“serviceUrl” : “”,

“sipEnableSrtp” : “yes”,

“sipIgnoreTlsCertificate” : “YES”,

“xmppTransportProtocol” : “tcp”,

“configMap” : {

“squad_help_url” : “”,

“block_profile_edit” : “false”,

“block_followme_edit” : “false”,

“second_call” : “false”

“xmppIgnoreTlsCertificate” : “NO”,

“voicemail” : “”

}

Versão 2.81.0

Fabiana Nonjah — Wed, 25 Oct 2023 20:26:33 +0000

Soluções do Atendimento: Implementada tela para cadastro de Soluções globais aplicáveis a diferentes cenários de Atendimentos

O fluxo de Soluções dos atendimentos recebeu novos recursos e, agora, será possível cadastrar Soluções globais, aplicáveis a operações que possuam o mesmo fluxo de tratativas de resolução para diferentes tipos de demandas, por meio do menu Administração > Configurações Gerais > Soluções globais.

Anteriormente, era necessário realizar o cadastro de uma Solução para cada Ocorrência, individualmente, pelo menu Administração > Configurações Gerais > Tipo de ocorrência, mesmo se houvesse outras ocorrências com cenários semelhantes. Agora, com a nova funcionalidade, a mesma Solução global poderá ser cadastrada uma única vez e utilizada em várias ocorrências, otimizando o tempo de configurações e atualização dos processos de atendimento.

Após o cadastro de uma Solução global, com a configuração de suas respectivas etapas, ela ficará disponível para ser utilizada em qualquer Ocorrência durante o registro de um atendimento.

Dessa forma, ao registrar um novo atendimento (LemonDesk > Atendimentos > +Novo), o Atendente poderá, após preencher os campos obrigatórios de “Tipo de Ocorrência” e “Ocorrência”, selecionar alguma das soluções globais cadastradas e listadas no campo “Solução”.

Do mesmo modo, na tela de cadastro de Agendamentos (Administração > Atendimentos > Agendamentos), ao criar ou editar um agendamento de campanha de qualquer tipo, o usuário poderá fazer uso das Soluções Globais nos campos “Solução caso o agendamento seja enviado com sucesso” e “Solução caso o envio do agendamento falhe” da aba “Dados do atendimento”.

IMPORTANTE: Para ter acesso aos recursos da tela de Soluções Globais, o Administrador e/ou Supervisor deverá possuir as seguintes permissões habilitadas para o seu Perfil de usuário (menu Administração > Usuários > Perfil > (aba) Configurações gerais):

Listar soluções globais
Criar soluções globais
Editar soluções globais
Excluir soluções globais

*Tais permissões só serão necessárias para Administrador e/ou Supervisor que desejarem configurar soluções globais. As soluções globais já cadastradas serão exibidas para o Atendente no campo “Solução” da tela de registro de Atendimentos independentemente de permissões específicas.

Atendente: Implementada integração com solução de Colaboração

A plataforma Citrus.cx passa a ser integrada à solução de Colaboração, permitindo uma comunicação fácil e imediata entre colaboradores de uma organização por meio de chats individuais ou em grupo, bem como de chamadas e conferências de voz e vídeo.

Esse recurso possibilita, por exemplo, que Atendentes, no curso de um atendimento, consigam estabelecer rapidamente um canal de comunicação interno com especialistas, supervisores e colaboradores de diferentes setores para solucionar as demandas de maneira mais rápida e eficiente, reduzindo o tempo de resposta ao cliente e de resolução das solicitações.

Para acessar a solução de Colaboração, o usuário deverá:

1. Acessar o URL da plataforma (ex.: http://dominio.citrus.cx) acrescido do path da solução de Colaboração (ex.: http://dominio.citrus.cx/squad-v2/#/).

2. Depois disso, ele será direcionado à página de login do Citrus.cx e, após entrar, visualizará a tela padrão de Atendimento.

3. Logo em seguida, será aberta uma nova aba do navegador com a solução de Colaboração, onde ele será automaticamente logado com a mesma conta de usuário do Citrus.cx.

*Caso realize logout na plataforma, ele também será deslogado na aba aberta da solução de Colaboração e redirecionado para a tela de login do Citrus.cx.

IMPORTANTE: Para que o usuário do Citrus.cx tenha acesso a esse recurso, é necessário que sejam previamente definidas as Configurações de integração com o UNITY (Administração > Configurações Gerais > Integração com o UNITY) e que esse usuário possua Associação com usuário do Unity (Administração > Usuários > Associação com usuário do Unity).

ATENÇÃO O usuário associado do Unity deverá estar configurado com as permissões de chat da solução de Colaboração habilitadas no Unity (Configurações > Perfis > (perfil de) Agente > (selecionar Domínio) > (aba) Squad).

LemonDesk: Campos extras do atendimento e campos adicionais do cliente poderão ser impressos no Relatório de atendimento

A partir de agora, campos extras do atendimento e campos adicionais do cliente poderão ser incluídos no Relatório de atendimento impresso na tela de cadastro de Atendimentos (LemonDesk > Atendimentos > (editar) ou (botão) +Novo).

Caso essa configuração esteja habilitada, quando um usuário Atendente ou Supervisor acessar a tela de cadastro de um atendimento, pressionar o botão de seta para baixo () no topo direito da tela e clicar em Imprimir, será gerado um Relatório de atendimento no formato PDF, no qual, além dos campos que já são extraídos por padrão, serão exibidos os campos extras do atendimento e/ou os campos adicionais do cliente que estiverem habilitados.

DICA: Os mesmos campos extras serão exibidos no Relatório de atendimento gerado ao clicar em Exportar histórico de atendimentos. Contudo, enquanto a impressão limita-se aos dados de um atendimento individual, a exportação consegue abranger dados de um período maior, predeterminado pelo usuário.

Para implementação do novo recurso, na tela de cadastro de Grupo de campos extras (Administração > Configurações Gerais > Grupo de campos extra), foi adicionada uma nova opção na caixa de seleção “Imprimir campo no relatório” para que esses campos possam ser impressos nos relatórios gerados no Módulo LemonDesk.

IMPORTANTE: Mesmo que o recurso de impressão esteja ativado na tela de configuração do grupo de campos extras, se esse um campo extra estiver desabilitado, os dados correspondentes não serão impressos no documento gerado. Assim, para que os dados sejam efetivamente impressos, é necessário marcar “Habilitado”, além da opção “Imprimir campo no relatório” na aba “Campos Extras”, e pressionar o botão Salvar.

Do mesmo modo, na tela de configuração de Integração com cliente (Administração > Configurações Gerais > Integração com cliente) foi adicionada a opção “Imprimir campo no relatório” na aba “Campos adicionais” para habilitar a impressão desses campos no Relatório do atendimento, quando forem retornados valores na consulta do WebService externo.

Estatísticas: Registros de operações do Tipo “Alteração” estão sendo listados no Log de auditoria corretamente

A tela de Log de auditoria (Estatísticas > Log de auditoria) está listando as operações do Tipo “Alteração” conforme o esperado. Além disso, ao filtrar os itens da listagem, utilizando o parâmetro de Tipo de operação “Alteração”, todas as operações correspondentes estão sendo exibidas normalmente.

Foi corrigido o cenário no qual as operações de alteração realizadas na plataforma não estavam sendo visualizadas na listagem da tela de Log de auditoria.

Agora, feitas as correções necessárias, a tela de Log de auditoria passa a listar todos os registros de operações envolvendo Alteração e, quando for aplicado o Filtro “Alteração” no campo “Tipo de operação”, os resultados correspondentes serão exibidos normalmente.

Agendamentos WhatsApp: Novos arquivos CSV enviados na edição de Campanhas já criadas estão se sobrepondo ao arquivo enviado anteriormente

O envio de Arquivo CSV na edição de campanhas já configuradas na tela de Agendamentos (Administração > Atendimentos > Agendamentos) está ocorrendo normalmente e os dados da nova planilha estão sobrescrevendo o arquivo enviado anteriormente.

Foi corrigido o cenário no qual, ao editar uma campanha de WhatsApp, alterando o Arquivo CSV e enviando-o novamente com outros dados de contatos, a planilha que já havia sido utilizada na campanha não era subscrita e ocorria falha na execução.

Assim, ao editar uma campanha de WhatsApp criada a partir de um arquivo CSV, quando o usuário alterar o arquivo, inserindo outros dados de contatos, e selecioná-lo para importação, ele irá sobrescrever a planilha anterior, não ocorrendo falha de execução da campanha.

Agendamentos: Corrigido erro no campo “Data de nascimento” em campanhas geradas a partir de Webservice

O envio de Agendamentos (Administração > Atendimentos > Agendamentos) de campanhas a partir de um Webservice está ocorrendo conforme o esperado, independentemente do preenchimento ou não do campo “Data de nascimento”.

Foi corrigido o cenário em que ocorria uma falha no envio de agendamentos de campanhas de E-mail ou SMS, gerados a partir de um Webservice, quando o campo “Data de nascimento” não era alimentado durante a sua configuração.

Agora, quando o usuário criar um agendamento do Tipo “Envio de email” ou “Campanha de SMS”, e selecionar o Tipo de mailing “Webservice”, mesmo que o campo “Data de nascimento” não esteja preenchido, o agendamento será enviado normalmente.

LemonDesk: Chamadas estão sendo realizadas conforme o esperado

As chamadas externas realizadas por meio da tela de edição de um protocolo de Atendimento (LemonDesk > Atendimentos > (abrir) Protocolo) estão completando conforme o esperado.

Foi corrigido o cenário em que, quando o usuário tentava realizar uma ligação, ocorria erro e era exibida a mensagem “Falha ao tentar realizar a ligação”. Além disso, no log era informado que o usuário não possuía ramal associado. Isso ocorria porque, ao mudar de tela dentro da plataforma, o atendente era desconectado do canal de Voz no qual estava logado.

Foram implementadas melhorias para confirmar se o usuário está logado em um ramal no momento de realizar a chamada dentro do atendimento. Agora, após logar em um ramal do canal de Voz, ao navegar pelas diferentes telas da plataforma, o atendente permanecerá logado e as ligações poderão ser realizadas normalmente, sem que seja exibida mensagem de falha.