Upload Files & Recordings

Once you have created a use case, you can upload call recordings, chat transcripts, and reference documents.

Because audio files can be large, Vozzo Call Intel uses a Direct-to-S3 architecture. This means your frontend application uploads the file directly to our cloud storage bucket rather than sending it through our backend API. This drastically improves upload speeds and reliability.

We use Upload Sessions (STS) for this.

Create Upload Session (Recommended for SDKs)

The create_upload_session endpoint generates temporary AWS STS (Security Token Service) credentials. You can use these temporary credentials in your frontend application (using the AWS SDK) to securely upload files directly to the designated S3 folder.

Endpoint POST {{baseUrl}}/v1alpha/callintel/org-usecases/recording/create_upload_session

Headers

• Authorization: Bearer YOUR_JWT_TOKEN
• Content-Type: application/json

1. Request Temporary Credentials

Send a request from your backend or frontend to get the credentials.

Code
 
// POST Request Body
{
  "org_uuid": "33bbb237-6256-4c81-b423-a5bd16af5a32",
  "usecase_uuid": "815545c1-61c1-4ec7-aa14-365a07909937"
}

Response Example

Code
 
{
  "AccessKeyId": "ASIA...",
  "SecretAccessKey": "...",
  "SessionToken": "...",
  "Expiration": "2025-12-04T10:15:00+00:00",
  "Bucket": "vozzo-call-intel-dev",
  "FolderPrefix": "33bbb237-6256-4c81-b423-a5bd16af5a32/815545c1-61c1-4ec7-aa14-365a07909937/recordings/"
}

2. Frontend Implementation (React/Next.js)

Once you have the credentials, use the @aws-sdk/client-s3 library to perform the upload.

Code
 
import { S3Client, PutObjectCommand } from "@aws-sdk/client-s3";

async function uploadWithSession(file, sessionResponse) {
  // 1. Initialize the S3 Client with the temporary credentials
  const s3Client = new S3Client({
    region: "ap-south-1", // Ensure this matches your expected region
    credentials: {
      accessKeyId: sessionResponse.AccessKeyId,
      secretAccessKey: sessionResponse.SecretAccessKey,
      sessionToken: sessionResponse.SessionToken,
    },
  });

  // 2. Construct the exact file path (Key)
  // Combine the allowed FolderPrefix with your chosen file name
  const fileKey = `${sessionResponse.FolderPrefix}${Date.now()}-${file.name}`;

  // 3. Prepare the upload command
  const command = new PutObjectCommand({
    Bucket: sessionResponse.Bucket,
    Key: fileKey,
    Body: file,
    ContentType: file.type, 
  });

  try {
    // 4. Execute the upload directly to S3
    await s3Client.send(command);
    console.log("Upload successful!");
    return fileKey; // Save this key in your database if needed
  } catch (error) {
    console.error("Error uploading to S3:", error);
    throw error;
  }
}