微信小程序API 發(fā)送客服消息

2022-05-10 16:02 更新

發(fā)送客服消息


當用戶和小程序客服產(chǎn)生特定動作的交互時(具體動作列表請見下方說明),微信將會把消息數(shù)據(jù)推送給開發(fā)者,開發(fā)者可以在一段時間內(nèi)(目前修改為48小時)調(diào)用客服接口,通過POST一個JSON數(shù)據(jù)包來發(fā)送消息給普通用戶。此接口主要用于客服等有人工消息處理環(huán)節(jié)的功能,方便開發(fā)者為用戶提供更加優(yōu)質(zhì)的服務。

目前允許的動作列表如下,不同動作觸發(fā)后,允許的客服接口下發(fā)消息條數(shù)和下發(fā)時限不同。下發(fā)條數(shù)達到上限后,會收到錯誤返回碼,具體請見返回碼說明頁:

用戶動作允許下發(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的正確性,或查看是否正在為恰當?shù)男〕绦蛘{(diào)用接口
40002不合法的憑證類型
40003不合法的OpenID,請開發(fā)者確認OpenID否是其他小程序的OpenID
45015回復時間超過限制
45047客服接口下行條數(shù)超過上限
48001api功能未授權(quán),請確認小程序已獲得該接口
以上內(nèi)容是否對您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號