# 修改小程序聊天工具的动态卡片消息

调试工具

接口应在服务器端调用，详细说明参见服务端API。

# 接口说明

# 接口英文名

setChatToolMsg

# 功能描述

该接口用于修改被分享的小程序聊天工具的动态卡片消息。

# 调用方式

# HTTPS 调用


POST https://api.weixin.qq.com/cgi-bin/message/wxopen/chattoolmsg/send?access_token=ACCESS_TOKEN

# 请求参数

属性

类型

必填

说明

access_token

string

是

接口调用凭证，该参数为 URL 参数，非 Body 参数。使用getAccessToken

activity_id

string

是

动态消息的 ID，通过 createActivityId 接口获取

target_state

number

是

动态消息修改后的状态

template_id

string

是

模板id

participator_info_list

array<object>

否

更新后的聊天室成员状态

	属性	类型	必填	说明
	group_openid	string	是	聊天室用户的GroupOpenID
	state	number	是	用户对卡片事件的完成状态。0：未完成（初始状态），1：已完成。目前只支持设置为 1

version_type

number

是

0 正式版 1 开发版 2 体验版

# 返回参数

属性	类型	说明
errcode	number	错误码
errmsg	string	错误信息

# 调用示例

示例说明: HTTPS调用

# 请求数据示例


{
"activity_id": "966_NGiqxxxxxxxxxx...xxxxxxxxE33BlwX", 
"target_state": 1, 
"template_id": "4A68CBB88A92B0A9311848DBA1E94A199B166463",
"version_type": 0,
"participator_info_list": [
{"group_openid": "aaaaaaaaaa", 
"state": 1}, 
{"group_openid": "bbbbbbbbb", 
"state": 1}, 
] 
}

# 返回数据示例


{
"errcode": 0, 
"errmsg": "ok", 
}

# 错误码

错误码	错误描述	解决方案
42001	access_token expired	access_token 超时，请检查 access_token 的有效期，请参考基础支持 - 获取 access_token 中，对 access_token 的详细机制说明
40001	invalid credential access_token isinvalid or not latest	获取 access_token 时 AppSecret 错误，或者 access_token 无效。请开发者认真比对 AppSecret 的正确性，或查看是否正在为恰当的公众号调用接口
44002	empty post data	POST 的数据包为空。post请求body参数不能为空。
47001	data format error	解析 JSON/XML 内容错误;post 数据中参数缺失;参数需以 JSON 字符串格式写在post请求的 body 中，请检查修正后重试
47501	activity_id error	参数 activity_id 错误
40013	appid不正确，或者不符合绑定关系要求
47504	activity_id expired time	activity_id 过期
47502	target_state error	参数 target_state 错误
40097	invalid args	参数错误