当用户和小程序客服产生特定动作的交互时(具体动作列表请见下方说明),微信将会把消息数据推送给开发者,开发者可以在一段时间内(目前修改为48小时)调用客服接口,通过POST一个JSON数据包来发送消息给普通用户。此接口主要用于客服等有人工消息处理环节的功能,方便开发者为用户提供更加优质的服务。
目前允许的动作列表如下,不同动作触发后,允许的客服接口下发消息条数和下发时限不同。下发条数达到上限后,会收到错误返回码,具体请见返回码说明页:
用户动作 | 允许下发条数限制 | 下发时限 |
---|---|---|
用户通过客服消息按钮进入会话 | 1条 | 1分钟 |
用户发送信息 | 5条 | 48小时 |
接口调用请求说明
http请求方式: POST
https://api.weixin.qq.com/cgi-bin/message/custom/send?access_token=ACCESS_TOKEN
各消息类型所需的JSON数据包如下:
发送文本消息
{
"touser":"OPENID",
"msgtype":"text",
"text":
{
"content":"Hello World"
}
}
发送图片消息
{
"touser":"OPENID",
"msgtype":"image",
"image":
{
"media_id":"MEDIA_ID"
}
发送图文链接
每次可以发送一个图文链接
{
"touser": "OPENID",
"msgtype": "link",
"link": {
"title": "Happy Day",
"description": "Is Really A Happy Day",
"url": "URL",
"thumb_url": "THUMB_URL"
}
}
参数说明
参数 | 是否必须 | 说明 |
---|---|---|
access_token | 是 | 调用接口凭证 |
touser | 是 | 普通用户(openid) |
msgtype | 是 | 消息类型,文本为text,图文链接为link |
content | 是 | 文本消息内容 |
media_id | 是 | 发送的图片的媒体ID,通过新增素材接口上传图片文件获得。 |
title | 是 | 图文链接消息标题 |
description | 是 | 图文链接消息 |
url | 是 | 图文链接消息被点击后跳转的链接 |
picurl | 是 | 图文链接消息的图片链接,支持 JPG、PNG 格式,较好的效果为大图 640 X 320,小图 80 X 80 |
返回码说明
参数 | 说明 |
---|---|
-1 | 系统繁忙,此时请开发者稍候再试 |
0 | 请求成功 |
40001 | 获取access_token时AppSecret错误,或者access_token无效。请开发者认真比对AppSecret的正确性,或查看是否正在为恰当的小程序调用接口 |
40002 | 不合法的凭证类型 |
40003 | 不合法的OpenID,请开发者确认OpenID否是其他小程序的OpenID |
45015 | 回复时间超过限制 |
45047 | 客服接口下行条数超过上限 |
48001 | api功能未授权,请确认小程序已获得该接口 |
KESION 科汛软件
KESION 科汛软件是国内领先的在线教育软件及私域社交电商软件服务提供商,长期专注于为企业提供在线教育软件及社交电商SaaS平台解决方案。
公司核心产品云开店SaaS社交电商服务平台、在线教育SaaS服务平台、教育企业数字化SaaS云平台、企微营销助手、私有化独立部署品牌网校和在线教育咨询等。KESION 不断通过技术创新,提供产品和服务,助力企业向数字化转型,通过科技驱动商业革新,让商业变得更智慧!
微信公众号可以更新注册主体及主体类型,但如果你在公众平台查看小程序的主体类型,微信会提示主体类型和名称不可修改。...
距离2018年狗年春节逐渐接近,感觉有一大波红包向自己走来,今年红包又会有什么新的玩法,包你说小程序预计会在今年年尾火一阵。...