Background


As of 8th Oct 2024, Exotel has changed the Call Recording URL access from public to private and enabled access through any of the following two mechanisms:

  1. Authentication through API Key & API Token

  2. Client IP Whitelisting


What’s New?

We are introducing another mechanism to access Call Recording URLs through the Signed URL approach. It is an account level feature and once enabled will start sending an extra parameter of “PreSignedRecordingUrl” which will contain the Signed Recording URL, in the API response of GET Call Details API and GET Bulk Call Details API. The signed recording URL will have a TTL (time to live) associated with it and allow access to the signed recording URLs for a limited time period. By default, this will be set to 5 minutes at the account level. This value can be modified between 5 minutes to 60 minutes at the time of enabling the feature for a particular account.


How To Modify TTL At Per API Request Level?

In order to give granular control at the API request level, we have introduced a new query parameter in GET Call Details API and GET Bulk Call Details API - “RecordingUrlValidity”

This query parameter accepts an integer value equal to or between 5 and 60, and overrides the account level configuration. For the “PreSignedRecordingUrl” returned in the API response, the TTL will be set to the value passed in the “RecordingUrlValidity” parameter.



Parameter Name

Description

Value Accepted

Exceptions

RecordingUrlValidity

This parameter will return a PreSignedRecordingUrl in the response for both the GET Bulk Call Detail and GET Call Detail APIs, with the TTL specified in minutes.

Max Value that can specified is 60 i.e 1 Hr

Default Value: 5 mins (if the parameter is not specified)

An Integer equal to or between 5 and 60

If the value is greater than 60 or less than 5 then it will return a 4XX Error


How To Enable?

Talk to your Account Director or CXM and get it enabled.

Alternatively, raise a request to hello@exotel.com 


Important Note

  • The RecordingUrl parameter contains the call recording URL which will continue to be accessed only through either Authentication (API Key & API Token) or IP Whitelisting. 

  • The PreSignedRecordingUrlthe  parameter contains the same call recording but with a Signed URL, accessible for a time period equivalent to default TTL or the one set in the API request through the parameter PreSignedRecordingUrlValidity.


Additional Resources


For Addtional queries, please reach out to hello@exotel.com.