Connect LabAmazon Connect study

CCP and workspace

VDI, VPN, and the audio path

Learn it in 5 minutes

HTML

About five minutes of reading

The browser that runs the CCP must be the browser whose network can reach TURN.

If the CCP runs inside a data-center VDI, media comes from the data center, not from the headset's house. That adds latency and often blocks UDP. Video calling is documented as unsupported in VDI.

The network troubleshooting page lists firewalls, NAT, and VPNs as the first causes of quality and disconnects. Prefer a direct path. Use the Endpoint Connectivity tool on the same desktop the agent uses.

  • One-way audio is often NAT or a stateful rule that never saw the return traffic.
  • Jitter and loss show up as robotic audio, not as a flow error.
  • Do not stack a VPN, a proxy, and VDI and then tune the flow.
  • Remote agents need the same allow list as the office.

Number on this page: Video + VDI No. Documented as unsupported

Visual

HTML
VDI, VPN, and the audio path
Diagram SVGDiagram PNGDiagram HTMLFlow SVGFlow PNGFlow HTML

Direct is the path the docs ask you to prove.

Worked example

HTML
  1. Same desktop. Run the endpoint tool.
  2. Direct. No VPN on media.
  3. Then. A test call.
  4. Then. The floor.

What usually goes wrong: Testing on a home laptop and rolling out to a locked VDI fleet.

Quiz

HTML

Question 1

Which term matches this description? The WebRTC audio path. It needs outbound UDP 3478 to the Regional TurnNlb domain.

Show the cited answer

The WebRTC audio path. It needs outbound UDP 3478 to the Regional TurnNlb domain. The term is Softphone media.

How Contact Control Panel (CCP) uses WebRTC - Amazon Connect Customer AWS docs. last checked 2026-10

Question 2

Which term matches this description? The relay used when the browser cannot send media directly. The error text names turn:TurnNlb-....elb.region.amazonaws.com:3478.

Show the cited answer

The relay used when the browser cannot send media directly. The error text names turn:TurnNlb-....elb.region.amazonaws.com:3478. The term is TURN.

Contact Control Panel (CCP) Issues - Amazon Connect Customer AWS docs. last checked 2026-10

Sources

HTML

Troubleshoot your network for call quality and disconnect problems - Amazon Connect Customer AWS docs. last checked 2026-10

The prose is a study paraphrase. The link is the source of the facts.

Ecosystem

HTML

Glossary

  • CCP Contact Control Panel. The browser phone and contact UI the agent uses.
  • Agent workspace The fuller desktop around the CCP: profiles, cases, step-by-step views, and third-party apps.
  • Streams API The amazon-connect-streams library. It embeds or replaces the CCP and listens to agent and contact events.
  • Softphone media The WebRTC audio path. It needs outbound UDP 3478 to the Regional TurnNlb domain.

Mind map

Open the CCP and workspace mind map

Sister technologies

If UDP 3478 is blocked, the agent is signed in and cannot hear the customer.

Config and troubleshooting

Testing on a home laptop and rolling out to a locked VDI fleet.

A custom CCP using amazon-connect-streams has to be served from an origin you approve on the instance. The softphone still needs UDP 3478. Approving the origin does not open that port.

ApprovedOrigin Streams

CloudFormation study snippet
Resources:
  CcpOrigin:
    Type: AWS::Connect::ApprovedOrigin
    Properties:
      InstanceId: !GetAtt CampusInstance.Id
      Origin: https://ccp.example.com

Integration map

Join records on ContactId. The integration map room lists the seams.

Cross-platform bridges

A CUCM calling search space is not a routing profile, but the profile is the closest idea of 'who can receive what'. A partition is not a Connect object. A UCCX CSQ and a UCCE skill group map to a queue. Precision steps map to routing criteria. A script, an Architect flow, and an Avaya vector map to a contact flow.

Open the mapping room

Future hooks

Hooks you can adopt later: EventBridge contact events, the CTR stream, agent events, Kinesis Video, Customer Profiles events, Cases, Show view, data tables, External Tool, and the flow language JSON in your pipeline. Live Sync and Agentic CX are the 2026 hooks for guided and agentic experiences.

Sources and go deeper

sources.json