微信小程序 setTyping

2022-05-10 16:26 更新

customerServiceMessage.setTyping

本接口應(yīng)在服務(wù)器端調(diào)用,詳細(xì)說(shuō)明參見(jiàn)服務(wù)端API。
本接口支持云調(diào)用。需開(kāi)發(fā)者工具版本 >= 1.02.1904090(最新穩(wěn)定版下載
wx-server-sdk >= 0.4.0

下發(fā)客服當(dāng)前輸入狀態(tài)給用戶(hù)。詳見(jiàn) 客服消息輸入狀態(tài)

調(diào)用方式:

  • HTTPS 調(diào)用
  • 云調(diào)用

HTTPS 調(diào)用

請(qǐng)求地址

POST https://api.weixin.qq.com/cgi-bin/message/custom/typing?access_token=ACCESS_TOKEN

請(qǐng)求參數(shù)

屬性 類(lèi)型 默認(rèn)值 必填 說(shuō)明
access_token string 接口調(diào)用憑證
touser string 用戶(hù)的 OpenID
command Strign 命令

command 的合法值

說(shuō)明 最低版本
Typing 對(duì)用戶(hù)下發(fā)"正在輸入"狀態(tài)
CancelTyping 取消對(duì)用戶(hù)的"正在輸入"狀態(tài)

返回值

Object

返回的 JSON 數(shù)據(jù)包

屬性 類(lèi)型 說(shuō)明
errcode number 錯(cuò)誤碼
errmsg string 錯(cuò)誤信息

errcode 的合法值

說(shuō)明 最低版本
45072 command字段取值不對(duì)
45080 下發(fā)輸入狀態(tài),需要之前30秒內(nèi)跟用戶(hù)有過(guò)消息交互
45081 已經(jīng)在輸入狀態(tài),不可重復(fù)下發(fā)

請(qǐng)求示例

{
  "touser": "OPENID",
  "command": "Typing"
   }

云調(diào)用

云調(diào)用是小程序·云開(kāi)發(fā)提供的在云函數(shù)中調(diào)用微信開(kāi)放接口的能力,需要在云函數(shù)中通過(guò) wx-server-sdk 使用。

接口方法

openapi.customerServiceMessage.setTyping
需在 config.json 中配置 customerServiceMessage.setTyping API 的權(quán)限,詳情

請(qǐng)求參數(shù)

屬性 類(lèi)型 默認(rèn)值 必填 說(shuō)明
touser string 用戶(hù)的 OpenID
command Strign 命令

command 的合法值

說(shuō)明 最低版本
Typing 對(duì)用戶(hù)下發(fā)"正在輸入"狀態(tài)
CancelTyping 取消對(duì)用戶(hù)的"正在輸入"狀態(tài)

返回值

Object

返回的 JSON 數(shù)據(jù)包

屬性 類(lèi)型 說(shuō)明
errCode number 錯(cuò)誤碼
errMsg string 錯(cuò)誤信息

errCode 的合法值

說(shuō)明 最低版本
0 成功

異常

Object

拋出的異常

屬性 類(lèi)型 說(shuō)明
errCode number 錯(cuò)誤碼
errMsg string 錯(cuò)誤信息

errCode 的合法值

說(shuō)明 最低版本
45072 command字段取值不對(duì)
45080 下發(fā)輸入狀態(tài),需要之前30秒內(nèi)跟用戶(hù)有過(guò)消息交互
45081 已經(jīng)在輸入狀態(tài),不可重復(fù)下發(fā)

請(qǐng)求示例

const cloud = require('wx-server-sdk')
cloud.init()
exports.main = async (event, context) => {
  try {
    const result = await cloud.openapi.customerServiceMessage.setTyping({
        touser: 'OPENID',
        command: 'Typing'
      })
    return result
  } catch (err) {
    return err
  }
}


以上內(nèi)容是否對(duì)您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

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

編程獅公眾號(hào)