返回知识库

工程与栈 · 本地场景

飞书应用Feishu App

飞书应用嵌在工作台里办事:待办在飞书内完成,结果用消息卡片回执,失败可重试且不重复发。

先认出工作台这张待办,再决定回执怎么发

下面就是飞书工作台里的「我的待办」。默认已发布;点完成或版本未发布,待办和消息卡片会一起变。

我的待办v1.0 已发布

需求评审

待完成

还没有回执工作台可用

工作台可用完成结果长在待办和消息卡片上。

原因:版本已在工作台,待办还开着。下一步:点完成看回执,或看未发布时台子是空的。

知识点:入口、回执、幂等

工作台上已经演过,这里只给命名。

  • 飞书应用嵌在工作台、侧边栏或机器人里,用户不用另开网站。
  • 操作结果用消息卡片回执,同事以这一张为准。
  • 完成接口必须幂等:断网重点,不重复完成、不重发回执。
  • 没发布就没有入口;失败要能回到草稿再发。

什么时候用、怎么用

人已经在飞书里办公,才把工具嵌进去。

  • 信号:审批、待办、群通知、表格录入,不想离开飞书。
  • 适用:组织内动作;对外访客更适合网页或小程序。
  • 不适用:只想发一条可分享链接,不必做整套应用。
  • 最短路径:发布到工作台 → 完成一次 → 看回执 → 再点一次确认不重复。

正反例:同一次「完成待办」

都要点完成,差别只在会不会重发。

正例幂等完成,群里只一张卡片

重复点击仍是已完成。同事知道以这条回执为准。

反例断网重试连发三张完成卡

失败写在刷屏的回执上。同事不知道该信哪一条。

快速自测

用户点「完成待办」后断网,重连又点了一次。应用该怎么响应?

继续查证

术语的技术定义和行为以这些一手或权威资料为准。

下一步学

和本知识点经常一起出现的概念。