Recordings
Recordings are stored by Talk and exposed in the corresponding ticket in a voice comment.
JSON format
Recordings are represented as JSON objects with the following properties:
| Name | Type | Read-only | Mandatory | Description |
|---|---|---|---|---|
| call_id | number | false | true | ID of a Talk call |
| recording_type | string | false | false | Valid types arecallorvoicemail |
删除Recording
DELETE /api/v2/channels/voice/calls/{call_id}/recordings
Allowed For
- Admins
Theidparameter should be replaced with a call ID, which you can get from thecall_id财产在语音通讯ents.
Two recordings can be associated to the same call ID. This endpoint deletes all recordings associated with the call ID. To delete only a specific type of recording, see删除Recording By Type.
Parameters
| Name | Type | In | Required | Description |
|---|---|---|---|---|
| call_id | integer | Path | true | ID of a Talk call |
Code Samples
旋度
旋度https://{subdomain}.zendesk.com/api/v2/channels/voice/calls/{call_id}/recordings.json\-v -u{email_address}:{password}\-X DELETE
Go
import("fmt""io""net/http")funcmain(){url:="https://support.zendesk.com/api/v2/channels/voice/calls/900016500386/recordings"method:="DELETE"req,err:=http.NewRequest(method,url,nil)iferr!=nil{fmt.Println(err)return}req.Header.Add("Content-Type","application/json")req.Header.Add("Authorization","Basic " )// Base64 encoded "username:password"client:=&http.Client{}res,err:=client.Do(req)iferr!=nil{fmt.Println(err)return}deferres.Body.Close()body,err:=io.ReadAll(res.Body)iferr!=nil{fmt.Println(err)return}fmt.Println(string(body))}
Java
importcom.squareup.okhttp.*;OkHttpClientclient=newOkHttpClient();HttpUrl.BuilderurlBuilder=HttpUrl.parse("https://support.zendesk.com/api/v2/channels/voice/calls/900016500386/recordings").newBuilder();Requestrequest=newRequest.Builder().url(urlBuilder.build()).method("DELETE",null).addHeader("Content-Type","application/json").addHeader("Authorization",Credentials.basic("your-email","your-password")).build();Responseresponse=client.newCall(request).execute();
Nodejs
varaxios=require('axios');varconfig={method:'DELETE',url:'https://support.zendesk.com/api/v2/channels/voice/calls/900016500386/recordings',headers:{'Content-Type':'application/json','Authorization':'Basic ' ,// Base64 encoded "username:password"},};axios(config).then(function(response){console.log(JSON.stringify(response.data));}).catch(function(error){console.log(error);});
Python
importrequestsurl="https://support.zendesk.com/api/v2/channels/voice/calls/900016500386/recordings"headers={"Content-Type":"application/json",}response=requests.request("DELETE",url,auth=('' ,'' ),headers=headers)print(response.text)
Ruby
require"net/http"uri=URI("https://support.zendesk.com/api/v2/channels/voice/calls/900016500386/recordings")request=Net::HTTP::删除.new(uri,"Content-Type":"application/json")request.basic_auth"username","password"response=Net::HTTP.start uri.hostname,uri.port,use_ssl:truedo|http|http.request(request)end
Example response(s)
204 No Content
// Status 204 No Contentnull
删除Recording By Type
DELETE /api/v2/channels/voice/calls/{call_id}/recordings/{recording_type}
Allowed For
- Admins
Theidparameter should be replaced with a call ID, which you can get from thecall_id财产在语音通讯ents.
Therecording_typeis also present for Voice Comments created after January 10, 2020. For older comments, the删除recordingendpoint should be used.
Parameters
| Name | Type | In | Required | Description |
|---|---|---|---|---|
| call_id | integer | Path | true | ID of a Talk call |
| recording_type | string | Path | true | Call recording type. Allowed values are "call", or "voicemail". |
Code Samples
旋度
旋度https://{subdomain}.zendesk.com/api/v2/channels/voice/calls/{call_id}/recordings/{recording_type}.json\-v -u{email_address}:{password}\-X DELETE
Go
import("fmt""io""net/http")funcmain(){url:="https://support.zendesk.com/api/v2/channels/voice/calls/900016500386/recordings/voicemail"method:="DELETE"req,err:=http.NewRequest(method,url,nil)iferr!=nil{fmt.Println(err)return}req.Header.Add("Content-Type","application/json")req.Header.Add("Authorization","Basic " )// Base64 encoded "username:password"client:=&http.Client{}res,err:=client.Do(req)iferr!=nil{fmt.Println(err)return}deferres.Body.Close()body,err:=io.ReadAll(res.Body)iferr!=nil{fmt.Println(err)return}fmt.Println(string(body))}
Java
importcom.squareup.okhttp.*;OkHttpClientclient=newOkHttpClient();HttpUrl.BuilderurlBuilder=HttpUrl.parse("https://support.zendesk.com/api/v2/channels/voice/calls/900016500386/recordings/voicemail").newBuilder();Requestrequest=newRequest.Builder().url(urlBuilder.build()).method("DELETE",null).addHeader("Content-Type","application/json").addHeader("Authorization",Credentials.basic("your-email","your-password")).build();Responseresponse=client.newCall(request).execute();
Nodejs
varaxios=require('axios');varconfig={method:'DELETE',url:'https://support.zendesk.com/api/v2/channels/voice/calls/900016500386/recordings/voicemail',headers:{'Content-Type':'application/json','Authorization':'Basic ' ,// Base64 encoded "username:password"},};axios(config).then(function(response){console.log(JSON.stringify(response.data));}).catch(function(error){console.log(error);});
Python
importrequestsurl="https://support.zendesk.com/api/v2/channels/voice/calls/900016500386/recordings/voicemail"headers={"Content-Type":"application/json",}response=requests.request("DELETE",url,auth=('' ,'' ),headers=headers)print(response.text)
Ruby
require"net/http"uri=URI("https://support.zendesk.com/api/v2/channels/voice/calls/900016500386/recordings/voicemail")request=Net::HTTP::删除.new(uri,"Content-Type":"application/json")request.basic_auth"username","password"response=Net::HTTP.start uri.hostname,uri.port,use_ssl:truedo|http|http.request(request)end
Example response(s)
204 No Content
// Status 204 No Contentnull