对接 Yeastar P 系列 IPPBX 与 Salesforce CRM

本文介绍如何对接 Yeastar P 系列 IPPBX 与 Salesforce CRM。

前提条件

  • 确保可通过 Yeastar FQDN 访问 PBX。

    具体配置请参见通过 Yeastar FQDN 远程访问 PBX。

  • 只有使用 Salesforce CRM 系统管理员账号才能进行 Salesforce CRM 对接。

操作步骤

步骤 1、获取 PBX 认证信息

  1. 登录 PBX 管理网页，进入 应用对接 > CRM 集成。
  2. 点击 Salesforce。

  3. 在 网络信息 栏中，记录下 回拨 URL，以便后续在 Salesforce CRM 中使用。
    注： 主页地址 为 PBX 的 FQDN 域名，用于组成 回拨 URL。

步骤 2、在 Salesforce CRM 上创建并配置应用程序

  1. 登录 Salesforce CRM。
  2. 在 Salesforce 页面右上角，点击 ，接着点击 设置，进入设置主页。

  3. 在左侧导航栏中，进入 平台工具 > 应用程序 > 应用程序管理器。
  4. 在 应用程序管理器 页面，点击 新建连接的应用程序，创建一个用于集成的应用程序。

    1. 在 基本信息 栏，完成以下设置。
      1. 在 连接的应用程序名称 栏，填写一个名称，帮助你识别此应用程序。

        API 名称 将自动与应用程序名称同步。

      2. 在 联系人电子邮件 栏，填写一个联系人电子邮箱地址。
      3. 根据需要填写其他信息。
    2. 滚动页面到 API (启用 OAuth 设置) 栏，进行 API 配置。

      1. 勾选 启用 OAuth 设置 旁的复选框。
      2. 在 回拨 URL 中，粘贴从 PBX 管理网页上获取的回拨 URL。
      3. 在 选定的 OAuth 范围，从 可用的 OAuth 范围 框中，将以下权限选项添加到右侧的 选定的 OAuth 范围 框。
        • 完全访问权限 (full)
        • 通过 API 管理用户数据 (api)
        • 通过 Web 浏览器管理用户数据 (web)
        • 访问唯一用户标识符 (openid)
        • 访问身份 URL 服务 (id, profile, email, address, phone)
        • 随时执行请求 (refresh_token, offline_access)
      4. 取消勾选 对于支持的授权流，需要适用于代码交换 (PKCE) 扩展的证明密钥 选项。
    3. 滚动到页面底部，点击 保存。

      网页提示改动可能需要 10 分钟才能生效。

    4. 点击 继续。
  5. 为该 Salesforce 组织机构关联的所有用户开启应用程序访问权限。
    1. 进入 平台工具 > 应用程序 > 应用程序管理器，点击新的应用程序旁的 ，接着点击 管理。

    2. 在应用程序详细信息页面，点击 编辑策略。

    3. 滚动页面到 OAuth 策略，在 允许的用户 下拉列表中，选择 所有用户可以自我授权。

    4. 点击 保存。

      该组织机构下的所有用户都可以使用此应用程序。

  6. 获取 Salesforce CRM 授权信息，以便后续在 PBX 中使用。
    1. 进入 平台工具 > 应用程序 > 应用程序管理器，点击应用程序旁的 ，接着点击 查看。

    2. 滚动页面到 API (启用 OAuth 设置) 栏，获取 API 授权信息。
      1. 在 使用者密钥和密码 栏，点击 管理客户详细信息。

        Salesforce 会发送一个验证码到你的邮箱。

      2. 填写验证码，然后点击 验证。

      3. 在 使用者详细信息 栏，记录下 使用者密钥 和 使用者密码。

步骤 3、向 Salesforce CRM 发起授权请求

  1. 登录 PBX 管理网页，进入 应用对接 > CRM 集成。
  2. 点击 Salesforce。
  3. 在 授权信息 栏，输入 API 授权信息。

  4. 点击 保存。

    浏览器将弹出一个新的标签页，请求 Salesforce CRM 数据访问权限。

  5. 点击 允许 以授权。

    如果授权成功，页面将显示 Authorization succeeded!。

    在 PBX 配置页面，会看到一个弹窗提示认证结果。

  6. 点击 确定

    状态 栏显示 已连接，表示 Yeastar P 系列 IPPBX 成功连接到 Salesforce CRM。

步骤 4、为 Salesforce CRM 用户绑定 PBX 分机

  1. 在 CRM 集成页面，点击 Salesforce 用户 旁的 ，同步最新的 Salesforce 用户列表。

  2. 为 Salesforce 用户绑定 PBX 分机。
    自动绑定
    如果用户的 Salesforce 账号和 PBX 分机绑定相同电子邮箱地址，可通过此方式自动绑定 Salesforce 账号与 PBX 分机。
    1. 点击 自动绑定。
    2. 在弹出的窗口中，点击 确定。
    3. 点击 保存。
    手动绑定
    如果用户的 Salesforce 账号和 PBX 分机分别绑定了不同的电子邮箱地址，你需要手动绑定用户的 Salesforce 账号与 PBX 分机。
    1. 在 Salesforce 用户旁边的 分机 下拉列表中，选择用户的分机。
    2. 点击 保存。

执行结果

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

后续操作