设置小程序群待办

将小程序消息设置为群待办，或撤回已设置的小程序群待办。

接口地址： POST /roomAppTodo

前置条件

• 微信实例已登录，并已获得可用的 wId。
• 当前微信实例仍在目标群聊中，并具备设置群待办权限。
• 已收到目标小程序消息，并从消息回调中取得 newMsgId、title、pagePath、userName、sendWcId。
• 撤回群待办时需要传入设置待办成功后返回的 sign。

请求参数

参数名	必选	类型	说明
wId	是	string	登录实例标识
chatRoomId	是	string	群 ID
newMsgId	是	int	小程序消息 ID，从消息回调中获取
title	是	string	小程序标题，从消息回调中获取
pagePath	是	string	小程序跳转地址，从消息回调中获取
userName	是	string	小程序 ID，从消息回调中获取
sendWcId	是	string	原小程序发送者 ID，从消息回调中获取
sign	否	int	撤回时必传；设置待办成功后返回本字段

响应参数

参数名	类型	说明
code	string	1000 成功，1001 失败
message	string	反馈信息
data	object/null	成功时可能返回撤回所需信息，失败时通常为空
sign	int	撤销密钥，设置待办成功后用于后续撤回

请求示例

{
  "wId": "2c7a5bf6-e23d-4fb0-8f03-b9ae844b539f",
  "chatRoomId": "25553320410@chatroom",
  "newMsgId": 128659030295046943,
  "title": "寄快递，用圆通",
  "pagePath": "pages/tabBar/index/index.html?sampshare=...",
  "userName": "gh_f9d9fca26a50@app",
  "sendWcId": "wxid_ylxtflc0p8b22"
}

成功响应

{
  "message": "成功",
  "code": "1000",
  "data": null
}

错误响应

{
  "message": "失败",
  "code": "1001",
  "data": null
}

使用建议

• 小程序待办依赖原始小程序消息回调字段，建议后端完整保存回调数据。
• 业务系统应保存设置待办成功后返回的 sign，否则后续无法撤回该待办。
• 设置前请确认小程序消息本身适合作为群待办，避免对群成员造成干扰。