TeamViewer集成构建

开发人员可以使用公共的 TeamViewer API 创建自己的集成，以实现出席访问和连接报告等功能。API 调用需要使用一个授权令牌与 TeamViewer 后台进行通信。这个令牌可以通过 TeamViewer 管理控制台获取脚本令牌，也可以通过 OAuth 程序获得。

一旦实现，可以使用OAuth为每个平台用户从TeamViewer ，获得一个承载令牌。使他们能够使用他们的TeamViewer 账户从TeamViewer 集成到TeamViewer后台的平台上进行连接，并创建会话和获得连接报告。

这篇教程将涵盖以下调用：

• 通过OAuth进行认证；
• 会议创建；
• 连接报告。

一、先决条件

1、要在TeamViewer 后台进行认证，需要一个TeamViewer 账户，该账户可在以下网站免费创建：https://login.teamviewer.com

2、建议为公司使用一个通用账户（如admin@yourcompany.com）。

3、一旦整合到位，所有想要使用整合的用户都需要一个TeamViewer 帐户，而且TeamViewer 许可证要求也适用。

二、创建客户端应用程序

OAuth程序要求后端向客户端应用程序提供客户端ID和秘密。

1、点击用户图标，选择编辑个人资料；

2、选择应用程序；

3、点击创建应用程序；

4、给应用程序起一个有意义的名字；

5、给应用程序一个有意义的描述；

6、设置应用程序的重定向URI；

7、设置应用程序的权限（会话、账户和连接报告是必需的）；

8、点击创建。

可以创建一个脚本令牌，在没有OAuth的情况下测试API调用。

三、OAuth

为了使用户能够获得普通用户的不记名令牌，该应用程序需要提供以下功能。

1、调用获取TeamViewer OAuth登录掩码（必须在浏览器中调用）。

提示：ClientID、Client Secret和redirect_uri是上面创建的那些。

2、该调用返回一个代码，需要与客户端应用程序的客户秘密一起包含在下面的调用中。

四、值守会议的访问

支持者可以与终端客户共享的会话是通过以下调用创建的。

这个电话将提供，除其他信息外，3个链接。

• 支持者链接；
• 网页客户端的支持者链接；
• 终端客户链接。

支持者链接（1和2）应显示给支持者，以便从他们那边激活TeamViewer 连接。如果不希望在支持者一方进行安装，支持会话应从浏览器启动，则可使用网络客户端链接。

终端客户的链接将显示在终端客户那边。一旦终端客户点击它，它将通过安装的TeamViewer (Classic) 客户端或TeamViewer (Classic) Quicksupport 模块连接到会议。

五、API调用

主体：

{
"groupname":"TV_test",
"description": "Issue with configuration of corporate email in domain \\example.com",
"end_customer": {
"name": "John Doe",
"email": "john.doe@example.com"
},
}

使用通过OAuth获得的承载令牌来执行API调用。

六、连接报告

为了审计和提供历史文件，例如在票务系统中，TeamViewer (Classic) ，提供连接报告。