General
Este artículo se aplica a los desarrolladores que quieren construir una integración con TeamViewer (Classic).
Los desarrolladores pueden crear su propia integración para el acceso asistido con informes de conexión a la plataforma TeamViewer (Classic) utilizando las API públicas TeamViewer (Classic).
Se recomienda encarecidamente leer la documentación de la API para obtener una descripción detallada de la funcionalidad utilizada a continuación y para otras funcionalidades, (por ejemplo, el acceso desatendido), que pueden incluirse a través de las API públicas.
Las llamadas a la API utilizan un token de portador para la autorización que permite la comunicación con el backend TeamViewer (Classic). Este token puede obtenerse como un token de script a través de TeamViewer (Classic) Management Console o (recomendado y descrito aquí) a través del procedimiento Oauth descrito a continuación.
Una vez implementado, OAuth puede utilizarse para obtener un token de portador de TeamViewer (Classic) para cada usuario de la plataforma. Permitirles conectarse desde la plataforma en la que TeamViewer (Classic) está integrada en el backend de TeamViewer (Classic) utilizando su cuenta de TeamViewer (Classic) y crear sesiones y obtener informes de conexión.
Este artículo cubrirá las siguientes convocatorias:
- Autenticación mediante OAuth
- Creación de la sesión
- Informes de conexión
📌Nota: Póngase en contacto con un representante de TeamViewer (Classic) para profundizar en la integración técnica y la colaboración comercial, incluido el uso de las marcas comerciales de TeamViewer (Classic).
Requisitos previos
Para autenticarse con el backend TeamViewer (Classic), se necesita una cuenta TeamViewer (Classic), que puede crearse gratuitamente en: https://login.teamviewer.com
💡Se recomienda utilizar una cuenta genérica para su empresa (por ejemplo, admin@yourcompany.com).
📌Nota: Una vez que la integración está en marcha, todos los usuarios que quieran utilizar la integración necesitan una cuenta de TeamViewer (Classic), y se aplican los requisitos de la licencia de TeamViewer (Classic).
Crear una aplicación cliente para OAuth
El procedimiento OAuth requiere que el backend proporcione a la aplicación cliente el id y el secreto del cliente.
1) Haga clic en su icono de usuario y seleccione Editar perfil
2) Seleccione las aplicaciones
3) Haga clic en Crear aplicación
4) Dar un nombre significativo a la aplicación
5) Dar a la aplicación una descripción significativa
6) Establezca el URI de redirección de su aplicación
7) Establezca los permisos de la aplicación (se requieren informes de sesión, cuenta y conexión)
8) Haga clic en Crear
Puedes crear un script token para probar las llamadas a la API sin OAuth.
OAuth
Para que los usuarios puedan obtener un token de portador para los usuarios habituales, la aplicación debe proporcionar la siguiente funcionalidad:
1) Llamada para obtener la máscara de inicio de sesión OAuth de TeamViewer (Classic) (Debe llamarse en un navegador)
He aquí un ejemplo:
https://login.teamviewer.com/oauth2/authorize?response_type=code&client_id=123456-pDPThfDpeAnIXmuEDSSJ&redirect_uri=http://www.google.com&display=popup
💡Pista: El ClientID, Client Secret, y redirect_uri son los mismos creados anteriormente.
2) Esta llamada devuelve un código que debe incluirse en la llamada siguiente junto con el secreto de cliente de sus aplicaciones cliente
Sesiones de acceso presencial
Una sesión que un aficionado puede compartir con un cliente final se crea con la siguiente llamada.
Esta convocatoria proporcionará, entre otras informaciones, 3 enlaces:
- Enlace de apoyo
- Enlace de apoyo para el cliente web
- Enlace con el cliente final
Los enlaces de soporte (1 y 2) se mostrarán al soporte para activar la conexión TeamViewer (Classic) desde su lado. El enlace del cliente web se puede utilizar si la sesión de asistencia se inicia desde el navegador si no se desea una instalación en el lado del usuario.
El enlace del cliente final se mostrará en el lado del cliente final. Una vez que el cliente final haga clic en él, se conectará a la sesión a través del cliente TeamViewer (Classic) instalado o del módulo TeamViewer (Classic) Quicksupport .
La llamada a la API
POST: https://webapi.teamviewer.com/api/v1/sessions
Cuerpo:
{
"groupname":"TV_test",
"description": "Issue with configuration of corporate email in domain \\example.com",
"end_customer": {
"name": "John Doe",
"email": "john.doe@example.com"
},
}
Para más detalles, consulte la documentación de la API.
Utilice el token de portador obtenido a través de OAuth para ejecutar la llamada a la API.
Informes de conexión
Para fines de auditoría y para proporcionar un historial para la documentación, por ejemplo, en un sistema de tickets, TeamViewer (Classic) proporciona informes de conexión que se pueden obtener con la siguiente llamada:
https://webapi.teamviewer.com/api/v1/reports/connections
La llamada devuelve todas las conexiones, incluyendo sus IDs de sesión.
Documentación de la API
A continuación encontrará más documentación sobre la API.
https://dl.teamviewer.com/integrate/TeamViewer (Classic)_API_Documentation.pdf
https://webapi.teamviewer.com/api/v1/docs/index#/
