您可以使用API来获取或设置快捷方式信息。

请注意:帐户最多可定义15,000个快捷方式。一旦您达到了这个限制,任何创建新快捷方式的额外API调用都会导致一个错误代码429,“超过了该帐户所允许的快捷方式的数量”。

JSON格式

快捷方式表示为具有以下属性的JSON对象:

的名字 类型 只读 强制性的 描述
代理 数组 代理的快捷方式属于if范围是“代理”。目前只考虑到第一个因素
部门 数组 部门快捷方式属于if范围“部门”
id 字符串 真正的 快捷方式的唯一ID。不允许的值:"/","\","$"
消息 字符串 真正的 快捷方式的信息
的名字 字符串 真正的 快捷方式的名称。不允许的值:"/","\","$"
选项 字符串 快捷方式的选项
范围 字符串 快捷方式的适用范围。允许取值为all、agent或department。
标签 数组 如果使用快捷方式,将添加到聊天的标签列表

请注意,范围部门而且代理只有启用了这些功能的帐户才会考虑字段。

为了向后兼容,的名字等于id.使用id而不是的名字

例子

             
“id”“问题”“消息”“嗨!你需要帮助吗?”“名称”“问题”“选项”“是/否”“范围”“所有”“标签”“问题”“调查”

快捷键列表

  • GET / api / v2 /快捷方式

列出该帐户的所有快捷方式。

允许

  • 管理员

代码示例

旋度
              
旋度https://www.zopim.com/api/v2/shortcuts- v - uemail_address密码
              
进口“fmt”“输入输出”“net/http”函数主要url:=“https://support.亚博zendesk.com/api/v2/shortcuts”方法:=“获得”要求的事情犯错:=httpNewRequest方法url如果犯错! =fmtPrintln犯错返回要求的事情添加“内容类型”“application / json”客户端:=http客户端res犯错:=客户端要求的事情如果犯错! =fmtPrintln犯错返回推迟res身体关闭身体犯错:=ioReadAllres身体如果犯错! =fmtPrintln犯错返回fmtPrintln字符串身体
Java
              
进口comsquareupokhttpOkHttpClient客户端OkHttpClientHttpUrl构建器urlBuilderHttpUrl解析“https://support.亚博zendesk.com/api/v2/shortcuts”newBuilder请求请求请求构建器urlurlBuilder构建方法“获得”addHeader“内容类型”“application / json”构建响应响应客户端newCall请求执行
Nodejs
              
varaxios需要“axios”var配置方法“得到”url“https://support.亚博zendesk.com/api/v2/shortcuts”“内容类型”“application / json”axios配置然后函数响应控制台日志JSONstringify响应数据函数错误控制台日志错误
Python
              
进口请求url“https://support.亚博zendesk.com/api/v2/shortcuts”“内容类型”“application / json”响应请求请求“获得”url打印响应文本
鲁比(人名)
              
需要“net/http”uriURI“https://support.亚博zendesk.com/api/v2/shortcuts”请求HTTP得到uri“内容类型”“application / json”响应HTTP开始uri主机名uri港口use_ssl真正的|http|http请求请求结束

示例响应(年代)

200好了
              
// Status 200 OK“id”“问题”“消息”“嗨!你需要帮助吗?”“名称”“问题”“选项”“是/否”“范围”“所有”“标签”“问题”“调查”“id”“注册”“消息”“你想什么时候报名?”“名称”“注册”“选项”“现在/后”“范围”“所有”“标签”“问题”“注册”

显示快捷方式

  • GET / api / v2 /快捷方式/ {shortcut_id}

通过指定快捷方式名称返回快捷方式信息。

允许

  • 管理员

参数

的名字 类型 要求 描述
shortcut_id 整数 路径 真正的 快捷方式的ID

代码示例

旋度
              
旋度https://www.zopim.com/api/v2/shortcuts/shortcut_id- v - uemail_address密码
              
进口“fmt”“输入输出”“net/http”函数主要url:=“https://support.亚博zendesk.com/api/v2/shortcuts/1”方法:=“获得”要求的事情犯错:=httpNewRequest方法url如果犯错! =fmtPrintln犯错返回要求的事情添加“内容类型”“application / json”客户端:=http客户端res犯错:=客户端要求的事情如果犯错! =fmtPrintln犯错返回推迟res身体关闭身体犯错:=ioReadAllres身体如果犯错! =fmtPrintln犯错返回fmtPrintln字符串身体
Java
              
进口comsquareupokhttpOkHttpClient客户端OkHttpClientHttpUrl构建器urlBuilderHttpUrl解析“https://support.亚博zendesk.com/api/v2/shortcuts/1”newBuilder请求请求请求构建器urlurlBuilder构建方法“获得”addHeader“内容类型”“application / json”构建响应响应客户端newCall请求执行
Nodejs
              
varaxios需要“axios”var配置方法“得到”url“https://support.亚博zendesk.com/api/v2/shortcuts/1”“内容类型”“application / json”axios配置然后函数响应控制台日志JSONstringify响应数据函数错误控制台日志错误
Python
              
进口请求url“https://support.亚博zendesk.com/api/v2/shortcuts/1”“内容类型”“application / json”响应请求请求“获得”url打印响应文本
鲁比(人名)
              
需要“net/http”uriURI“https://support.亚博zendesk.com/api/v2/shortcuts/1”请求HTTP得到uri“内容类型”“application / json”响应HTTP开始uri主机名uri港口use_ssl真正的|http|http请求请求结束

示例响应(年代)

200好了
              
// Status 200 OK“id”“介绍”“消息”“嗨!你需要帮助吗?”“名称”“介绍”“选项”“是/否”“范围”“所有”“标签”“问题”“调查”

创建快捷方式

  • POST / api / v2 /快捷方式

向帐户添加快捷方式。

允许

  • 管理员

代码示例

旋度
              
旋度https://www.zopim.com/api/v2/shortcuts- d”{"name": "intro",“消息”:“嗨!你需要帮助吗?”"options": "Yes/No"} '- v - uemail_address密码-x post -h“application / json内容类型:
              
进口“fmt”“输入输出”“net/http”函数主要url:=“https://support.亚博zendesk.com/api/v2/shortcuts”方法:=“职位”要求的事情犯错:=httpNewRequest方法url如果犯错! =fmtPrintln犯错返回要求的事情添加“内容类型”“application / json”客户端:=http客户端res犯错:=客户端要求的事情如果犯错! =fmtPrintln犯错返回推迟res身体关闭身体犯错:=ioReadAllres身体如果犯错! =fmtPrintln犯错返回fmtPrintln字符串身体
Java
              
进口comsquareupokhttpOkHttpClient客户端OkHttpClientHttpUrl构建器urlBuilderHttpUrl解析“https://support.亚博zendesk.com/api/v2/shortcuts”newBuilderRequestBody身体RequestBody创建MediaType解析“application / json”""""请求请求请求构建器urlurlBuilder构建方法“职位”身体addHeader“内容类型”“application / json”构建响应响应客户端newCall请求执行
Nodejs
              
varaxios需要“axios”var配置方法“职位”url“https://support.亚博zendesk.com/api/v2/shortcuts”“内容类型”“application / json”axios配置然后函数响应控制台日志JSONstringify响应数据函数错误控制台日志错误
Python
              
进口请求url“https://support.亚博zendesk.com/api/v2/shortcuts”“内容类型”“application / json”响应请求请求“职位”url打印响应文本
鲁比(人名)
              
需要“net/http”uriURI“https://support.亚博zendesk.com/api/v2/shortcuts”请求HTTP帖子uri“内容类型”“application / json”响应HTTP开始uri主机名uri港口use_ssl真正的|http|http请求请求结束

示例响应(年代)

201年创建
              
//状态201已创建“id”“介绍”“消息”“嗨!你需要帮助吗?”“名称”“介绍”“选项”“是/否”“范围”“所有”“标签”

更新快捷方式

  • 把/ api / v2 /快捷方式/ {shortcut_id}

更新指定的快捷方式。

允许

  • 管理员

参数

的名字 类型 要求 描述
shortcut_id 整数 路径 真正的 快捷方式的ID

代码示例

旋度
              
旋度https://www.zopim.com/api/v2/shortcuts/shortcut_id- d”{“消息”:“嗨!你糊涂了吗?”“选项”:“是/否/肯定可能”,"tags": ["Question"]} '- v - uemail_address密码-x乘以-h“application / json内容类型:
              
进口“fmt”“输入输出”“net/http”函数主要url:=“https://support.亚博zendesk.com/api/v2/shortcuts/1”方法:=“把”要求的事情犯错:=httpNewRequest方法url如果犯错! =fmtPrintln犯错返回要求的事情添加“内容类型”“application / json”客户端:=http客户端res犯错:=客户端要求的事情如果犯错! =fmtPrintln犯错返回推迟res身体关闭身体犯错:=ioReadAllres身体如果犯错! =fmtPrintln犯错返回fmtPrintln字符串身体
Java
              
进口comsquareupokhttpOkHttpClient客户端OkHttpClientHttpUrl构建器urlBuilderHttpUrl解析“https://support.亚博zendesk.com/api/v2/shortcuts/1”newBuilderRequestBody身体RequestBody创建MediaType解析“application / json”""""请求请求请求构建器urlurlBuilder构建方法“把”身体addHeader“内容类型”“application / json”构建响应响应客户端newCall请求执行
Nodejs
              
varaxios需要“axios”var配置方法“把”url“https://support.亚博zendesk.com/api/v2/shortcuts/1”“内容类型”“application / json”axios配置然后函数响应控制台日志JSONstringify响应数据函数错误控制台日志错误
Python
              
进口请求url“https://support.亚博zendesk.com/api/v2/shortcuts/1”“内容类型”“application / json”响应请求请求“把”url打印响应文本
鲁比(人名)
              
需要“net/http”uriURI“https://support.亚博zendesk.com/api/v2/shortcuts/1”请求HTTPuri“内容类型”“application / json”响应HTTP开始uri主机名uri港口use_ssl真正的|http|http请求请求结束

示例响应(年代)

200好了
              
// Status 200 OK“id”“介绍”“消息”“嗨!你糊涂了吗?”“名称”“介绍”“选项”“是的/不/绝对可能”“范围”“所有”“标签”“问题”

删除快捷方式

  • 删除/ api / v2 /快捷方式/ {shortcut_id}

删除指定的快捷方式。

允许

  • 管理员

参数

的名字 类型 要求 描述
shortcut_id 整数 路径 真正的 快捷方式的ID

代码示例

旋度
              
旋度https://www.zopim.com/api/v2/shortcuts/shortcut_id- v - uemail_address密码- x删除
              
进口“fmt”“输入输出”“net/http”函数主要url:=“https://support.亚博zendesk.com/api/v2/shortcuts/1”方法:=“删除”要求的事情犯错:=httpNewRequest方法url如果犯错! =fmtPrintln犯错返回要求的事情添加“内容类型”“application / json”客户端:=http客户端res犯错:=客户端要求的事情如果犯错! =fmtPrintln犯错返回推迟res身体关闭身体犯错:=ioReadAllres身体如果犯错! =fmtPrintln犯错返回fmtPrintln字符串身体
Java
              
进口comsquareupokhttpOkHttpClient客户端OkHttpClientHttpUrl构建器urlBuilderHttpUrl解析“https://support.亚博zendesk.com/api/v2/shortcuts/1”newBuilder请求请求请求构建器urlurlBuilder构建方法“删除”addHeader“内容类型”“application / json”构建响应响应客户端newCall请求执行
Nodejs
              
varaxios需要“axios”var配置方法“删除”url“https://support.亚博zendesk.com/api/v2/shortcuts/1”“内容类型”“application / json”axios配置然后函数响应控制台日志JSONstringify响应数据函数错误控制台日志错误
Python
              
进口请求url“https://support.亚博zendesk.com/api/v2/shortcuts/1”“内容类型”“application / json”响应请求请求“删除”url打印响应文本
鲁比(人名)
              
需要“net/http”uriURI“https://support.亚博zendesk.com/api/v2/shortcuts/1”请求HTTP删除uri“内容类型”“application / json”响应HTTP开始uri主机名uri港口use_ssl真正的|http|http请求请求结束

示例响应(年代)

204无内容
              
//状态204无内容