对接 Yeastar P 系列云 PBX 与 Microsoft Teams

Yeastar P 系列云 PBX 与 Microsoft Teams 的直接对接需要每个用户将 Yeastar Linkus 安装到自己的 Teams 客户端，并使用分机账号或 Microsoft 账号进行登录。完成对接后，Teams 用户可直接在 Teams 客户端内拨打、接听和控制电话。

本文提供一个示例，向你演示单个用户如何对接 Yeastar P 系列云 PBX 和 Microsoft Teams。

前提条件

你已获取 Linkus 网页端的域名。

步骤一、安装 Yeastar Linkus 到 Microsoft Teams 客户端

登录 Microsoft Teams。
在左侧导航栏，点击应用，然后搜索 Yeastar Linkus。
在应用栏，选择 Yeastar Linkus，然后点击添加。
页面将自动跳转至一个页签，在这里你可以访问并登录 Linkus 网页端。

步骤二、访问 Linkus 网页端

在 Phone Extension 页签，输入 Linkus 网页端的域名。
点击访问PBX。
页面将自动跳转至登录界面。

步骤三、登录 Linkus 网页端

选择以下一种方式登录到 Linkus 网页端：

使用 Yeastar 分机账号登录
使用 Microsoft 账号登录

使用 Yeastar 分机账号登录

在登录界面，输入分机用户名和密码，然后点击登录。
- 用户名：分机账号的邮箱地址。
- 密码：分机账号的密码。
如果你设置了双因素身份验证，你需要再输入一个验证码才可登录。
1. 输入通过身份验证器应用或邮箱获取的 6 位验证码。
2. 可选：勾选受信任设备。
  
  注：对于你经常登录账号的设备，你可以勾选此项，将其添加为受信任设备。这样一来，在接下来 180 天内你从该设备登录账号时无需再输入验证码。
3. 点击登录。
在弹出的窗口中，设置是否允许 Yeastar Linkus 在你收到 Linkus 聊天消息和来电时向你发送通知。

使用 Microsoft 账号登录

重要：只有当满足以下条件时，你才能够使用 Microsoft 账号进行登录：

你的 Linkus 网页端的一级域名为以下之一：ycmcloud.com、yeastarcloud.com、或 yeastarycm.co.za。
管理员已对接 Yeastar P 系列云 PBX 与 Microsoft Entra ID 并允许你通过 SSO 登录 Linkus 客户端。

在登录界面，点击 Sign in with Microsoft。
在弹出的窗口中，使用 Microsoft 账号进行登录。
在弹出的窗口中，设置是否允许 Yeastar Linkus 在你收到 Linkus 聊天消息和来电时向你发送通知。

步骤四、设置并选择用于拨打和接听电话的终端

你可以通过以下任一方式在 Microsoft Teams 中控制通话：

要通过 Linkus 网页端、Linkus 桌面端 或 IP 话机 发起和接听电话，并在 Microsoft Teams 中控制通话，启用 CTI 模式以控制目标终端。
要直接通过桌面端插件唤起独立的通话控制弹窗，且不依赖通过 CTI 控制终端，下载并启动 Yeastar for Teams Desktop Plugin。

启用 CTI 模式以控制目标终端


应用场景	操作说明
使用 Linkus 网页端作为通信终端	在右上角，点击打开并免密登录 Linkus 网页端。图标从变成，表示现在可通过 CTI 控制 Linkus 网页端，并使用 Linkus 网页端拨打和接听电话。
使用 Linkus 桌面端作为通信终端	将 Linkus 桌面端升级到 1.5.4 或更高版本。用你的分机登录 Linkus 桌面端。图标从变成，表示现在可通过 CTI 控制 Linkus 桌面端，并使用 Linkus 桌面端拨打和接听电话。
使用 IP 话机作为通信终端	使用亿联 (Yealink) / 方位 (Fanvil) / Snom IP 话机，话机型号和固件需符合 Yeastar CTI - 支持的设备列出的要求。将你的分机注册到话机上。图标从变成，表示现在可通过 CTI 控制 IP 话机，并使用 IP 话机拨打和接听电话。

下载并启动 Yeastar for Teams Desktop Plugin

注：操作系统版本需满足以下要求：

Windows：Windows 10 及更高版本
macOS：macOS 12 及更高版本

在顶部的提示栏中，点击开启桌面端插件。
系统自动在浏览器打开插件下载页面。
在插件下载页面，点击 Download。
Yeastar for Teams Desktop Plugin 的安装包被下载到你的电脑。
运行安装程序并完成安装。
启动 Yeastar for Teams Desktop Plugin。
在 Teams 内的 Linkus 网页端中，图标从变成，表示现在可直接在 Teams 中通过 Yeastar for Teams Desktop Plugin 控制通话。关于 Yeastar for Teams Desktop Plugin 的配置和通话控制的更多信息，请参见 Yeastar for Teams Desktop Plugin 概述。

(可选)步骤五、固定 Yeastar Linkus 到 Teams 导航栏

你可以将 Yeastar Linkus 固定到你的 Teams 左侧导航栏，方便快速访问。

在 Teams 左侧导航栏，右键点击 Yeastar Linkus。
在弹出的窗口中，点击固定。
Yeastar Linkus 已被固定在你的 Teams 客户端左侧的导航栏。

执行结果

你可以在 Microsoft Teams 内访问 Linkus 网页端，并直接通过 PBX 拨打和接听电话。