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

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

}