注冊

微信小程序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ù)達到上限后,會收到錯誤返回碼,具體請見返回碼說明頁:

微信小程序API發(fā)送客服消息,用于小程序客服等有人工消息處理

用戶動作 允許下發(fā)條數(shù)限制 下發(fā)時限
用戶通過客服消息按鈕進入會話 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 圖文鏈接消息標題
description 圖文鏈接消息
url 圖文鏈接消息被點擊后跳轉(zhuǎn)的鏈接
picurl 圖文鏈接消息的圖片鏈接,支持 JPG、PNG 格式,較好的效果為大圖 640 X 320,小圖 80 X 80

 

返回碼說明

參數(shù) 說明
-1 系統(tǒng)繁忙,此時請開發(fā)者稍候再試
0 請求成功
40001 獲取access_token時AppSecret錯誤,或者access_token無效。請開發(fā)者認真比對AppSecret的正確性,或查看是否正在為恰當(dāng)?shù)男〕绦蛘{(diào)用接口
40002 不合法的憑證類型
40003 不合法的OpenID,請開發(fā)者確認OpenID否是其他小程序的OpenID
45015 回復(fù)時間超過限制
45047 客服接口下行條數(shù)超過上限
48001 api功能未授權(quán),請確認小程序已獲得該接口
更多微信小程序開發(fā)教程,可以關(guān)注hi小程序。
重磅推薦:小程序開店目錄

第一部分:小商店是什么

第二部分:如何開通一個小商店

第三部分:如何登錄小商店

第四部分:開店任務(wù)常見問題

第五部分:小商店可以賣什么

第六部分:HiShop小程序特色功能

第七部分:小程序直播

第八部分:小程序收貨/物流

第九部分:小程序怎么結(jié)算

第十部分:小程序客服

第十一部分:電商創(chuàng)業(yè)

第十二部分:小程序游戲開發(fā)