Skip to main content

Phone Management

SectionDescription
Feature AreaTelephony Infrastructure
NavigationAdmin → Telephony → Phone Management
Alt NavigationMenu → Digital and Telephony → Telephony → Phone Management
Primary FunctionConfigure, provision, and manage the physical and software phones used by agents to make and receive calls

Genesys Cloud supports multiple phone types. Phone Management is where administrators create phone records, assign base settings, connect phones to sites, and manage provisioning.


Study Notes

TopicExplanation
Phone ManagementAdmin area for creating and managing phone configurations — assigns phones to users and sites
Base SettingsA reusable configuration profile applied to phones — defines codec, DTMF method, TLS settings, Quality of Service, and more
SiteA logical grouping of telephony resources (trunks, number plans, outbound routes) — phones are assigned to a site
ProvisioningThe process of automatically delivering a phone's configuration from Genesys Cloud to the physical device
Zero Touch Provisioning (ZTP)Managed phones can self-configure by contacting the Genesys provisioning server on first boot
Hardware IDThe identifier used to associate a phone record with a physical device (e.g., MAC address for hardware phones, FQDN for softphones)
Line KeysConfigurable buttons on a hardware phone — can be assigned to speed dial, BLF (Busy Lamp Field), or line registrations
HELDHTTP-Enabled Location Delivery — protocol allowing Poly phones to retrieve precise location from a LIS server for E911 accuracy

Four Phone Categories

CategoryDescriptionConfigurationUse Case
ManagedGenesys Cloud controls the full configuration — provisioned via HTTPS with TLS and redundancyConfigured entirely in Genesys Cloud via Phone Management and Base SettingsHardware desk phones (Poly VVX, Poly Edge E, AudioCodes)
UnmanagedPhone registers with Genesys Cloud but is configured externallyOnly basic SIP connection info in Genesys Cloud; uses a generic SIP base settings profileAny SIP-compliant device; FXS analog adapters
WebRTCBrowser-based softphone — no hardware or separate software requiredEnabled per-user; headset connected to computerAgents working in browser; remote workers
RemoteAn external phone number or SIP address (e.g., cell phone)Configured as a remote number — calls are bridged to the remote device when an interaction is acceptedMobile workers; home phones; non-networked devices

Managed vs Unmanaged — Key Differences

AttributeManagedUnmanaged
Configuration sourceGenesys Cloud (provisioned via HTTPS)External to Genesys Cloud
Default base settings profilesYes — Genesys provides model-specific defaultsNo — uses generic SIP profile
TLS / SRTPAutomatic via provisioningPossible but requires manual configuration
Redundancy (primary + secondary SIP)AutomaticPossible but not automatic
Mutual authentication (Genesys Cloud Voice)StandardNot supported
ZTP supportYesNo
ExamplesPoly Edge E, Poly VVX, AudioCodesGeneric SIP devices, FXS adapters

WebRTC Phones

AttributeDetail
No hardware requiredRuns entirely in the browser
No software downloadBuilt into Genesys Cloud web app
SetupEnable WebRTC phone per user; connect a headset
Creates a dedicated phone lineProvisioning a WebRTC phone creates a specific phone line for that user
Recommended forRemote workers, browser-first environments

Remote Phones

AttributeDetail
What it isAn external phone number or SIP address used to connect a user to Genesys Cloud calls
How it worksWhen a call is placed/answered in the browser, Genesys Cloud calls the remote number to bridge the connection
RoutingFollows the site's numbering plans and outbound routes
Typical useMobile workers, agents who use personal cell phones

Navigation and Configuration

TaskPath
Open Phone ManagementAdmin → Telephony → Phone Management
View/manage phonesPhone Management → Phones tab
View/manage base settingsPhone Management → Base Settings tab
Add a phonePhone Management → Phones → Add Phone
Assign base settings to a phoneSelect phone → choose Base Settings profile
Assign phone to a siteSelect phone → choose Site
Restart a phonePhone Management → select phone → Restart
Log out a phonePhone Management → select phone → Log Out
Migrate base settingsPhone Management → select phones → Migrate Base Settings

Base Settings

Base Settings are reusable configuration templates applied to one or more phones of the same model. They define:

Setting CategoryExamples
GeneralDynamic Reload (auto-updates without manual restart)
Media / Quality of ServiceDSCP value for RTP packets; RTP Audio Port Start Range (default 4000; range 1024–65,535)
CodecsPreferred codec list (MIME format, priority-ordered)
DTMFRTP Events (out-of-band, RFC 4733 — default) or In-band Audio; payload type 96–127 for RTP Events
SecurityTLS certificate authority selection; mutual authentication
ProvisioningFirmware version; firmware update settings
E911 / HELDEnable HELD; provide LIS URL and Emergency Routing Service Account ID (for Poly VVX, CCX, Edge E)

Managed Phone Provisioning Process

Phone powers on
        ↓
Phone contacts Genesys Cloud provisioning server (HTTPS)
        ↓
Genesys Cloud delivers configuration (base settings, line keys, TLS certs, SIP credentials)
        ↓
Phone registers with Genesys Cloud SIP infrastructure
        ↓
Phone is ready — appears as Online in Phone Management

Supported Managed Phone Brands (Examples)

BrandExample Models
Poly (formerly Polycom)Poly Edge E Series (E100/E220/E300/E320/E350/E400/E450/E500/E550) · VVX Series · SoundPoint IP · SoundStation
AudioCodesVarious models (note: some AudioCodes models are incompatible with Genesys Cloud Voice/BYOC Cloud)
Spectralink84-Series (incompatible with Genesys Cloud Voice/BYOC Cloud)

Compatibility note: Most managed phones are compatible with Genesys Cloud Voice and BYOC Cloud. Some AudioCodes models and certain older SoundPoint models are incompatible — refer to the Genesys Cloud Voice / BYOC Cloud compatible phones matrix before purchasing.


Phone Management Operations

OperationDescription
Add PhoneCreate a new phone record; assign name, base settings, site, and hardware ID
Import PhonesBulk import via CSV
Restart PhoneSends a restart command to the managed phone over the network
Log Out PhoneLogs the user off the phone remotely
Migrate Base SettingsMove phones to a different base settings profile (e.g., after a model upgrade)
Edit PhoneChange name, base settings, site assignment, line key configuration
Check StatusView online/offline status for each phone
FilterFilter phone list by site, base settings, status, or name

Permissions

PermissionPurpose
Telephony > Plugin > AllFull access to telephony admin including Phone Management
Telephony > SitesManagedPhones > View/Add/Edit/DeletePhone-specific permissions

Key Takeaways

TopicSummary
Phone categoriesManaged · Unmanaged · WebRTC · Remote
Managed phonesFully provisioned by Genesys Cloud via HTTPS — TLS, redundancy, ZTP automatic
Unmanaged phonesConfigured externally; only SIP registration info in Genesys Cloud; uses generic profile
WebRTCBrowser-based; no hardware; headset required; per-user enablement
RemoteExternal number (cell phone, SIP address) bridged to calls
Base SettingsReusable profile — codec, DTMF, TLS, QoS, firmware, HELD
NavigationAdmin → Telephony → Phone Management
Phones tabManage individual phone records
Base Settings tabManage configuration templates