「飞书消息」连接器|飞书低代码平台

「飞书消息」连接器|飞书低代码平台

飞书低代码平台手册精选NaN-NaN-NaN
产品功能
当发起一条流程,希望和飞书消息有更多的结合,比如:
  • 发送一条飞书卡片消息
  • 撤回一条飞书消息
  • 发送固定的表情回复
等等这类需要和飞书消息联动的流程,就可以通过「飞书消息」节点,实现数据互通。
配置步骤
(一)添加节点
进入流程编辑器,新增节点选择「飞书」中的「飞书消息」。
250px|700px|reset
image.png
(二)操作和凭证
执行操作
选择该节点具体要执行什么操作:
250px|700px|reset
image.png
通过「飞书消息」连接器,可对飞书消息进行 3 类 11 个操作:
连接配置
使用具体哪个飞书集成的机器人来执行操作,支持选择:
  1. 默认飞书集成:系统自动生成的飞书应用机器人来执行操作。
  1. 自定义飞书集成:使用自己创建的飞书应用机器人来执行操作,创建自定义飞书应用参见 认识与配置飞书集成
(三)基础配置
  • 点击“下一步”,即进入基础配置,不同操作对应的配置项也不同。详见飞书开放平台的对应接口文档。
部分字段配置说明:
字段
说明
获取方式
用户 ID 类型
user_id,open_id,union_id
open_id:标识一个用户在某个应用中的身份。同一个用户在不同应用中的 Open ID 不同。了解更多:如何获取 Open ID
union_id:标识一个用户在某个应用开发商下的身份。同一用户在同一开发商下的应用中的 Union ID 是相同的,在不同开发商下的应用中的 Union ID 是不同的。通过 Union ID,应用开发商可以把同个用户在多个应用中的身份关联起来。了解更多:如何获取 Union ID?
user_id:标识一个用户在某个租户内的身份。同一个用户在租户 A 和租户 B 内的 User ID 是不同的。在同一个租户内,一个用户的 User ID 在所有应用(包括商店应用)中都保持一致。User ID 主要用于在不同的应用间打通用户数据。了解更多:如何获取 User ID?
消息 ID
待撤回的消息的ID
示例值:"om_dc13264520392913993dd051dba21dcf"
message_id 是一条消息的唯一标识。当发送一条消息时,系统会自动生成唯一ID。message_id 的格式是以om_ 开头的字符串,例如:om_934be5776f5a87239a298af9e74c0f72
  • 方式一:调用 发送消息 接口,从响应的结果中获取 message_id 字段;
  • 方式二:监听 接收消息事件,从事件体中获得message实体的 message_id 字段
表情类型
emoji类型 emoji类型列举
示例值:"SMILE"
-
Chat_ID
群 ID,详情参见群ID 说明
示例值:"oc_a0553eda9014c201e6969b478895c230"
chat_id是一个群聊的唯一标识。当创建一个群聊的时候,系统会自动生成该ID。
chat_id的格式是由oc_开头的字符串,例如:oc_a0553eda9014c201e6969b478895c230
场景1 已经存在的群
  1. 创建一个应用,并开启机器人能力
  1. 把机器人加入群中;
  1. 用上面的chat_id作为参数发送消息或者将用户或机器人拉入群聊等。
场景2 机器人新建群
  1. 创建一个应用,并开启机器人能力
  1. 用机器人身份建群,调用接口创建群,从响应结果中获得chat_id参数;
  1. 用上面的chat_id作为参数发送消息或者将用户或机器人拉入群聊等。
分页大小
page_size
示例值:100
默认值:100
数据校验规则
  • 最大值:100
分页的 token
page_token
示例值:"nF1ZXJ5VGhlbkZldGNoCgAAAAAA6PZwFmUzSldvTC1yU"
分页标记,第一次请求不填,表示从头开始遍历;分页查询结果还有更多项时会同时返回新的 page_token,下次遍历可采用该 page_token 获取查询结果
  • 「消息发送方式」支持异步和同步发送,同时支持指定用户支持直接通过 user id 来指定发送的用户
具体的使用场景请查看帮助文档:如何通过「飞书消息」连接器使用飞书消息相关能力
  1. 同步发送飞书消息时,支持返回输出数据(包括 message id),下游节点可以引用输出的数据。
250px|700px|reset
image.png
  1. 飞书消息连接器发送飞书消息卡片时,指定用户支持直接通过 user id 来指定发送的用户
250px|700px|reset
image.png
(四)高级配置
可以根据需要,设置操作执行失败时的重试策略:
配置项
说明
重试间隔
每次重试之间的间隔时间,默认 5000 ms
重试次数
失败后的自动重试次数,默认 0 次
超时时间
每次重试的 HTTP 请求超时时间,默认 5000ms
(五)输出变量
选择了操作后,「输出变量」会根据所选的操作事件显示接收到的事件内容,在后续节点中,我们可以引用这里的具体字段。
节点配置完成后,在流程中也会自动生成一个变量,变量中将承载触发器所选事件接收到的数据内容:
250px|700px|reset
image.png
常见问题
如何申请飞书应用的权限?
  • 默认的飞书应用会将涉及到的相关权限,会在发布「飞书低代码平台」应用时自动申请。
250px|700px|reset
image.png
  • 自定义飞书应用,需要到飞书开放平台自行申请,详见如何开通权限
配置飞书群时流程报错
当在配置飞书群时,遇到下方报错。其不同原因及解决方案为:
250px|700px|reset
image.png
  • 原因一:不具备所需权限,需要进入飞书开放平台为所选的飞书集成自行申请「获取与更新群组信息」,再发布一次飞书应用即可生效。步骤如下:
250px|700px|reset
image.png
250px|700px|reset
image.png
250px|700px|reset
image.png
  • 原因二:只能选到所选飞书集成机器人所在的飞书群,可以确认下机器人是否在群内
先进生产力和业务协同平台
联系我们立即试用

先进团队,先用飞书

欢迎联系我们,飞书效能顾问将为您提供全力支持
分享先进工作方式
输送行业最佳实践
全面协助组织提效
联系我们立即试用