微信小程序 setTyping
作者: --时间: 2022-09-29
阅读量：
微信小程序 setTyping简介
下发客服当前输入状态给用户，是一种在小程序中使用的服务端API。它支持HTTPS调用和云调用两种调用方式。在使用时需要注意一些参数的填写以及不同错误码所对应的情况。
HTTPS调用方式
1.请求地址
该接口通过POST方法发送，请求地址为"https://api.weixin.qq.com/cgi-bin/message/custom/typing?access_token=ACCESS_TOKEN"。其中，"ACCESS_TOKEN"需要填写开发者的接口调用凭证。
2.请求参数
(1) access_token：string类型，接口调用凭证，必填项。
(2) touser：string类型，用户的OpenID，必填项。
(3) command：string类型，命令，必填项。
command字段的合法值如下：
Typing：表示对用户下发“正在输入”状态。
CancelTyping：表示取消对用户的“正在输入”状态。
3.返回值
返回的JSON数据包含errcode和errmsg两个属性，其中errcode表示错误码，errmsg表示错误信息。合法的errcode值见表格。
4.请求示例
以下是一个请求示例：
{
"touser": "OPENID",
"command": "Typing"
}
云调用方式
1.接口方法
使用云调用，可以在云函数中使用小程序·云开发访问开放接口的能力。具体而言，可通过wx-server-sdk来使用setTyping接口。
```
openapi.customerServiceMessage.setTyping
```
2.请求参数
(1)touser：string类型，用户的OpenID，必填项。
(2)command：string类型，命令，必填项。
command字段的合法值如下：
Typing：表示对用户下发“正在输入”状态。
CancelTyping：表示取消对用户的“正在输入”状态。
3.返回值
返回的JSON数据包含errCode和errMsg两个属性，其中errCode表示错误码，errMsg表示错误信息。合法的errCode值为0。
4.异常情况
使用云调用时，若出现异常情况，则会抛出一个异常，其中包含errCode和errMsg两个属性。合法的errCode值见表格。
5.请求示例
以下是一个请求示例：
```
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
}
}
```
微信小程序setTyping使得开发者能够更好的控制用户界面，提升用户体验。我们的小程序开发公司提供丰富的开发经验和专业技术来帮助各大企业快速搭建自己的小程序应用，欢迎与我们联系。
