Talk API:使用删除记录端点

你可以使用删除记录端点在Talk API以编程方式删除呼叫记录从任何您的票。本教程向您展示如何使用Delete Recording端点删除呼叫记录。

需求

亚博Zendesk支持

确保您被授权在您的Zendesk支持帐户中使用API。亚博要了解有关访问API的更多信息,请参见启用密码或令牌访问在支持帮助中心。如果您不是支持管理员,请请求一个管理员给您访问API的权限。

一旦获得了授权凭证(电子邮件和密码或API令牌),就可以开始发出API请求了。

邮递员

本教程使用Postman发出API请求。如果你不使用Postman,你可以从网站上下载Windows或macOS的免费应用程序邮递员的网站

确保在Postman中为您的请求指定Zendesk授亚博权凭证。看到授权邮差医生。

免责声明:亚博Zendesk不能为第三方技术提供支持,比如Postman。

删除通话录音

删除通话录音包括识别包含该录音的票据评论,识别该评论中的录音,然后删除该录音。

  1. 在您的帐户中确定包含录音的票据。它应该以语音评论的形式出现在票务中。例子:

  2. 注意web浏览器地址中票证URL中的票证id:

    https://yoursubdomain.亚博zendesk.com/agent/tickets/ {ticket_id}

  3. 使用票据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。

  4. 的值call_id在包含录音的评论中。

  5. 使用呼叫id和删除记录端点删除记录。

    要做到这一点,在Postman中选择DELETE方法并ping DELETE Recording端点:

                   
    https//{yoursubdomain亚博com/api/v2/渠道/的声音/调用/360507728571/录音json

    例子:

    用您自己的值替换子域和呼叫id。

    确保从左侧的方法下拉菜单中选择DELETE。

在点击发送,您将在Postman的Response窗口中得到消息已被删除的确认。

有关更多信息,请参见删除记录在Talk API参考文档中。

删除通话类型记录

一个呼叫可以有两个与之关联的录音。这两个录音将具有不同的类型,您可以从语音评论负载中检索这些类型,然后使用它们删除其中一个评论。

按类型删除通话记录

  1. 按照前一节中的步骤1-3进行操作。语音注释应该包含recording_type财产和call_id

    请注意在2020年1月10日之前创建的语音评论将不会有recording_type财产。对于这些注释,请按照上一节“删除通话记录”中的方法进行操作。

  2. 的值call_idrecording_type在包含录音的评论中。

  3. 向……提出请求删除记录端点,使用call_idrecording_type值。

    在Postman中,选择DELETE方法并将DELETE Recording端点粘贴到地址字段中。例子:

    https:// {yoursubdomain}亚博 .zendesk.com/api/v2/channels/voice/calls/ {call_id} /记录/ {recording_type} . json

    用您自己的值替换子域、call_id和recording_type。

    在点击发送,您将在Response窗口中得到消息已被删除的确认。