Before you start
- An Operata account. Your Operata Group ID is the UUID in the console URL.
- An API token generated under Settings → Config → API. See Authentication.
- An Amazon Connect instance you can place a test call into, with the Cloud Collector CloudFormation stack deployed against it.
- A working softphone — Amazon Connect CCP or the Agent Experience Collector in Chrome or Edge.
Steps
1. Confirm your credentials work
Send the same call as the Quickstart — one contact from yesterday’s window, page size 1.200 OK with a data array — empty or otherwise — confirms the Group ID and token authenticate. A 401 means the token is wrong or revoked; regenerate it and retry.
2. Place a test contact
Sign in to the agent’s CCP, set status toAvailable, and place an inbound call into your Amazon Connect instance. Stay on the call for at least 30 seconds, then hang up. The 30-second floor gives the Cloud Collector enough audio to compute meaningful network and MOS metrics.
Note the contact ID shown in the CCP — you use it to verify in step 4.
3. Wait for the observation to land
The Cloud Collector picks up the Contact Trace Record (CTR) from Kinesis within seconds of contact end, applies the active redaction config, and ships the surviving fields to Operata. Allow up to 60 seconds for the observation to appear.data array, wait 30 seconds and retry. A populated row means the Cloud Collector filtered the CTR, the EventBridge pipe delivered it, and Operata stored it as an observation against the contact.
4. Open the contact in the console
In the Operata console, open Contacts and filter the time window to the last 10 minutes. The test contact appears as a row carrying the same contact ID you noted in step 2, an agent name, a queue, and headline metrics — MOS, jitter, round-trip time, packets lost.Verify
The API call in step 3 returns200 OK with one data entry whose id matches the contact ID from the CCP, and the same row is visible in the Contact summary list in the console. The API response and the console agree on agent, queue, and duration.
Related
- Contacts and interactions — the model behind the row you just saw.
- Signals and observations — what a signal is, what an observation is, and how they relate to a contact.
- List contact summaries — every parameter the endpoint accepts.
- Configure CTR redaction — strip fields from the CTR before the next contact ships.