Creating a Call Recording URL

Creating a Call Recording URL

In the event that a Queue call recording needs to be accessed outside of the Insights interface, an API call can be utilized to create a URL that allows the user to download the recording. This API call can also be used for Connect calls, if a call recording exists.

Recording URLs do have an expiration time, which is an hour after the URL was created. Attempting to retrieve the file after that time will result in failure.

API - Queue Call Recording File Name

  1. First, download or access a REST Client like Postman or Insomnia.

    1. Instructions below are using Insomnia

  2. Create a new POST request to https://api.sharpencx.com/V2/queues/getInteraction/ and choose Multipart Form

  3. Add the following fields:

    1. cKey1 - Company Keys (cKeys) are available in your Sharpen instance here

    2. cKey2

    3. uKey: uKey of user with permissions on customer account (we can help get the right user ukey for you)

    4. queueCallManagerID

  4. Enter the specified values, hit Send and copy the mixmonFileName from the JSON results

API - Connect Call Recording File Name

  1. Create a new POST request to https://api.fathomvoice.com/V2/voice/cdr/getCalls/ and choose Multipart Form

  2. Add the following fields:

    1. cKey1 - again, Company Keys (cKeys) are available in your Sharpen instance here

    2. cKey2

    3. extension: user’s extension for specific call

    4. startDate: year-month-date of specific call

  3. Enter the specified values, hit Send and copy the callRecordingFile from the JSON results

     

Note that the Connect call example does not have a call recording file, meaning one was not created.

API - Temporary Recording URL

  1. Create a new POST request to https://api.fathomvoice.com/V2/aws/getObjectLink/ and choose Multipart Form

  2. Add the following fields:

    1. cKey1

    2. cKey2

    3. bucketName

    4. fileName

  3. Enter cKey values: Again, Company Keys (cKeys) are available in your Sharpen instance here

  4. Enter mixrec as the value for bucketName

  5. Enter the filename returned from the getInteraction api call above into the filename field.

  6. Execute API call and a temporary AWS URL will be returned in JSON format. You will need to remove the backslashes, \ , from the URL after you copy and paste it in a browser.

  7. This will take you to a browser with the call recording, which you can download using the 3 dots on the right