Este caso de uso describe los pasos de ejemplo para utilizar la API para iniciar una llamada de pantalla compartida con un usuario conectado a una aplicación web.

1. Añadir código de etiquetado a la aplicación

En una página en la que el usuario ha iniciado sesión, añade call to the tagging method con los datos de usuario disponibles en tu aplicación. Esto añade información de usuario a una sesión de navegación existente.

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

2. Crear una página para compartir pantallas

Cree un elemento de interfaz de usuario dentro de la aplicación que sólo esté disponible para agentes de soporte u otros usuarios con permisos especiales que deban poder iniciar una llamada de pantalla compartida con usuarios de la aplicación.

Es necesario autenticarse en la API de Chatvisor para obtener información sobre los usuarios activos. Esto se hace proporcionando un token de usuario a  CV.rest.auth metodo antes de solicitar información.

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

El token de usuario puede adquirirse utilizando la función REST API.

3. Seleccionar usuario para compartir pantalla

En la página de compartir pantalla añade una interfaz de usuario para seleccionar un usuario para compartir pantalla. Puedes seleccionar una de las siguientes opciones:

Opción A: Lista de usuarios

En esta página solicita la lista de los usuarios activos y mostrar la lista dentro de la interfaz de usuario de la aplicación, por ejemplo: tabla:

Usuarios activos

E-Mail[email protected]Start[email protected]Start

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

Opción B: Perfil de usuarios existente

Si ya existe un usuario (por ejemplo, un perfil de usuario) dentro de tu aplicación, es posible que desees obtener información sobre la sesión de navegador de un único usuario.

Juan Pérez (John Doe)

Compartir pantalla: Iniciar

A continuación búsqueda de un usuario con la información proporcionada utilizando la API de JavaScript.

CV.user.status("[email protected]", status => {

  if(status.visitorId) {
    startButton.show();
  }
})

4. Iniciar pantallas compartidas

Los objetos resultantes contienen la información que se proporcionó cuando se creó una etiqueta junto al ID del visitante. Este ID del visitante puede utilizarse para iniciar una sesión de pantalla compartida mediante la llamada API.

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

5. Iniciar conferencia

Una vez que el usuario ha sido etiquetado correctamente (después de iniciar sesión y, opcionalmente, asignado a un agente), puedes iniciar la conferencia sin un ID, si se ha establecido la propiedad id en la función tag.

CV.conference.start();