Configure your site for Global Media Fabric

AI-generated summary

, while AWS-range regions do not support Geo-Lookup. The Relay/TURN Behavior setting provides two operational modes: restricting calls to specified media regions or enabling dynamic routing to the lowest-latency region globally through Geo-Lookup. Geo-Lookup, a TURN feature exclusive to Genesys CIDR ranges, optimizes WebRTC call routing by analyzing client IP addresses to identify the nearest AWS region, verifying latency conditions, directing clients to appropriate TURN servers, and checking alternative regions when issues are detected. The platform prioritizes selecting TURN servers with the lowest latency across regions rather than restricting access to geographically nearest regions. Core regions and satellite media regions are designed to minimize latency globally. To maintain service continuity, Genesys recommends allowing firewall access to complete CIDR blocks and specifying nearby media regions according to geographic location. Site configuration occurs through Menu > Digital and Telephony > Telephony > Sites, where administrators select a site, access the General tab, configure the Media section by choosing Relay/TURN Behavior options and selecting media regions from the Media Regions list, adjust priority using Increase Priority or Decrease Priority functions, remove regions via Delete, and apply changes by clicking Save Site. Additional configuration guidance is available in documentation addressing Relay/TURN Behavior enforcement, AWS regions, Global Media Fabric architecture, BYOC Cloud deployment, firewall ports and services, and configuration testing procedures.

To configure the Global Media Fabric feature, you begin by adding and prioritizing media regions on the Sites page. You then specify the Relay/TURN Behavior option that you want to use for calls requiring TURN services.

Media regions

As you add media regions, you want to choose those regions that are close to you on a global scale. You can choose any Genesys Cloud media region that is close to you including your home region, any core region, or any satellite region.

Next to each region name is an icon that identifies the type of region. The icon identifies the home region, the icon identifies a core region, and the icon identifies a satellite region. As you prioritize your list of media regions, keep in mind that if the first region in the prioritized list is unable to process the call, the call moves to the next media region in the list. This failover continues down the list of media regions that you specify. If the last media region in the list is unable to process the call, the call fails.

When selecting Media Regions, you’ll notice that there are some regions that contain the note: This region does not run on the Genesys CIDR range of IP addresses. This distinction is important for two reasons: First, any region that does not run on the Genesys CIDR ranges, does not support the Geo-Lookup feature. Second is firewall rule configuration.

If you have your firewall set up to only allow outbound connections to the AWS ranges, then you cannot use regions that run on the Genesys CIDR range.
If you have your firewall set up to only allow outbound connections to the Genesys CIDR range, then you won’t be able to use those regions that only allow AWS ranges.
If you have your firewall set up to allow outbound connections to both the Genesys CIDR range and AWS ranges, then you can use any of the available media regions.

For more information, see Cloud media services CIDR IP address range.

Relay/TURN Behavior

The Relay/TURN Behavior setting allows you to choose how the Global Media Fabric feature routes calls that require TURN services. There are two options to choose from:

Any media region set on this site

Choosing the Any media region set on this site option limits the Global Media Fabric feature to using one of the regions that you’ve added to the Media Regions list. This option is useful when you have a region or regions you absolutely don’t want to allow your call to flow through.

The Genesys Cloud media region with the lowest latency (via Geo-Lookup)

Choosing the Genesys Cloud media region with the lowest latency (via Geo-Lookup) option allows the Global Media Fabric feature to choose the nearest region with minimal latency. This can be any media region in the world that runs on the Genesys CIDR range of IP addresses. Furthermore, the selected region can change from call to call.

More specifically, Geo-Lookup is a TURN feature that runs on the Genesys CIDR range and optimizes the network path for WebRTC calls routed through cloud TURN services. It is designed to improve the connection and reduce latency. To do so, the Geo-Lookup feature provides a WebRTC client with a TURN candidate address from a list of special DNS names, which resolve to the nearest Genesys Cloud Media region. More specifically, when the WebRTC client reaches out for a TURN server, the Geo-Lookup feature uses the WebRTC client’s IP address to determine the nearest AWS region. Geo-Lookup then checks for latency issues between the WebRTC client and that AWS region. If Geo-Lookup doesn’t detect any issues, it directs the WebRTC client to the TURN server in that region. If there are issues, Geo-Lookup then checks the next nearest AWS region.

Note: There may be situations where accessing a TURN server in the nearest AWS region has a higher latency than a TURN server in another region. In that type of situation, Genesys Cloud chooses to access the TURN server with a low latency to provide the best connection. Genesys recommends allowing firewall access to our full and to specify the media regions that are close to you on a global scale to avoid disruption when latency and geographical paths differ. For more information, see .

Genesys Cloud media regions include the existing core regions and satellite media regions created specifically to provide lower latency access to media services around the world. For more information, see AWS regions for Genesys Cloud.