AWS S3 Connector Setup Guide

​

Prerequisites

​

AWS Requirements

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": ["s3:GetObject", "s3:ListBucket"],
            "Resource": [
                "arn:aws:s3:::your-bucket-name",
                "arn:aws:s3:::your-bucket-name/*"
            ]
        }
    ]
}

​

Platform Requirements

​

Supported Recording Types

​

Mono Recording Requirement

​

Data Flow

​

CSV Metadata Formats

​

Stereo Voice Recordings

​

Mono Voice Recordings

​

Voice Transcripts (Pre-transcribed Audio)

​

Chat Scripts (Live Chat Interactions)

​

JSON Transcript Schemas

​

Voice Transcript Format

{
  "recognizedPhrases": [
    {
      "recognitionStatus": "Success",
      "channel": 0,
      "offset": "PT14S",
      "duration": "PT2.4S",
      "offsetInTicks": 140000000.0,
      "durationInTicks": 24000000.0,
      "durationMilliseconds": 2400,
      "offsetMilliseconds": 14000,
      "nBest": [
        {
          "confidence": 0.8205426,
          "lexical": "yes one four three four two six",
          "itn": "yes 143426",
          "maskedITN": "yes one four three four two six",
          "display": "Yes, 143426.",
          "words": [
            {
              "word": "yes",
              "offset": "PT14S",
              "duration": "PT0.32S",
              "offsetInTicks": 140000000.0,
              "durationInTicks": 3200000.0,
              "durationMilliseconds": 320,
              "offsetMilliseconds": 14000,
              "confidence": 0.51653963
            }
          ]
        }
      ]
    }
  ]
}

{
  "recognizedPhrases": [
    {
      "channel": 0,
      "offsetInTicks": 140000000.0,
      "nBest": [
        {
          "lexical": "yes one four three four two six",
          "words": [
            {
              "word": "yes",
              "offsetInTicks": 140000000.0,
              "durationInTicks": 3200000.0,
              "confidence": 0.51653963
            }
          ]
        }
      ]
    }
  ]
}

​

Chat Transcript Format

{
  "1": {
    "type": "AGENT",
    "text": "Good afternoon, how can I help you today?",
    "timestamp": 1749562206000,
    "userId": "john.smith@company.com"
  },
  "2": {
    "type": "USER",
    "text": "I need help with my account balance.",
    "timestamp": 1749562253142,
    "userId": "customer_12345"
  }
}

​

Configuration Steps

​

Step 1: Prepare Your S3 Environment

• All audio files are accessible via HTTPS URLs.
• CSV files contain the required fields with correct column headers.
• Mono recordings have separate agent and customer files.
• A test.csv file exists in each configured folder.
• All file sizes are under 50 MB.

​

Step 2: Add the Connector

1. Navigate to Quality AI > Configure > Connectors.
2. Select + Add Connector > Amazon S3 > Connect.
3. Enter a Name for the connector.
4. Select your AWS Region.
5. Choose an Auth Type and enter your credentials:
   • Access Keys: Enter your Access Key and Secret Key.
   • IAM Role: Enter the IAM Role ARN.
6. Set the folder path:
   • Unified Path: Enter a single path for both voice and chat (for example, s3://your-bucket/conversations/).
   • Separate Paths: Enter a Voice Path and a Chat Path separately.

​

Step 3: Test the Connection

1. Select the Test tab in the connector configuration.
2. Confirm the following checks pass:

   Check	Expected Result
   Authentication	Connected successfully
   File Path Access	S3 bucket accessible
   File Format	CSV format validated
   Metadata Validation	Required fields confirmed

3. If a check fails:

   Check	Resolution
   Authentication	Verify credentials and IAM permissions; ensure they have not expired
   File Access	Check bucket name, region, and folder paths; confirm file URLs are accessible
   Format/Metadata	Ensure test.csv exists with correct structure, column headers, and timestamps

​

Step 4: Map Queues and Set a Schedule

1. Navigate to the Queue tab.
2. Map each queueId value from your CSV files to a queue in Quality AI Express. Values must match exactly.
3. Navigate to the Schedule tab.
4. Set the Interval (minutes, hours, or days) and the Start Time (UTC).
5. Select Save to activate the connector.

• Queue mappings are saved and validated.
• The processing schedule is active.
• The first ingestion job appears in the Log tab.
• No errors appear in the processing logs.

• Conversations appear in Quality AI Express dashboards.
• Analytics data populates for ingested interactions.

​

Troubleshooting

​

Authentication Issues

​

Data Processing Issues

​

Performance