2023年微信小程序API 發(fā)送客服消息
微信小程序API 發(fā)送客服消息
當(dāng)用戶與小程序客服通過特定動(dòng)作進(jìn)行交互時(shí)(具體動(dòng)作列表見下文),微信會(huì)將消息數(shù)據(jù)推送給開發(fā)者。開發(fā)者可以在一段時(shí)間內(nèi)(目前為48小時(shí))調(diào)用客服接口,通過POST一個(gè)JSON數(shù)據(jù)包來向普通用戶發(fā)送消息。該接口主要用于客服等有人工消息處理環(huán)節(jié)的功能,方便開發(fā)者向用戶提供更好的服務(wù)。
1. 動(dòng)作列表及允許下發(fā)條數(shù)和時(shí)限
目前允許的動(dòng)作列表如下,不同動(dòng)作觸發(fā)后,允許的客服接口下發(fā)消息條數(shù)和下發(fā)時(shí)限不同。達(dá)到下發(fā)條數(shù)上限后,API會(huì)返回錯(cuò)誤碼,請(qǐng)注意查看返回碼說明頁:
用戶動(dòng)作 | 允許下發(fā)條數(shù)限制 | 下發(fā)時(shí)限 |
---|---|---|
用戶通過客服消息按鈕進(jìn)入會(huì)話 | 1條 | 1分鐘 |
用戶發(fā)送信息 | 5條 | 48小時(shí) |
2. 客服接口-發(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ù)包:
2.1 發(fā)送文本消息
{
"touser":"OPENID",
"msgtype":"text",
"text": {
"content":"Hello World"
}
}
2.2 發(fā)送圖片消息
{
"touser":"OPENID",
"msgtype":"image",
"image": {
"media_id":"MEDIA_ID"
}
}
2.3 發(fā)送圖文鏈接
每次只能發(fā)送一個(gè)圖文鏈接。
{
"touser":"OPENID",
"msgtype":"link",
"link":
{
"title":"Happy Day",
"description":"Is Really A Happy Day",
"url":"URL",
"thumb_url":"THUMB_URL"
}
}
3. 參數(shù)說明
參數(shù) | 是否必須 | 說明 |
---|---|---|
access_token | 是 | 調(diào)用接口憑證 |
touser | 是 | 普通用戶(openid) |
msgtype | 是 | 消息類型,文本為text,圖文鏈接為link |
content | 是 | 文本消息內(nèi)容 |
media_id | 是 | 發(fā)送的圖片的媒體ID,通過新增素材接口上傳圖片文件獲得。 |
title | 是 | 圖文鏈接消息標(biāo)題 |