对接 Yeastar P 系列 IPPBX 与 Zoho Desk

本文介绍如何对接 Yeastar P 系列 IPPBX 与 Zoho Desk。

使用要求

Zoho Desk
  • 版本：免费版、标准版、专业版、企业版
PBX 服务器
  • 订阅以下服务：
    • CRM 集成
    • 通讯录专业版
    • 隧道服务 或 视频会议 服务，保证 FQDN 功能可用。
    提示： 订阅服务前，你可以免费试用 30 天。更多信息，请参见 启用 Yeastar P 系列 IPPBX 服务的免费试用。
  • 固件版本：37.9.0.18 或更高版本

前提条件

操作步骤

步骤一、获取 PBX 认证信息

  1. 登录 PBX 管理网页，进入 应用对接 > Helpdesk 集成。
  2. 在 Zoho Desk 右侧，点击 集成对接。

  3. 在 网络信息 栏，, 点击 记录以下信息，后续在 Zoho 注册应用程序时需要使用这些信息。

    • 主页地址：PBX 的 FQDN 域名，用于关联 Zoho 应用程序。
    • 重定向 URI：对接验证成功后，你将会被重定向到该 URI。

步骤二、在 Zoho 注册一个应用程序

  1. 登录 Zoho API 控制台，点击 GET STARTED，添加一个应用程序。
    提示： 如果你在 Zoho API 控制台中已经有应用程序，则点击页面右上角的 ADD CLIENT 添加一个应用程序。

  2. 在 Choose a Client Type 页面中，选择 Server-based Applications。

  3. 在 Create New Client 页面，完成应用程序设置。

    1. 填写以下信息。
      • Client Name：设置应用程序名称。
        注： 此处设置的名称不允许除了 _ 和 & 外的特殊字符。
      • Homepage URL：粘贴 PBX 的主页地址。
      • Authorized Redirect URIs：粘贴 PBX 的重定向 URI。
    2. 点击 CREATE。

      应用程序生成一个客户端 ID 和客户端密钥。记录下客户端 ID 和客户端密钥，以便后续使用。

步骤三、向 Zoho Desk 发起授权请求

  1. 登录 PBX 管理网页，进入 应用对接 > Helpdesk 集成。
  2. 在 Zoho Desk 右侧，点击 集成对接。
  3. 在 授权信息 栏，填写以下信息。

    • 账号服务地址：填写 Zoho 账号服务地址。
      注： 默认地址 https://accounts.zoho.com 适用于多数场景，但可能需要根据你注册 Zoho 账号的区域进行修改。例如，如果你的 Zoho 账号是在中国大陆地区注册的，则需要修改地址为 https://accounts.zoho.com.cn。
    • Zoho Desk 地址：填写 Zoho Desk 地址。
      注： 默认地址 https://desk.zoho.com 适用于多数场景，但可能需要根据你注册 Zoho 账号的区域进行修改。例如，如果你的 Zoho 账号是在中国大陆地区注册的，则需要修改地址为 https://desk.zoho.com.cn。

    • ID：粘贴 Zoho 应用程序的客户端 ID。

    • 密钥：粘贴 Zoho 应用程序的客户端密钥。

  4. 点击 保存。

    浏览器跳出一个新页面，显示应用程序请求访问你的 Zoho 账号中的数据。

  5. 点击 接受 以授权。

    若授权成功，网页将显示 “Authorization succeeded!”。

    在 PBX 配置页面，会有一个弹窗显示对接认证结果。

  6. 点击 确定。

    Zoho Desk 集成页面的 状态 栏显示 已连接，表示 Yeastar P 系列 IPPBX 成功连接到 Zoho Desk。

步骤四、绑定 Zoho Desk 用户与 PBX 分机

  1. 在 PBX 的 Zoho Desk 集成页面中，点击 Zoho Desk 用户 旁边的 ，获取最新的 Zoho Desk 用户列表。

  2. 绑定 Zoho 用户与 PBX 分机。
    自动绑定
    如果用户的 Zoho 账号和 PBX 分机绑定相同的电子邮箱地址，可通过此方式自动绑定用户的 Zoho 账号与 PBX 分机。

    1. 点击 自动绑定。
    2. 在弹出的窗口中，点击 确定。
    3. 点击 保存。
    手动绑定
    如果用户的 Zoho 账号和 PBX 分机分别绑定了不同的电子邮箱地址，你需要手动绑定用户的 Zoho 账号与 PBX 分机。

    1. 在 Zoho Desk 用户旁边的 分机 下拉列表中，选择该用户的 PBX 分机。
    2. 点击 保存。

执行结果

  • Yeastar P 系列 IPPBX与 Zoho Desk 对接完成。
  • 绑定的 Zoho Desk 用户可以使用 PBX 分机拨打和接听电话。

后续操作