Configure a physical phone device
HyperConnect supports Yealink physical phone devices as an alternative to the built-in software voice client. When a physical phone is provisioned, incoming calls ring on both the software client and the physical handset. Call actions such as answer, hold, and transfer work from either device.
On this page
- Supported phone models
- Deployment models
- Before you begin
- Steps
- Device-employee association types
- Number porting
- How physical phone events work
- Tips
- Troubleshooting
- Related articles
Supported phone models
The models below are commonly deployed examples. HyperConnect supports additional Yealink models β check the Model dropdown during provisioning for the full, current list and which models are marked Recommended. Any model name described in this article is an example only; always refer to the Model dropdown for the current supported list.
| Model | Type | Connection |
|---|---|---|
| Yealink SIP-T43U | Wired desk phone | Ethernet |
| Yealink SIP-T48U | Wired desk phone | Ethernet |
| Yealink SIP-T54W | Wired desk phone | Ethernet + optional Wi-Fi |
| Yealink SIP-T57W | Wired desk phone | Ethernet + optional Wi-Fi |
| Yealink W70B | DECT base station (add handsets after selecting it) | Ethernet |
| Yealink W60B | DECT base station (add handsets after selecting it) | Ethernet |
| Yealink W76P | DECT kit (base station plus handset) | Ethernet to the base |
Deployment models
HyperConnect supports three deployment configurations:
- Soft phones only β Agents use only the browser-based soft phone. No physical hardware required.
- Physical phone only β Agents use only Yealink desk phones. All calls ring on the physical device.
- Hybrid phone setup β Agents use both soft phones and physical phones. Incoming calls ring simultaneously on both devices.
Before you begin
Permission: You need a Manager, Administrator, or Owner role to provision physical phone devices.
Admin path: Configuration > Security > Security Roles > select a role > scroll to Zenoti HyperConnect > enable Connect Access Enable.
- HyperConnect must be provisioned and enabled for your center with voice calling active.
- The Enable Physical Phone setting must be turned on for the center. To verify, open HyperConnect > click the Settings icon > select the Voice tab and confirm Enable Physical Phone is enabled.
- Devices are provisioned against a Center. Confirm you are working in the center where the phone will be used before you start.
- You need the Yealink device serial number and MAC address (printed on the device label).
- To find the MAC address on the phone itself, navigate to Menu > Status > Network > Mac Address.
- The device requires a power adapter and a network connection (Ethernet for wired models; for wireless DECT models, Ethernet to the DECT base station).
Steps
Add a wired device
- Open HyperConnect and click the Settings icon.
- Select the Voice tab.
- Scroll to the Device-User Association section.
- Click Add phone. If this is the first device for the center, click Add your first phone. The Configuration wizard opens.
- Select the Manufacturer (Yealink).
- Choose the Model from the Model dropdown. Models marked Recommended are currently preferred. The list reflects the current set of supported devices β check the dropdown for the latest options.
- Enter the Mac address (find it on the device label or navigate to Menu > Status > Network > Mac Address on the phone).
- Enter the Machine ID (printed on the device label).
- Assign a Friendly name for quick identification.
- Select the employee association type for the device.
- Click Add.
Important: The system validates the serial number and MAC address during provisioning. If the serial number is not recognized by the Yealink service, provisioning fails β verify the serial number on the device label and try again. If the MAC address is already registered to another device, you must remove that device first before adding the new one.
Add a wireless device (DECT)
Wireless Yealink phones use a DECT base station that connects to your network over Ethernet, with one or more cordless handsets paired to it. In the Model dropdown, always select the base station (for example, Yealink W70B or W60B) or a base-and-handset kit (for example, W76P). Never select an individual handset β handsets are added inside the wizard after you choose the model.
- Follow steps 1 through 9 for a wired device, selecting the DECT base station or kit in the Model dropdown.
- When you select a wireless model, the wizard displays: "This is a wireless device. You will need to add at least one handset to use it."
- Click New handset. The handset is added as Handset 1.
- Click New handset again for each additional handset. Handsets are numbered in sequence β Handset 2, Handset 3, and so on β up to the handset limit for the selected model.
- Click Add.
- Connect the DECT base station to your network via Ethernet.
- Register each handset with the base station per the Yealink pairing instructions.
Each handset communicates wirelessly with the base station, and the base station connects to HyperConnect.
Important: A wireless device requires at least one handset before it can be used. Add every handset you plan to use before you finish the wizard.
The system registers the device with the Yealink cloud service, configuring SIP credentials and call routing automatically. No manual SIP configuration is required.
Note: After successful provisioning, a green icon appears on the phone display with the label HyperConnect beside it, confirming the device is connected.
Verify the device is working
- Ensure the Yealink phone is powered on and connected via Ethernet.
- The handset display should show the registered status (not "Unregistered").
- Place a test call to the center's number. The call should ring on both the physical phone and the HyperConnect software client.
- Answer the call on the physical phone to confirm audio works in both directions.
Associate a different employee with the device
- Open HyperConnect and click the Settings icon > select the Voice tab > scroll to Device-User Association.
- Select the device from the list.
- Change the associated employee.
- Save the configuration.
The device now rings for the newly associated employee's incoming calls.
Allow multiple employees to share a device
By default, a device is associated with a single employee. To let more than one employee use the same device, turn on Dynamic employee selection.
- Open HyperConnect and click the Settings icon > select the Voice tab > scroll to Device-User Association.
- Select the device from the list.
- Turn on Dynamic employee selection.
- Choose the dynamic association type:
- Dynamic (Soft phone) β Allows multiple users to be associated to the phone via the interface & displays guest profile when they pick the call.
- Dynamic (Phone device) β Allows multiple users to be associated to the phone via the phone device & displays guest profile when they pick the call.
- Save the configuration.
Important: Dynamic (Phone device) association works in a single browser only. See Device-employee association types for the full behavior.
Remove a device
Important: Removing a device from the interface does not always clear its underlying registration in the Yealink cloud service. If you remove a device and then attempt to re-add the same device with a corrected hardware address, the operation may fail repeatedly with a generic error. If this occurs, contact Zenoti Support to clear the stale registration. After Zenoti Support clears the registration, sign out of HyperConnect and sign back in before attempting to re-add the device.
- Open HyperConnect and click the Settings icon > select the Voice tab > scroll to Device-User Association.
- Select the device to remove.
- Click Remove.
The system removes the agent association. Calls no longer ring on the physical phone.
Device-employee association types
HyperConnect supports three ways to associate phones with employees:
Specific Employee (Static)
The device is permanently assigned to one employee. All calls to that employee ring on this device.
Dynamic (Soft phone)
The soft phone session is bound to the employee's browser session. When the employee logs in, the soft phone activates. When they log out or close the browser, the soft phone deactivates.
Dynamic (Phone device)
The physical phone is dynamically associated with an employee based on the browser session. The employee logs in and the physical phone activates for their session.
Important: Dynamic phone-device association works in a single browser only. Opening HyperConnect in a second browser does not transfer the dynamic association to that browser. If the browser cache is cleared, the phone defaults to the last logged-in user until a new dynamic association is established. To re-establish the association, navigate to the Settings icon > Voice tab > Device-User Association section and re-mark the device as dynamic.
Employee extension and association PIN
Each employee assigned to a phone device has:
- An Employee Extension number for internal calls and transfers.
- An Association PIN used for device-level association when using dynamic phone mode.
Reset a physical phone
To factory-reset a Yealink phone, use the on-device admin menu. Refer to the Yealink documentation for your specific model or contact your Yealink account representative for the current admin PIN and reset procedure.
Number porting
If you need to port an existing phone number to HyperConnect:
- Twilio-based numbers: Porting typically completes within approximately 1 hour.
- Non-Twilio numbers: Porting takes approximately 2β3 hours.
Important: Porting dates cannot be altered once submitted. Plan accordingly.
Note: Toll-free numbers and virtual numbers are not eligible for porting. Only standard local and mobile numbers can be ported to HyperConnect.
Common porting failure reasons:
- Incorrect PIN or passcode provided to the carrier
- Invalid authorization on the account
- Carrier freeze on the number (contact your carrier to remove the freeze)
If porting is delayed or fails, use call forwarding from your existing number to your HyperConnect number as a temporary alternative.
How physical phone events work
When a call arrives, the system handles events from the physical phone device through a dedicated event handler:
| Event | Behavior |
|---|---|
| Ring | The physical phone rings simultaneously with the software client notification. |
| Answer | Answering on the physical phone dismisses the software client notification. The call log updates to active status. |
| Hold | Pressing hold on the physical phone places the caller on hold. The software client reflects the held state. |
| Transfer | Initiating a transfer from the physical phone routes the call to the target extension or agent. |
| Hangup | Ending the call on the physical phone completes the call log entry with duration and disposition. |
Tips
- Label your devices. Use the Friendly name field to give each device a descriptive name (for example, "Front Desk Left" or "Manager Office"). This makes it easier to identify devices in the Device-User Association list when managing multiple phones.
- Find devices fast. Use Search friendly name in the Device-User Association list to locate a specific device when you manage many phones.
- Add every handset at provisioning time. A DECT base station cannot be used until at least one handset is added in the wizard. Adding all handsets in one pass keeps the Handset 1, Handset 2 numbering aligned with how you physically label the handsets.
- Use Static association for dedicated workstations. If a phone is always used by the same employee, choose Specific Employee (Static) association. This avoids the single-browser limitation of dynamic association and ensures the device always rings for the correct person.
- Clear the browser cache with care. If you use Dynamic (Phone device) association, clearing the browser cache resets the association to the last logged-in user. Inform staff to re-establish their dynamic association after any browser cache clear by navigating to the Settings icon > Voice tab > Device-User Association section.
- Verify MAC address before provisioning. The MAC address must match the device exactly. Confirm it on the device label and cross-check by navigating to Menu > Status > Network > Mac Address on the phone before entering it in HyperConnect.
- Contact Zenoti Support for stale registrations. If removing and re-adding a device fails with a generic error, the underlying Yealink cloud registration may not have been cleared. Contact Zenoti Support to resolve stale registrations β this cannot be done from the HyperConnect interface.
Troubleshooting
Phone shows "Unregistered" after provisioning
The device may not have completed registration with the Yealink cloud service. Check that the MAC address and serial number entered in HyperConnect exactly match the values on the device label. Confirm the device has an active Ethernet connection and can reach the internet. If the issue persists, contact Zenoti Support.
Calls ring on the software client but not on the physical phone
Verify that the device is listed in the Settings icon > Voice tab > Device-User Association section and that the correct employee is associated. Confirm the phone display shows a registered status. If using Dynamic (Phone device) association, ensure the employee is logged in to HyperConnect in the same browser session that established the association.
A wireless handset does not ring
Confirm that at least one handset was added in the configuration wizard β a wireless device is not usable without one. Open the device in Device-User Association and check that the handset appears as Handset 1 (or a later number). Then confirm the handset is paired with the DECT base station and that the base station has an active Ethernet connection.
The model you need is not in the Model dropdown
The list of available models in the Model dropdown is managed centrally and changes over time, so not every Yealink model appears. Select the closest Recommended model only if it is the same device; otherwise contact Zenoti Support to confirm whether the model is supported.
Re-adding a removed device fails with a generic error
Removing a device from the HyperConnect interface does not always clear the underlying Yealink cloud registration. Contact Zenoti Support to clear the stale registration. After Zenoti Support confirms the registration has been cleared, sign out of HyperConnect and sign back in before attempting to re-add the device.