微信小程序API發(fā)送客服消息,用于小程序客服等有人工消息處理
2020-09-27
導(dǎo)讀:發(fā)送客服消息 當(dāng)用戶和小程序客服產(chǎn)生特定動作的交互時(具體動作列表請見下方說明),微信將會把消息數(shù)據(jù)推送給開發(fā)者,開發(fā)者可以在一段時間內(nèi)(目前修改為48小時)調(diào)用客服...
發(fā)送客服消息
當(dāng)用戶和小程序客服產(chǎn)生特定動作的交互時(具體動作列表請見下方說明),微信將會把消息數(shù)據(jù)推送給開發(fā)者,開發(fā)者可以在一段時間內(nèi)(目前修改為48小時)調(diào)用客服接口,通過POST一個JSON數(shù)據(jù)包來發(fā)送消息給普通用戶。此接口主要用于客服等有人工消息處理環(huán)節(jié)的功能,方便開發(fā)者為用戶提供更加優(yōu)質(zhì)的服務(wù)。
目前允許的動作列表如下,不同動作觸發(fā)后,允許的客服接口下發(fā)消息條數(shù)和下發(fā)時限不同。下發(fā)條數(shù)達(dá)到上限后,會收到錯誤返回碼,具體請見返回碼說明頁:
用戶動作 | 允許下發(fā)條數(shù)限制 | 下發(fā)時限 |
---|---|---|
用戶通過客服消息按鈕進(jìn)入會話 | 1條 | 1分鐘 |
用戶發(fā)送信息 | 5條 | 48小時 |
客服接口-發(fā)消息
接口調(diào)用請求說明
http請求方式: POST
https://api.weixin.qq.com/cgi-bin/message/custom/send?access_token=ACCESS_TOKEN
各消息類型所需的JSON數(shù)據(jù)包如下:
發(fā)送文本消息
{
"touser":"OPENID",
"msgtype":"text",
"text":
{
"content":"Hello World"
}
}
發(fā)送圖片消息
{
"touser":"OPENID",
"msgtype":"image",
"image":
{
"media_id":"MEDIA_ID"
}
發(fā)送圖文鏈接
每次可以發(fā)送一個圖文鏈接
{
"touser": "OPENID",
"msgtype": "link",
"link": {
"title": "Happy Day",
"description": "Is Really A Happy Day",
"url": "URL",
"thumb_url": "THUMB_URL"
}
}
參數(shù)說明
參數(shù) | 是否必須 | 說明 |
---|---|---|
access_token | 是 | 調(diào)用接口憑證 |
touser | 是 | 普通用戶(openid) |
msgtype | 是 | 消息類型,文本為text,圖文鏈接為link |
content | 是 | 文本消息內(nèi)容 |
media_id | 是 | 發(fā)送的圖片的媒體ID,通過新增素材接口上傳圖片文件獲得。 |
title | 是 | 圖文鏈接消息標(biāo)題 |
description | 是 | 圖文鏈接消息 |
url | 是 | 圖文鏈接消息被點(diǎn)擊后跳轉(zhuǎn)的鏈接 |
picurl | 是 | 圖文鏈接消息的圖片鏈接,支持 JPG、PNG 格式,較好的效果為大圖 640 X 320,小圖 80 X 80 |
返回碼說明
參數(shù) | 說明 |
---|---|
-1 | 系統(tǒng)繁忙,此時請開發(fā)者稍候再試 |
0 | 請求成功 |
40001 | 獲取access_token時AppSecret錯誤,或者access_token無效。請開發(fā)者認(rèn)真比對AppSecret的正確性,或查看是否正在為恰當(dāng)?shù)男〕绦蛘{(diào)用接口 |
40002 | 不合法的憑證類型 |
40003 | 不合法的OpenID,請開發(fā)者確認(rèn)OpenID否是其他小程序的OpenID |
45015 | 回復(fù)時間超過限制 |
45047 | 客服接口下行條數(shù)超過上限 |
48001 | api功能未授權(quán),請確認(rèn)小程序已獲得該接口 |
第二部分:如何開通一個小商店