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” : “”

}

Colaboração – Citrus.cx