企业微信引用消息的实现与配置

提升上下文回复体验，确保复杂对话中的信息关联与对齐

能力介绍

引用消息能力允许企业通过 API 在发送新消息时，关联并展示此前的一条历史消息作为上下文。该功能的核心价值在于清晰地界定回复对象，避免在多人群聊或长对话中产生信息错位。支持引用文本、图片、文件等多种历史消息类型，并在当前下发的消息下方以灰色缩略框形式呈现引用内容。

10 分钟接入 Demo

获取被引用消息 ID ：从回调事件或消息历史记录中提取目标消息的 msgid。
构建引用对象 ：在发送消息的 JSON 结构中增加 quote 字段。
确定发送目标 ：设置 touser（成员）或 chat_id（群聊）。
接口调用 ：通过 POST 方式请求消息发送接口（如 message/send 或 externalcontact/groupchat/send）。
展示校验：在企微客户端确认引用样式是否正确渲染。

API 示例代码

以下为在群聊中发送带引用的文本消息示例（Python）：

python 复制代码

import requests
import json

def send_quote_message(access_token, chat_id, content, quote_msgid):
    url = f"https://qyapi.weixin.qq.com/cgi-bin/externalcontact/groupchat/send?access_token={access_token}"
    payload = {
        "chat_id": chat_id,
        "msgtype": "text",
        "text": {
            "content": content
        },
        "quote": {
            "msgid": quote_msgid # 被引用的消息ID
        }
    }
    response = requests.post(url, data=json.dumps(payload))
    return response.json()

# 调用示例
# result = send_quote_message("TOKEN", "wrOgQhDgAAxxx", "确认收到，已在处理。", "MSG_ID_123456")

使用场景说明

客服精准答复：针对客户在群内提出的特定问题（如某个订单咨询），通过引用该问题进行答复，增强逻辑连续性。
业务流程确认：在审批流或任务协作中，引用之前的任务指令或文件，明确针对哪项内容作出的反馈。
群聊热点追溯：在讨论热烈的外部群中，针对早前的关键提问进行回溯式解答，防止回复被淹没。
纠错与更正：引用之前发送的错误信息，并紧随其后发布正确版本，方便用户对比核实。

FAQ

Q：引用消息支持跨群引用吗？
- A：不支持。被引用的消息必须存在于当前发送消息的会话（同一群聊或同一单聊）中。
Q：可以引用图片或文件吗？
- A：可以。只要能获取到对应消息的 msgid，无论该消息是文本、图片还是文件，均可作为引用对象。
Q：引用内容有长度限制吗？
- A：引用部分通常由系统自动截取前两行或缩略展示，完整内容需用户点击引用框跳转查看。

引导入口

查看 API 文档

访问企微官网