飞书 webhook 发送消息卡片模板时，如何动态更新卡片内容？

Question

在使用飞书Webhook发送消息卡片时，如何动态更新卡片内容是一个常见问题。飞书Webhook本身不支持直接更新已发送的消息卡片内容，每次调用都会生成一条新消息。若需实现动态更新效果，可采用以下方法：通过唯一标识（如任务ID）控制消息内容，在前端展示时利用飞书交互式组件（如按钮或选择器）触发回调接口，重新发送更新后的内容并替换旧消息。此外，结合飞书提供的“更新消息”API（需独立授权），可以定位具体消息并修改其内容。但需要注意的是，此操作可能涉及权限配置与消息有效期限制，开发者应确保回调逻辑的稳定性和数据一致性，同时遵循飞书平台的安全规范。

Answer 1

1. 问题概述：飞书Webhook动态更新卡片内容的挑战

在企业协作场景中，飞书作为一款强大的沟通工具，其Webhook功能被广泛用于自动化消息通知。然而，开发者常遇到一个棘手的问题：飞书Webhook本身并不支持直接更新已发送的消息卡片内容。每次调用Webhook都会生成一条新消息，这导致了信息冗余和用户体验下降。

以下是该问题的常见表现：

• 任务状态更新时，旧消息未同步更改，用户需手动查找最新信息。
• 频繁的消息推送可能引起用户反感，降低工作效率。

为解决这一问题，开发者需要结合飞书的交互式组件与“更新消息”API设计解决方案。

2. 技术分析：实现动态更新的核心方法

要实现动态更新效果，可以采用以下两种主要方法：

1. 通过唯一标识（如任务ID）控制消息内容： 在前端展示时利用飞书交互式组件（如按钮或选择器）触发回调接口，重新发送更新后的内容并替换旧消息。
2. 结合飞书提供的“更新消息”API： 使用独立授权定位具体消息并修改其内容。

以下是具体技术细节：

方法	优点	限制
唯一标识+回调接口	无需额外权限，适合简单场景	无法真正修改原消息，仅能覆盖显示
“更新消息”API	可直接修改原消息，用户体验更佳	需要独立授权，涉及权限配置与有效期限制

3. 实现步骤：代码示例与流程图

以下是基于“更新消息”API的实现步骤：

1. 获取目标消息的message_id。
2. 调用“更新消息”API，传入新的卡片内容。
3. 确保回调逻辑稳定，避免数据不一致。

代码示例如下：

import requests

def update_message(message_id, new_card_content, token):
    url = f"https://open.feishu.cn/open-apis/im/v1/messages/{message_id}/update"
    headers = {
        "Authorization": f"Bearer {token}",
        "Content-Type": "application/json; charset=utf-8"
    }
    payload = {
        "msg_type": "interactive",
        "content": new_card_content
    }
    response = requests.post(url, headers=headers, json=payload)
    return response.json()
    

以下是实现流程的Mermaid格式流程图：

graph TD;
            A[开始] --> B{是否需要更新消息};
            B --是--> C[获取message_id];
            C --> D[调用更新消息API];
            D --> E[返回结果];
            B --否--> F[结束];