After a task has been completed, Opkit allows you to download recordings and transcripts of each call made for a task. In this guide, you’ll learn how to interact with the Opkit API to retrieve recordings and transcripts.

Step by Step

To find all associated calls related to a task, you can make a GET request to the following endpoint: https://api.opkit.co/v1/calls?task_id=[task-id].

curl -X GET https://api.opkit.co/v1/calls?task_id=[task-id] \ -H "Authorization: Bearer [api_key]"

Be sure to replace [api_key] and [task-id] with their respective values.

The GET request will return a response that includes information about the call(s), including recording_download_url and transcript_download_url. These are direct links from where you can download the call recording and transcript respectively.

{
  "id": "22273f8d-4d6d-4311-9456-de7ed4f3603e",
  "created_at": "2023-10-31T23:39:25Z",
  "task_id": [task-id],
  "status": "success",
  "finished_at": "2023-11-01T02:39:25Z",
  "recording_download_url": "https://opkit-recordings-prod.s3-east-1.amazonaws.com/XXXXXXXXXXXXX",
  "transcript_download_url": "https://opkit-transcripts-prod.s3-east-1.amazonaws.com/YYYYYYYYYYYYY"
}

The provided recording_download_url and transcript_download_url are pre-signed S3 URLs that will expire in 1 hour. Make sure to download your files promptly after making the request.

The recording_download_url and transcript_download_url can be opened in any web browser or fetched programatically to download the respective files.