> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wejam.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Call Connection Issues

> Fix roleplay calls that fail to start on corporate networks - connectivity checker, network requirements, and domain whitelisting for voice interactions.

If you can log in and use the web app but **roleplay calls won't start**, the most likely cause is that your corporate network blocks the WebRTC connection used for real-time voice. This page explains how to diagnose and fix it.

> [!NOTE]
>
> Run the built-in connectivity checker first:
> [app.wejam.ai/check](https://app.wejam.ai/check). **Microphone access** is
> required for a full test.

## Symptoms

* You can log in and navigate the web app.
* A roleplay fails to start, or the call never connects.

## Likely cause

WebRTC voice traffic is not allowed on your company network, or the network blocks the signaling connection that starts the call.

## Background: how JAM uses the network

To load the web app, only **TCP port 443** (HTTPS) is required. To create low-latency voice-to-voice interactions, JAM uses **WebRTC** through the **ElevenLabs EU residency** network. The browser must be able to complete WebRTC signaling on TCP/443 and send media traffic over UDP.

* **ElevenLabs** powers the real-time voice AI. JAM connects to the ElevenLabs EU residency region for roleplay calls.
* Signaling uses HTTPS/WebSocket traffic on **TCP/443**.
* Real-time media uses **WebRTC UDP traffic**, including the standard dynamic UDP port range **49152-65535**. Restricting UDP to only `40000-49999` can prevent calls from starting.

## Debugging steps

1. **Run the connectivity checker.** Direct the user to [app.wejam.ai/check](https://app.wejam.ai/check) (microphone access required). This tests the connection end-to-end.
2. **Whitelist the required domains and ports** on the corporate firewall or proxy:

| Domain | Protocol / Port | Purpose |
| - | - | - |
| `app.wejam.ai` | HTTPS, TCP/443 | Web application (frontend) |
| `api.wejam.ai` | HTTPS, TCP/443 | REST API |
| `eu.residency.elevenlabs.io` | HTTPS/WSS, TCP/443; WebRTC UDP `49152-65535` | ElevenLabs EU residency service |
| `rtc.eu.residency.elevenlabs.io` | HTTPS/WSS, TCP/443; WebRTC UDP `49152-65535` | ElevenLabs WebRTC media |
| `livekit.rtc.eu.residency.elevenlabs.io` | WSS, TCP/443; WebRTC UDP `49152-65535` | ElevenLabs SDK WebRTC media |
| `turn.rtc.eu.residency.elevenlabs.io` | TURN relay, TCP/443; WebRTC UDP `49152-65535` | ElevenLabs WebRTC relay |
| `api.eu.residency.elevenlabs.io` | HTTPS/WSS, TCP/443 | ElevenLabs API/signaling |

> [!WARNING]
>
> For ElevenLabs domains, the firewall must allow WebSocket upgrades on TCP/443
> and WebRTC media traffic over UDP. Blocking either the signaling connection or
> the UDP media path can make a roleplay call fail before it starts.

## Network requirements (for IT teams)

JAM's web app enables voice-to-voice interactions using low-latency WebRTC connections, facilitated through ElevenLabs EU residency infrastructure. To ensure reliable operation, the following must be supported in the customer's network environment:

**Port accessibility**

* **TCP port 443** is required for HTTPS and WebSocket signaling.
* **UDP ports 49152-65535** must be allowed for WebRTC media traffic to ElevenLabs. This is the standard dynamic UDP port range used by WebRTC; observed calls may use ports such as `50674` or `53396`.

**Domain whitelisting**

* `app.wejam.ai` - web application
* `api.wejam.ai` - REST API
* `eu.residency.elevenlabs.io` - ElevenLabs EU residency service
* `rtc.eu.residency.elevenlabs.io` - ElevenLabs WebRTC media
* `livekit.rtc.eu.residency.elevenlabs.io` - ElevenLabs SDK WebRTC media
* `turn.rtc.eu.residency.elevenlabs.io` - ElevenLabs WebRTC relay
* `api.eu.residency.elevenlabs.io` - ElevenLabs API/signaling

Prefer FQDN-based allowlisting for ElevenLabs. Their infrastructure can resolve to changing IP addresses, so IP-only allowlists are more likely to break.

**Corporate network considerations**

Restrictive network environments, such as those common in corporate settings, may impede WebRTC connectivity. In those cases the customer is responsible for ensuring the network supports the required configuration, including allowing the domains above, WebSocket upgrades on TCP/443, and UDP media traffic in the dynamic port range.

**Diagnostic tool**

Use the built-in connectivity checker at [app.wejam.ai/check](https://app.wejam.ai/check) to diagnose connectivity issues. The page checks microphone access, the JAM API connection, an ElevenLabs WebRTC connection, an ElevenLabs WebSocket connection, and a short voice test through an echo agent. Microphone access is required for a full test.

## Running roleplays without UDP (WebSocket mode)

If your firewall cannot allow UDP media traffic, ask your JAM contact to switch your organization to WebSocket mode. Every roleplay and every Jam Assistant voice call in your organization then runs over a single encrypted connection on **TCP port 443**. There is no UDP, no STUN/TURN and no fallback to WebRTC. If the WebSocket test on the [connectivity checker](https://app.wejam.ai/check) passes, WebSocket mode will work on that network.

Allow these domains on TCP/443 (HTTPS and WSS):

| Domain | Purpose |
| - | - |
| `app.wejam.ai` | Web application (frontend) |
| `api.wejam.ai` | REST API |
| `api.eu.residency.elevenlabs.io` | ElevenLabs voice calls |

The `rtc`, `livekit` and `turn` ElevenLabs domains and the UDP port range above are not needed in WebSocket mode.

Optional: `eu.i.posthog.com` (product analytics) and `*.sentry.io` (error reporting). JAM works without them.

If your proxy inspects encrypted traffic (TLS inspection), exempt `api.eu.residency.elevenlabs.io` or make sure the proxy passes WebSocket upgrades through. A roleplay is one long-lived WebSocket connection, so the proxy must not close it after a short idle timeout.

## Related articles

* [Frequently Asked Questions](https://docs.wejam.ai/external/coaching/faq.md) - including microphone and audio troubleshooting
* [Starting and Completing a Roleplay](https://docs.wejam.ai/external/coaching/roleplay.md) - how a normal call works
* [Jam Assistant: Call Connection Issues](https://docs.wejam.ai/external/assistant/call-connection-issues.md) - same underlying network requirements, for Jam Assistant voice calls

***

*Last updated: November 2026*


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.