在线激活并对接企业微信

本文描述了 Yeastar 智慧办公 私有部署过程中的在线激活并对接企业微信的步骤。

在线激活并对接企业微信包括四个具体步骤：

1. 企业微信自建应用及配置
2. 输入激活码
3. 绑定企业微信
4. 登录 Yeastar 智慧办公

具体操作指引，参见以下说明。

步骤一、企业微信自建应用及配置

Yeastar 智慧办公 是通过企业微信内的自建应用实现与企业微信的绑定和对接。因此，你需要提前自建应用并进行相应的配置。

企业微信自建应用

1. 登录企业微信管理后台，进入 应用管理 > 应用 > 自建。

2. 点击 创建应用，并完成以下配置：

   • 应用 logo：上传一个 logo 以帮助你辨识此应用。
   • 应用名称：输入一个名称以帮助你辨识此应用。
   • 可见范围：选择有权限使用 Yeastar 智慧办公 的部门或成员，建议以部门为单位进行选择。

3. 点击 创建应用。

配置企业可信 IP 及应用回调域

1. 配置企业可信 IP。

   1. 进入自建应用的主页，下拉至 开发者接口，点击 企业可信IP 下的 设置。

   2. 在弹窗中，填写部署 Yeastar 智慧办公 的主机 IP 地址，然后点击 确定。

      重要提示

      如果你的服务器有多个公网 IP，且路由转发策略为 负载均衡，则你需要通过路由策略指定访问外部网络时的 IP 地址及外网出口，并在此填写与外网出口绑定的 IP 地址。

   
   

2. 配置应用回调域。

   1. 在 开发者接口 章节，点击 企业微信授权登录 下的 设置。
      
   2. 点击 设置授权回调域 ，输入私有化部署的服务器域名。然后点击 保存。

配置网页授权可信域

1. 返回自建应用的主页，下拉至 开发者接口 ，点击 网页授权及JS-SDK 下的 设置可信域名。

2. 在 回调域名可信域名 和 跳转小程序可信域名 栏中，输入私有化部署服务器的域名。

   重要提醒

   • 此处填写的域名需确保 没有 在企业微信管理后台与其他自建应用进行过 域名归属验证。

   

3. 点击 申请校验域名。
   

   故障排查： 域名主体校验未通过

   若提示 域名主体校验未通过，需配置备案主体与当前企业主体相同或有关联关系的域名，则表示申请该域名的企业主体与当前企业微信的企业主体不相同（如子公司为申请域名的主体，母公司为申请企业微信的主体），此时二者需要满足企业微信对关联主体的要求，才能完成验证。
   
   详细信息，参见 关联主体介绍

4. 点击 下载文件。
   

5. 连接至部署 Yeastar 智慧办公 的服务器主机，依次运行下述命令进入域名根目录。

   cd /
   

   cd usr/local/smartoffice/docker/volumes/nginx/milesight
   

6. 运行下述命令，上传校验文件至域名根目录下。

   rz
   

7. 查看校验文件上传结果。

   1. 打开浏览器，在地址栏中输入 https://域名/校验文件名。
      在本例中，输入 https://www.privatetest.top/WW_verify_CoFZQxHysF7aDnni.txt

      替换以下内容

      • 域名：你为 Yeastar 智慧办公 所准备的域名。
      • 校验文件名：在第 4 步中获取到的校验文件全名，包括拓展名。

   2. 按下 Enter 访问页面，查看文件上传结果。

      • 如页面输出一段字符，则表示校验文件已上传成功。
        

      • 若无法访问页面，则表示校验文件上传失败。跟随以下步骤重新上传文件：

        1. 检查第 2 步中输入的域名是否正确。
        2. 检查第 5 步中的路径选择是否操作正确。
        3. 删除原文件后重新上传校验文件。

8. 返回企业微信管理后台，在设置可信域名页面点击 确定。

配置日程权限

1. 在企业微信管理后台，进入 协作 > 日程。
2. 点击 可调用接口的应用 旁的 设置。
3. 在弹窗中，勾选你为 Yeastar 智慧办公创建的应用。
4. 点击 确定。
   

添加 Yeastar 智慧办公管理员

1. 在企业微信管理后台，进入 通讯录。
2. 点击左侧搜索框旁的 +，选择 添加标签。
   

3. 在弹窗中，填写标签的基本信息：

   • 标签名称：输入 智慧办公平台管理员。
   • 可使用人：保持默认选项。
   • 可使用人权限：选择使用者对该标签的使用权限。

4. 点击 确定。
   

5. 点击 添加部门/成员,在弹窗中，选择你想要赋予管理员角色的成员。
6. 点击 确认。
   

步骤二、输入激活码

1. 联系 Yeastar 销售人员以获取激活码。
2. 打开浏览器，在地址栏输入你为 Yeastar 智慧办公 准备的域名，按下 Enter 键。
3. 在系统激活页面，选择 在线激活 并输入激活码。
4. 点击 确认。
   

步骤三、绑定企业微信

1. 在注册方式页面，选择 企业微信，并完成下述配置。

   • 企业名称：输入企业名称。
   • 企业 ID：输入企业微信上企业的唯一ID，填写后用于创建企业、同步组织架构。
     获取路径：以企业微信管理员身份登录企业微信管理后台，进入 我的企业 > 企业信息 > 企业 ID。

   • Agent ID 及 Secret：输入企业微信上自建应用的 ID 及秘钥。获取路径如下：

     1. 以企业微信管理员身份登录企业微信管理后台，进入 应用管理 > 应用 > 自建。
     2. 点击你为 Yeastar 智慧办公 创建的应用。
     3. 在应用详情页即可查看 Agentld 以及 Secret。
        

   • Homepage：这是企业微信点击应用后跳转的应用主页信息，你需要将此信息复制至企业微信自建应用内，详细操作方式如下：

     常见问题：为什么没有 Homepage 配置项？

     确保你已输入 企业 ID 及 Agent ID，在上述两项配置输入后会自动生成 Homepage。

     1. 在 Yeastar 智慧办公 注册页面，点击 Homepage 右侧的 复制链接。
     2. 在企业微信管理后台中的自建应用详情页面，点击 应用主页 旁的 设置。
     3. 在 网页地址 栏中，粘贴 Homepage 的链接。
     4. 勾选 在微信插件中始终进入主页。
     5. 点击 确定。
        

   • URL、Token、及 EncordingAESKey：此三项参数用于配置企业微信接收服务器地址，详细操作方式如下：

     1. 在 Yeastar 智慧办公 注册页面，点击 URL 右侧的 复制链接。
     2. 在企业微信管理后台中的自建应用详情页面，点击 接收消息 内的 设置API接收。
        
     3. 在弹窗中，将 URL 粘贴至 URL 栏。
     4. 点击 Token 旁的 随机获取，然后将生成的值粘贴到 智慧办公 注册页面的 Token 栏。
     5. 点击 EncordingAESKey 旁的 随机获取，然后将生成的值粘贴到 智慧办公 注册页面的 EncordingAESKey 栏。
     6. 在 智慧办公 注册页面，点击 确认 保存设置。
     7. 在 企业微信 配置页面，点击 保存。
        

2. 返回 Yeastar 智慧办公 注册页面。

步骤四、登录 Yeastar 智慧办公

1. 阅读我们的服务协议和隐私政策，并选择复选框以同意这些条款。
2. 用企业微信扫码登录。

后续步骤

你已完成 Yeastar 智慧办公私有化版本的部署及系统激活，现在你需要对 Yeastar 智慧办公进行基础配置。