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