文档反馈官招募中，报名立赚积分兑换代金券！> HOT
文档中心>即时通信 IM>智能客服（Desk）>服务端配置>服务端 API>快捷回复相关接口>添加快捷回复分类

添加快捷回复分类

最近更新时间：2025-06-17 11:36:01

我的收藏

本页目录：

接口调用说明

添加快捷回复分类，支持配置分类名称和分类的使用范围，分类名称不可重复，可见范围可以配置全员可见，指定技能组可见，指定成员可见，添加完成后可在对应分类下添加具体快捷回复用于可见的客服人员工作台使用。

请求 URL 示例

https://console.tim.qq.com/v4/desk_http_svc/add_quick_reply_group?sdkappid=88888888&identifier=admin&usersig=xxx&random=99999999&contenttype=json

请求参数说明

下表仅列出调用本接口时涉及修改的参数及其说明，更多参数详情请参见 REST API 简介。
参数
说明
v4/desk_http_svc/add_quick_reply_group
请求接口。
sdkappid
创建应用时即时通信 IM 控制台分配的 SDKAppID。
identifier
必须为 App 管理员账号，更多详情请参见 App 管理员。
usersig
App 管理员账号生成的签名，具体操作请参见 生成 UserSig。
random
请输入随机的32位无符号整数，取值范围0 - 4294967295。
contenttype
请求格式固定值为json。

请求包示例

{
    "GroupName": "售前话术",
    "UseScopeType": "groups",
    "UseScopeList": [
        "4305",
        "4306"
    ]
}

请求包字段说明

字段
类型
属性
说明
GroupName
String
必填
分类名称。
UseScopeType
String
必填
分类的使用范围类型：
all：全部成员可见。
groups：指定技能组成员可见。
members：指定成员可见。
UseScopeList
Array
选填
使用范围类型为全部成员可见时不填。
使用范围类型为指定技能组成员可见时为指定的技能组 ID 列表。
使用范围类型为指定成员可见时为指定的成员 ID （邮箱/账号）列表。

应答包体示例

{
    "ActionStatus": "OK",
    "ErrorInfo": "",
    "ErrorCode": 0,
    "GroupId": "2205"
}

应答包字段说明

字段
类型
说明
ErrorCode
Integer
错误码：
0表示成功。
非0表示失败。
ErrorInfo
String
错误信息。
ActionStatus
String
请求处理的结果。
GroupId
String
分类ID（可按分类ID查该分类下的快捷回复列表）

错误码说明

除非发生网络错误（例如502错误），否则该接口的 HTTP 返回码均为200。真正的错误码，错误信息是通过应答包体中的 ErrorCode、ErrorInfo 来表示的。
公共错误码（60000到79999）参见 错误码 文档。
本 API 私有错误码如下：
错误码
描述
141000
该应用非智能客服应用。
141002
内部错误，请重试。
141004
参数非法。

接口调试工具

通过 REST API 在线调试工具 调试本接口。

中国站
目录