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

2022-05-10 16:02 更新

發(fā)送客服消息


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

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

用戶動(dòng)作允許下發(fā)條數(shù)限制下發(fā)時(shí)限
用戶通過客服消息按鈕進(jìn)入會(huì)話1條1分鐘
用戶發(fā)送信息5條48小時(shí)

客服接口-發(fā)消息

接口調(diào)用請(qǐng)求說明

http請(qǐng)求方式: 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ā)送一個(gè)圖文鏈接

{

    "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)繁忙,此時(shí)請(qǐng)開發(fā)者稍候再試
0請(qǐng)求成功
40001獲取access_token時(shí)AppSecret錯(cuò)誤,或者access_token無效。請(qǐng)開發(fā)者認(rèn)真比對(duì)AppSecret的正確性,或查看是否正在為恰當(dāng)?shù)男〕绦蛘{(diào)用接口
40002不合法的憑證類型
40003不合法的OpenID,請(qǐng)開發(fā)者確認(rèn)OpenID否是其他小程序的OpenID
45015回復(fù)時(shí)間超過限制
45047客服接口下行條數(shù)超過上限
48001api功能未授權(quán),請(qǐng)確認(rèn)小程序已獲得該接口
以上內(nèi)容是否對(duì)您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號(hào)
微信公眾號(hào)

編程獅公眾號(hào)