集成&自动化 — 创建并更新会话群
1. 使用场景
在宜搭内提交表单,即可创建钉钉会话群,并且可对创建的群聊群名、群成员进行更改。
2. 操作步骤
2.1 步骤一:创建基础表单
2.1.1 搭建并配置「创建会话群」表单
创建表单,用于录入创建会话群所需的群名、群主、群成员数据。
操作步骤:
- 新建普通表单,命名为「创建会话群」。
- 添加单行文本组件,命名为「群聊名称」,设置为必填。(操作如图2.1-1 所示)
![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1638151651352-f2e25648-7446-4f5b-9ce6-bb6dfe7c5cc9.png)
图2.1-1 添加并配置单行文本组件
- 添加成员组件,命名为「选择群主」,设置为必填项。(操作如图2.1-2 所示)
![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1638151730583-7ee9e6ae-fb0c-4d68-85c6-5b0c3872aa5a.png)
图2.1-2 添加并配置成员组件
- 添加另一个成员组件,命名为「选择群成员」,设置为必填项,并开启多选模式。(操作如图2.1-3 所示)
![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1638151848403-134747ed-e9c3-44d6-a753-1ce3fc4da9ea.png)
图2.1-3 添加并配置成员组件
- 点击页面右上角「保存」按钮即可。
2.1.2 搭建并配置「会话群数据汇总」表单
创建表单,用于记录「创建会话群」表单所创建的群聊的信息。包括群名以及群聊 ID,其中群聊 ID 需要从创建会话群的连接器返回的数据中获取。
操作步骤:
- 新建普通表单,命名为「会话群数据汇总」。
- 添加两个单行文本组件,分别命名为「群聊名称」及「群聊 ID」。(操作如图2.1-4 所示)
![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1638152002544-8a3a4f9f-72b2-4d91-98ed-0a8cb5c3c3de.png)
图2.1-4 添加并配置单行文本组件
- 点击右上角保存按钮即可。
2.1.3 搭建并配置「更新会话群」表单
创建表单,用于录入对通过连接器创建成功的群聊更新所需的数据。
操作步骤:
- 新建普通表单,命名为「更新会话群」。
- 添加下拉单选组件,命名为「选择群聊」,设为必填项,选项关联自「会话群数据汇总」表单中「群聊名称」组件。(操作如图2.1-5 所示)
![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1638152195530-ee23f102-df41-4402-98a0-2ea2087de351.png)
图2.1-5 添加并配置下拉单选组件
- 添加单行文本组件,命名为「群聊 ID」,设置数据联动,关联「会话群数据汇总」表单,当「选择群聊」组件的值等于「群聊名称」组件值时,「群聊 ID」的值等于「群聊 ID」组件的值。(操作如图2.1-6 所示)
![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1638152294651-3d40fab2-1641-4958-aeb4-b0ce78dc101f.png)
图2.1-6 添加单行文本组件并设置数据联动
- 添加两个成员组件,分别命名为「添加群成员」及「删除群成员」,开启多选模式。(操作如图2.1-7 所示)
![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1638152374325-800c50ee-fc61-4ec1-8927-792d1e9e9dd0.png)
图2.1-7 添加并配置成员组件
- 添加单行文本组件,命名为「更改后群聊名称」。(操作如图2.1-8 所示)
![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1638152469490-49680374-4098-48dd-9eed-c64abe702c7e.png)
图2.1-8 添加并配置单行文本组件
- 点击页面右上角「保存」按钮即可。
2.2 步骤二:添加并配置连接器
宜搭连接器介绍,请参见集成&自动化
通过上述步骤,调用连接器所需的基础表单已经搭建完毕。接下来,「创建会话群」表单及「更新会话群」表单进行连接器的添加与配置,为实现需求做逻辑层面的准备。
2.2.1 给「创建群会话」表单添加并配置连接器
该连接器用于实现提交「创建会话群」表单时,系统自动在钉钉上创建会话群。
操作步骤:
- 后台管理页>>「创建会话群」>>「集成&自动化」>>「新建集成&自动化」(操作如图2.2-1 所示)
![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1638152619784-a82ac724-a7ef-4f18-a771-a0c6e9803690.png)
图2.2-1 连接器配置入口
- 填写连接器名称为「创建会话群」,触发类型选择「表单事件触发」,点击「确认」按钮。
(操作如图2.2-2 所示)
![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1638152710139-61fca635-9912-4949-a276-9b6d7fecfdfd.png)
图2.2-2 新建连接器
- 配置表单触发事件:触发事件为「创建成功」,数据过滤选择「全部数据」,点击保存。
(操作如图2.2-3 所示)
![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1637029419601-fc5ae2ec-308f-4401-987d-dfbbb6011ebb.png)
图2.2-3 配置连接器表单触发事件
- 选择连接器应用:应用选择为「会话群」,点击「下一步」按钮。(操作如图2.2-4 所示)
![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1637029508449-2a57fd5b-f1cb-4058-9b19-0a0625e0ca49.png)
图2.2-4 选择连接器应用
- 选择执行动作:执行动作选择为「创建会话群」,点击「下一步」按钮。(操作如图2.2-5 所示)
![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1637030419667-f16c04b3-bdc2-435f-b02f-940d4c0ab4b7.png)
图2.2-5 选择连接器执行动作
- 配置执行动作,点击「保存」按钮。(操作如图2.2-6 所示)
![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1637030523563-bf59995f-29d7-4e8f-b402-69c27a9562d6.png)
图2.2-6 配置连接器执行动作
- 点击页面右上角「保存」按钮后,点击「发布」按钮,即可。
- 在「连接器」节点下方添加「新增数据」节点,并进行配置。用于将群会话ID返回到「群会话数据汇总」表单中。(操作如图2.2-7 所示)
![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1637030624639-c214e765-f238-4f36-b5df-01bb0a8f8cba.png)
图2.2-7(1) 添加新增数据节点
![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1637030885459-f5464d69-647a-4371-a2d0-6cf193edc5f8.png)
图2.2-7(2) 配置新增数据节点
2.2.2 给「更新群会话」表单添加并配置连接器
该连接器用于实现提交「更新会话群」表单时,系统自动在钉钉上更新通过连接器创建的会话群。
操作步骤:
- 后台管理页>>「创建会话群」>>「设置」>>「页面设置」>>「集成&自动化」>>「新建集成&自动化」(操作如图2.2-8 所示)
![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1638152816914-3b3a2744-3509-46e0-a1ff-ca24b8f8d4e6.png)
图2.2-8 连接器配置入口
- 填写连接器名称为「创建会话群」,触发类型选择「表单事件触发」,点击「确认」按钮。
(操作如图2.2-9 所示)
![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1637031257533-a1b09dc4-944b-4f87-b553-82cd7fbb2c5d.png)
图 2.2-9 新建连接器
- 配置表单触发事件:触发事件为「创建成功」,数据过滤选择「全部数据」,点击保存。
(操作如图2.2-10 所示)
![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1637031409182-2c89aaaf-7021-4ecc-9cf7-97d7d26c9971.png)
图2.2-10 配置连接器表单触发事件
- 选择连接器应用:应用选择为「会话群」,点击「下一步」按钮。
(操作如图2.2-11 所示)
![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1637031521106-d144645e-83e7-46f2-9a85-1a3aa3366fc5.png)
图2.2-11 选择连接器应用
- 选择执行动作:执行动作选择为「创建会话群」,点击「下一步」按钮。
(操作如图2.2-12 所示)
![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1637031594897-bcb90b90-162a-4582-9c00-1d49e8687363.png)
图2.2-12 选择连接器执行动作
- 配置执行动作,点击「保存」按钮。(操作如图2.2-13 所示)
![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1637031691940-1aa6a6da-8804-4120-a47e-c481a4719136.png)
图2.2-13 配置连接器执行动作
- 点击页面右上角「保存」按钮后,点击「发布」按钮,即可。
2.3 步骤三:提交表单,触发连接器
2.3.1 提交「创建群会话」表单,触发创建群聊连接器
![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1637031881914-b751a5de-6612-498c-8685-7969a4043581.png)
图2.3-1 提交创建群会话表单
2.3.2 提交「更新群会话」表单,触发更新群聊连接器
![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1637046521853-d317a97d-c673-487c-b996-d66fe1247335.png)
图2.3-2 提交更新群会话表单
3. 实现效果
![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1637046215956-9ba63dbc-6d00-4b11-b471-2bc7a4c576b9.png)
图3-1 创建群会话效果展示
![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1637046403513-a85a5f6e-3032-43c2-a95a-f8560f674bf9.png)