「飞书消息」连接器|飞书低代码平台 - 飞书官网
产品功能

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

飞书

2024-12-23

配置步骤​
常见问题​
当发起一条流程,希望和飞书消息有更多的结合,比如:​
  • 发送一条飞书卡片消息​
  • 撤回一条飞书消息​
  • 发送固定的表情回复​
等等这类需要和飞书消息联动的流程,就可以通过「飞书消息」节点,实现数据互通。​
配置步骤​
(一)添加节点​
进入流程编辑器,新增节点选择「飞书」中的「飞书消息」。​
​
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
​
​
  • 原因二:只能选到所选飞书集成机器人所在的飞书群,可以确认下机器人是否在群内​
预约飞书企业效能顾问 深度诊断企业痛点,定制专属 AI 办公方案

先进团队,先用飞书

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

字节跳动旗下 AI 工作平台

联系我们立即试用