微信小程序API發送客服消息,用于小程序客服等有人工消息處理
2020-09-27
導讀:發送客服消息 當用戶和小程序客服產生特定動作的交互時(具體動作列表請見下方說明),微信將會把消息數據推送給開發者,開發者可以在一段時間內(目前修改為48小時)調用客服...
發送客服消息
當用戶和小程序客服產生特定動作的交互時(具體動作列表請見下方說明),微信將會把消息數據推送給開發者,開發者可以在一段時間內(目前修改為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功能未授權,請確認小程序已獲得該接口 |
第二部分:如何開通一個小商店