腾讯会议插件
1. 简介
1.1 插件简介
腾讯会议插件支持在简道云表单中创建、更新、取消腾讯会议。
1.2 应用场景
适用于需要在简道云表单中同步创建、更新、取消腾讯会议的多种场景中,如招聘管理、在线培训等。
1.3 预期效果
以通过简道云表单发起一个腾讯会议为例,效果如下所示:
1.4 使用说明
腾讯会议插件为免费插件,付费版用户可免费使用。
2. 腾讯会议平台配置
2.1 注册账号
进入 腾讯会议 官网,点击右上角「登录」按钮,根据平台提示进行登录。
2.2 创建应用
1)在「用户中心 >> 我的会议」处,选择「我的应用」。
2)进入「我的应用」中,在「创建的应用 >> 企业自建应用」处,点击「创建应用」,填写应用名称并选择应用类型后,点击「创建」。
3)在应用的「基础信息和凭证」处,补充应用的基础信息和开发者信息。
2.3 获取应用凭证
在「基础信息和凭证 >> 应用凭证」处,查看并保存应用相关凭证,包括企业 ID、应用 ID、Secret ID 和 Secret Key。
3. 插件安装及配置
3.1 安装插件
1)直接安装
2)插件市场处安装
在简道云「插件市场」处,安装「腾讯会议」插件。插件市场处安装方法可参见文档:插件市场中【2.3 插件安装】。
3.2 配置插件
安装完成后,在「插件管理」处,点击插件右侧的「设置」按钮,将【2.3 获取应用凭证】中获取到的企业 ID 、应用 ID、Secret ID 和应用 Secret 配置进去。
3.3 启用插件
在插件管理中,打开「腾讯会议」插件右侧开关,启用插件。
4. 表单搭建
插件使用体验可先安装:腾讯会议预约系统模板。本文将按照示例表单进行讲解。
插件配置需要使用 3 张表单,分别是:
- 创建腾讯会议:用于填写会议基本信息后,创建一个腾讯会议;
- 修改会议内容:用于修改会议的相关信息;
- 取消会议:用于删除确认需要取消的腾讯会议。
5. 前端事件配置
5.1 创建腾讯会议
5.1.1 添加按钮执行动作
进入「创建腾讯会议」表单中,点击「是否创建会议」按钮字段,在「字段属性 >> 执行动作」处,点击「添加执行动作」:
5.1.2 设置事件名称和说明
添加好按钮执行动作后,首先设置执行动作的基础信息,即事件名称和事件说明,用于区分前端事件:
5.1.3 设置执行动作
设置执行动作如下:
- 选择插件:选择「腾讯会议 >> 创建会议」;
- 操作人:设置为字段值,即「会议创建者」字段;
- 主题:设置为字段值,即「会议主题」字段;
- 开始时间:设置为字段值,即「会议开始时间」字段;
- 结束时间:设置为字段值,即「会议结束时间」字段;
- 会议密码:设置为字段值,即「会议密码」字段;
- 内部参会人:设置为字段值,即「内部参会人」字段;
- 嘉宾列表:设置为字段值,即「外部参会人」字段;
- 会议地点:设置为字段值,即「会议地点」字段;
- 字段存储关系:点击「添加」按钮,并选择全部字段后进行如下设置:
- 将会议 id 的值存储到「会议 ID」字段中;
- 将会议号的值存储到「会议号」字段中;
- 将会议密码的值存储到「参会密码」字段中;
- 将入会链接的值存储到「参会链接」字段中。
5.2 修改会议内容
5.2.1 添加按钮执行动作
进入「修改会议内容」表单中,点击「是否确认修改」按钮字段,在「字段属性 >> 执行动作」处,点击「添加执行动作」:
5.2.2 设置事件名称和说明
添加好按钮执行动作后,首先设置执行动作的基础信息,即事件名称和事件说明,用于区分前端事件:
5.2.3 设置执行动作
设置执行动作如下:
- 选择插件:选择「腾讯会议 >> 更新会议」;
- 操作人:设置为字段值,即「会议创建者」字段;
- 会议 id:设置为字段值,即「会议ID-查询」字段;
- 主题:设置为字段值,即「会议主题」字段;
- 开始时间:设置为字段值,即「会议开始时间」字段;
- 结束时间:设置为字段值,即「会议结束时间」字段;
- 会议密码:设置为字段值,即「会议密码」字段;
- 内部参会人:设置为字段值,即「内部参会人」字段;
- 嘉宾列表:设置为字段值,即「外部参会人」字段;
- 会议地点:设置为字段值,即「会议地点」字段;
- 字段存储关系:点击「添加」按钮,并选择全部字段后进行如下设置:
- 将会议 id 的值存储到「会议 ID」字段中;
- 将会议号的值存储到「会议号」字段中;
5.3 取消会议
5.3.1 添加按钮执行动作
进入「取消会议」表单中,点击「是否确认删除」按钮字段,在「字段属性 >> 执行动作」处,点击「添加执行动作」:
5.3.2 设置事件名称和说明
添加好按钮执行动作后,首先设置执行动作的基础信息,即事件名称和事件说明,用于区分前端事件:
5.3.3 设置执行动作
设置执行动作如下:
- 选择插件:选择「腾讯会议 >> 取消会议」;
- 操作人:设置为字段值,即「会议创建者」字段;
- 会议 id:设置为字段值,即「会议 ID」字段;
- 原因 Code:设置为字段值,即「取消原因编码」字段;
- 原因描述:设置为字段值,即「取消原因」字段。
设置完成保点击「保存」。
5.4 效果演示
效果参见本文【1.3 预期效果】。
6. 注意事项
1)企业使用腾讯会议平台时,根据不同的腾讯会议版本,对创建会议有如下所示限制:
- 商业版账号:若购买账号数不足 10 个,则无法使用;
- 企业版、教育版账号:若购买虚拟会议室不足 10 个,则无法使用。
2)腾讯会议通讯录中的成员 userid 需要和简道云通讯录中的成员编号保持一致。