Talk API:使用删除记录端点
你可以使用删除记录端点在Talk API以编程方式删除呼叫记录从任何您的票。本教程向您展示如何使用Delete Recording端点删除呼叫记录。
需求
亚博Zendesk支持
确保您被授权在您的Zendesk支持帐户中使用API。亚博要了解有关访问API的更多信息,请参见启用密码或令牌访问在支持帮助中心。如果您不是支持管理员,请请求一个管理员给您访问API的权限。
一旦获得了授权凭证(电子邮件和密码或API令牌),就可以开始发出API请求了。
邮递员
本教程使用Postman发出API请求。如果你不使用Postman,你可以从网站上下载Windows或macOS的免费应用程序邮递员的网站.
确保在Postman中为您的请求指定Zendesk授亚博权凭证。看到授权邮差医生。
免责声明:亚博Zendesk不能为第三方技术提供支持,比如Postman。
删除通话录音
删除通话录音包括识别包含该录音的票据评论,识别该评论中的录音,然后删除该录音。
在您的帐户中确定包含录音的票据。它应该以语音评论的形式出现在票务中。例子:
注意web浏览器地址中票证URL中的票证id:
https://yoursubdomain.亚博zendesk.com/agent/tickets/ {ticket_id}
使用票据id检索票据注释。
在Postman中,向对象发出GET请求评论列表端点:
https:// {yoursubdomain}亚博 .zendesk.com/api/v2/tickets/ {ticket_id} / comments.json
例子:
在本例中,票据id 23213427被指定为路径变量。
端点返回JSON数据,其中包含与此票据相关的所有注释元数据,包括
call_id
标识记录的属性:{
“id”:686093776271,
“类型”:“VoiceComment”,
“公共”:真正的,
“数据”:{
“从”:"***********",
”到“:"*********",
“recording_url”:“https://yoursubdomain.亚博zendesk.com/api/v2/channels/voice/calls/CA13d7382d3624c770481166c98720ed7f/twilio/recording”,
“call_id”:360507728571,
“call_duration”:458,
…
在这个例子中,
call_id
是360507728571。的值
call_id
在包含录音的评论中。使用呼叫id和删除记录端点删除记录。
要做到这一点,在Postman中选择DELETE方法并ping DELETE Recording端点:
https://{yoursubdomain}.亚博.com/api/v2/渠道/的声音/调用/360507728571/录音.json
例子:
用您自己的值替换子域和呼叫id。
确保从左侧的方法下拉菜单中选择DELETE。
在点击发送,您将在Postman的Response窗口中得到消息已被删除的确认。
有关更多信息,请参见删除记录在Talk API参考文档中。
删除通话类型记录
一个呼叫可以有两个与之关联的录音。这两个录音将具有不同的类型,您可以从语音评论负载中检索这些类型,然后使用它们删除其中一个评论。
按类型删除通话记录
按照前一节中的步骤1-3进行操作。语音注释应该包含
recording_type
财产和call_id
.请注意在2020年1月10日之前创建的语音评论将不会有
recording_type
财产。对于这些注释,请按照上一节“删除通话记录”中的方法进行操作。的值
call_id
和recording_type
在包含录音的评论中。向……提出请求删除记录端点,使用
call_id
和recording_type
值。在Postman中,选择DELETE方法并将DELETE Recording端点粘贴到地址字段中。例子:
https:// {yoursubdomain}亚博 .zendesk.com/api/v2/channels/voice/calls/ {call_id} /记录/ {recording_type} . json
用您自己的值替换子域、call_id和recording_type。
在点击发送,您将在Response窗口中得到消息已被删除的确认。