ProSBC Genesys Trunk Setup Wizard

Complete guide to configuring ProSBC as a SIP Trunk in Genesys Cloud

Overview
Prerequisites
Wizard Steps
Default Trunk Settings
Troubleshooting
AppFoundry Integration
Client App SDK
IFrame & URL Parameters
Support

Overview

The ProSBC Genesys Trunk Setup Wizard simplifies the process of creating a BYOC (Bring Your Own Carrier) SIP trunk in Genesys Cloud to connect with your TelcoBridges ProSBC.

The wizard guides you through:

Authenticating with your Genesys Cloud organization
Selecting a site for the trunk
Configuring outbound routing
Setting up SIP trunk parameters
Creating the trunk with optimal default settings

Prerequisites

Before using this wizard, ensure you have:

Genesys Cloud Account - With admin privileges to create trunks
ProSBC Deployed - Your ProSBC should be installed and accessible
ProSBC IP Address - The public IP address of your ProSBC
Network Connectivity - Ensure firewall rules allow SIP traffic between Genesys Cloud and ProSBC

Required Genesys Cloud Permissions:

telephony:plugin:all - Create and modify trunks
telephony - Read telephony configuration

Wizard Steps

Step 1: Login

Select your Genesys Cloud region and authenticate using OAuth. The wizard will open a popup window for you to log in to your Genesys Cloud organization.

Supported Regions:

USE1 - Americas (US East) - mypurecloud.com
USE2 - Americas (US East 2) - use2.us-gov-pure.cloud
USW2 - Americas (US West) - usw2.pure.cloud
CAC1 - Canada - cac1.pure.cloud
EUW1 - EMEA (Dublin) - mypurecloud.ie
EUW2 - EMEA (London) - euw2.pure.cloud
EUC1 - EMEA (Frankfurt) - mypurecloud.de
EUC2 - EMEA (Zurich) - euc2.pure.cloud
APSE1 - Asia Pacific (Singapore) - apse1.pure.cloud
APSE2 - Asia Pacific (Sydney) - mypurecloud.com.au
APNE1 - Asia Pacific (Tokyo) - mypurecloud.jp
APNE2 - Asia Pacific (Seoul) - apne2.pure.cloud
APNE3 - Asia Pacific (Osaka) - apne3.pure.cloud
APS1 - Asia Pacific (Mumbai) - aps1.pure.cloud
SAE1 - South America (Sao Paulo) - sae1.pure.cloud
MEC1 - Middle East (UAE) - mec1.pure.cloud

Step 2: Site Selection

Select the Genesys Cloud site where the trunk will be created. Sites represent physical or logical locations in your organization.

Step 3: Outbound Route

Choose how outbound calls will be routed through the trunk:

Use Existing Route - Select an existing outbound route to add the trunk to
Create New Route - Create a new outbound route with selected classification types (National, International, etc.)

When creating a new route, you can select classification types. If a classification is already used by another route, a renamed copy will be created (e.g., "National" becomes "National ProSBC").

Step 4: Trunk Details

Configure the SIP trunk connection settings:

Field	Description
External Trunk Name	A friendly name to identify this trunk in Genesys Cloud
Inbound SIP Termination Identifier	Unique identifier for routing inbound calls to your organization
ProSBC Hostname or IP Address	The address of your ProSBC server (e.g., sip.prosbc.com or 192.168.1.100)
Port	SIP port number (default: 5060 for UDP/TCP, 5061 for TLS)
Transport Protocol	UDP, TCP, or TLS
SIP Access Control IPs	IP addresses allowed for SIP access (your ProSBC IPs). Separate multiple IPs with commas.

Step 5: Review

Review all your configuration settings before creating the trunk. You can go back to any previous step to make changes.

Step 6: Success

Your trunk has been created! You can view the trunk in Genesys Cloud Admin to make additional configurations.

Default Trunk Settings

The wizard configures the trunk with the following optimized default settings:

Media Settings

Setting	Value
Audio Codecs	G.711 A-law (PCMA), G.711 u-law (PCMU)
DTMF Payload	101
Recording Format	audio/opus

SIP Settings

Setting	Value
Asserted Identity Header	P-Asserted-Identity
UUI Header	User-to-User
UUI Protocol Discriminator	00
Conversation Header	Enabled

Privacy & Identity Settings

Setting	Value
Apply User Privacy	Enabled
Apply Header Privacy	Enabled
Omit + Prefix (Calling)	Disabled (keeps + prefix)
Omit + Prefix (Called)	Disabled (keeps + prefix)

Transfer Settings

Setting	Value
Transfer Takeback	Enabled

Troubleshooting

Login Failed

If you cannot log in, ensure:

You selected the correct region for your organization
Pop-ups are not blocked in your browser
Your account has the required permissions

No Sites Available

If no sites appear in the dropdown:

Ensure at least one site is configured in Genesys Cloud
Verify you have permission to view sites

Trunk Creation Failed

If trunk creation fails:

Check the error message for specific details
Ensure you have telephony:plugin:all permission
Verify the trunk name is unique
Check that the SIP Access Control IPs are valid

AppFoundry Integration

This wizard is designed as a Genesys Cloud AppFoundry Premium Client Application and integrates with the Genesys Cloud Client App SDK for enhanced user experience.

Client App SDK Integration

The wizard uses the official Genesys Cloud Client App SDK (purecloud-client-app-sdk) to provide:

Feature	Description
Lifecycle Management	Signals `bootstrapped()` when the wizard is ready, enabling proper integration with the Genesys Cloud UI
Toast Notifications	Displays native Genesys Cloud toast popups for success and error messages when trunk creation completes
Environment Detection	Automatically detects the Genesys Cloud environment from URL parameters (`gcHostOrigin`, `gcTargetEnv`)

SDK Version: The wizard uses Client App SDK version 2.6.3 loaded from the official Genesys CDN.

Submission Requirements

When submitting to AppFoundry, use the following configuration:

Publicly Hosted Install Wizard URL:

https://your-domain.com/wizard/?langTag={{gcLangTag}}&hostOrigin={{gcHostOrigin}}&targetEnv={{gcTargetEnv}}

Required IFrame Sandbox Options

Option	Required	Purpose
allow-forms	Yes	Form submissions
allow-modals	Yes	Modal dialogs
allow-popups	Yes	OAuth login popup
allow-presentation	Optional	Presentation mode
allow-same-origin	Yes	Same-origin access
allow-scripts	Yes	JavaScript execution
allow-downloads	Optional	File downloads

Permissions Policy

This wizard does not require any special permissions (Camera, Microphone, Geolocation, etc.).

Application Location

The wizard can be placed in any of the following locations:

Apps Menu (Recommended)
Directory Menu
Performance Menu
Sidecar (Widget panel)

IFrame & URL Parameters

Technical details for embedding the wizard in an iframe.

URL Parameters (Genesys Cloud AppFoundry)

The wizard accepts the following URL parameters for automatic configuration:

Parameter	Description	Example
`langTag` or `gcLangTag`	Language/locale tag for the user interface	en-US, fr-CA, de-DE
`hostOrigin` or `gcHostOrigin`	Genesys Cloud host origin URL (used to detect region)	https://apps.cac1.pure.cloud
`targetEnv` or `gcTargetEnv`	Target environment/region identifier	cac1.pure.cloud, mypurecloud.com

Example URL

https://your-domain.com/wizard/?langTag={{gcLangTag}}&hostOrigin={{gcHostOrigin}}&targetEnv={{gcTargetEnv}}

Supported Regions

Code	Region	Domain
USE1	Americas (US East)	mypurecloud.com
USE2	Americas (US East 2)	use2.us-gov-pure.cloud
USW2	Americas (US West)	usw2.pure.cloud
CAC1	Canada	cac1.pure.cloud
EUW1	EMEA (Dublin)	mypurecloud.ie
EUW2	EMEA (London)	euw2.pure.cloud
EUC1	EMEA (Frankfurt)	mypurecloud.de
EUC2	EMEA (Zurich)	euc2.pure.cloud
APSE1	Asia Pacific (Singapore)	apse1.pure.cloud
APSE2	Asia Pacific (Sydney)	mypurecloud.com.au
APNE1	Asia Pacific (Tokyo)	mypurecloud.jp
APNE2	Asia Pacific (Seoul)	apne2.pure.cloud
APNE3	Asia Pacific (Osaka)	apne3.pure.cloud
APS1	Asia Pacific (Mumbai)	aps1.pure.cloud
SAE1	South America (Sao Paulo)	sae1.pure.cloud
MEC1	Middle East (UAE)	mec1.pure.cloud

IFrame Sandbox Options

The wizard supports the following sandbox options:

allow-forms
allow-modals
allow-popups
allow-presentation
allow-same-origin
allow-scripts
allow-downloads

Parent Frame Communication

The wizard sends the following messages to the parent frame:

Message Type	Description
`prosbc-wizard-ready`	Sent when the wizard is loaded and ready
`prosbc-trunk-created`	Sent when a trunk is successfully created. Includes trunkName, trunkId, siteId, siteName

Parent Frame Commands

The wizard accepts the following commands from the parent frame:

Message Type	Description
`prosbc-set-region`	Pre-select a region. Include `region` in the message data.
`prosbc-set-token`	Pass an OAuth token directly. Include `token` and `region` in the message data.

Example Integration

<iframe
    src="index.html"
    sandbox="allow-forms allow-modals allow-popups allow-same-origin allow-scripts"
    style="width: 100%; height: 800px; border: none;"
></iframe>

<script>
window.addEventListener('message', (event) => {
    if (event.data.type === 'prosbc-trunk-created') {
        console.log('Trunk created:', event.data.data);
    }
});
</script>

Support

For assistance with:

ProSBC Configuration - Contact TelcoBridges Support
Genesys Cloud Issues - Contact Genesys Cloud Support
Wizard Issues - Contact TelcoBridges Support

TelcoBridges Support

Website: www.telcobridges.com
Email: support@telcobridges.com