飞书一键拉群

开启后，特定的项目或环节事件将自动触发将相关人员拉入飞书群组的操作，以便高效地组织和协调团队成员。

开启飞书一键拉群

• 进入要开启该功能的流程节点。

• 在节点配置中找到"飞书一键拉群"。

• 将"是否开启"选择为"是"。

选择群组所在的飞书平台

在"飞书APP"处选择创建群组所在的平台。

设定触发方式

在"触发方式"中设定触发群组创建的事件，目前可选的有"手动(按钮)"、"进入环节自动建群组"、"环节完成后自动建群组"三种触发方式。

选择群主

在"群主"处将项目负责人或者环节负责人设置为群主。

建群后通知

建群组后在飞书群组中自动发送项目信息和群组说明。使用时将"自动发送和项目信息"选择为"是"，之后在"项目信息内容"处编写发送内容的脚本。以下说明此处的脚本配置：

• 点击"项目信息内容"，进入脚本配置界面。

• 点击"填充示例"即可得到一个消息通知的脚本模板。

• 脚本说明：

  • 自动提取项目信息：从ctx和相关字段自动获取项目和相关人员信息。

  • 处理人员信息：根据表单数据，识别并处理相关人员信息，例如加盟商、筹建专员等。

  • 生成飞书@提醒：自动查找相关人员在飞书的用户ID，并生成用于群组@提醒的格式。

  • 构建消息内容：使用飞书文本剪辑的语法构建包含所有相关信息的飞书消息。

  • 自定义消息模板：设置消息的显示格式，如宽屏模式、标题等。

  • 可根据需求自定义脚本配置。

确定群组成员

• 在"拉群范围"处可以选择将"整个项目"或者"当前环节"的用户拉入群组。

• 若要将特定的用户拉入群组则需要在"拉群范围"处选择"脚本"，并在"拉群脚本"处配置脚本。

• 若需要将子流程用户拉入群组，则在"子流程用户加入群组"处选择为"是"。

持续更新

在"持续更新"处，通过团队、用户, 流程模型的事件触发项目创建、更新等操作。

• 点击加号增加一个持续更新的操作。

• 名称： 输入操作的名称

• 选择对象类型、模型、事件： 可选择对象类型有"流程"、"用户"、"团队"。根据选定的对象类型进一步确定对象的模型和事件。

• 触发动作： 可选择"添加用户"或"发消息"。

• 参数脚本： 如果触发动作是"添加用户"，则脚本返回user_id数组；如果触发动作是"发消息"，则脚本返回项目参数对象。

• 事件脚本： 配置脚本添加用户或发消息，最终返回true。

示例

• 该配置表明当测试勘测流程(该子流程可以看成是当前主流程的一个环节)结束后，会自动在群组中发消息通知勘测任务完成的相关信息。

• 以上是"参数脚本"配置，用来判断环节的流转进度从而确定发消息的时机。若确定环节结束则返回一个空对象，即可进一步触发事件处理脚本，完成消息的发送。

• 以上是"事件处理脚本"配置，编辑发送的消息，最终返回true。