Base de Conhecimento

Back to support overview

Este caso de uso descreve etapas de exemplo para usar a API para iniciar uma chamada de compartilhamento de tela com um usuário conectado de um aplicativo da web.

Etapas

1. Adicione código de marcação ao aplicativo

Em uma página onde o usuário está conectado, adicione uma chamada ao método de marcação com os dados do usuário disponíveis a partir de seu aplicativo. Isso adiciona as informações do usuário a uma sessão de navegador existente.

CV.user.tag({
    "email": "[email protected]",
    "firstname": "John",
    "lastname": "Doe",
    "labels": []
})

2. Crie uma página para o compartilhamento de tela

Criar um elemento de IU dentro do aplicativo que está disponível apenas para agentes de suporte ou outros usuários com permissões especiais que devem poder iniciar uma chamada de compartilhamento de tela com usuários do aplicativo.

É necessário autenticar na API do Chatvisor para obter informações sobre usuários ativos. Isso é feito fornecendo um token de usuário ao método CV.rest.auth antes de solicitar as informações.

CV.rest.auth("[email protected]", "my-user-token")

O token do usuário pode ser obtido usando a REST API.

3. Selecione um usuário para o compartilhamento de tela

Na página de compartilhamento de tela, adicione uma IU para selecionar um usuário para fazer o compartilhamento de tela. Você pode selecionar uma das seguintes opções:

Opção A: Lista de usuários

Nesta página, solicite a lista de usuários ativos e exiba a lista dentro da IU do aplicativo, por exemplo como tabela:

Usuários ativos

E-Mail[email protected]Iniciar[email protected]Iniciar

CV.user.list(result => {
  result.forEach(user => addTableRow(user))
})

Opção B: Perfil de usuário existente

Se já houver um usuário existente (por exemplo, um perfil de usuário) disponível em seu aplicativo, talvez seja conveniente obter informações sobre a sessão do navegador de um único usuário.

João Fulano

Compartilhamento de tela: Iniciar

Em seguida,

pesquise um usuário com as informações fornecidas usando a API JavaScript.

CV.user.status("[email protected]", status => {
  if(status.visitorId) {
    startButton.show();
  }
})

4. Inicie compartilhamento de tela

O (s) objeto (s) de resultado contêm as informações fornecidas quando uma tag foi criada junto com uma ID de visitante. Esta ID de visitante pode ser usada para iniciar uma sessão de compartilhamento de tela usando a API de chamada.

function onClickStart(result) {
  var visitorId = result["visitorId"];
  CV.calling.startScreen(visitorId);
}

5. Inicie conferência

Depois que o usuário for identificado com sucesso (após o login e opcionalmente atribuído a um agente), você pode iniciar a conferência sem um ID, se a propriedade id na função de tag tiver sido definida.

CV.conference.start();