Phone Tree Node Configuration β Additional Field Controls
When you build a phone tree (IVR) in HyperConnect, each node on the canvas exposes a set of controls that shape how the system behaves at that point in the call flow. This article covers four supplemental fields β Language, Number on Loop, Timeout Seconds, and Play Audio β plus the Recording toggle and the read-only banner that appears when a node's settings are locked.
Note: For conceptual background on the phone tree designer, see Get started with hyperconnect.
Before you begin
- Your organization must have HyperConnect provisioned and the phone tree feature enabled.
- You must have the Connect Access Enable permission to open HyperConnect settings.
- You need permission to edit phone tree flows. Confirm with your administrator if you cannot save node changes.
Permission: Connect Access Enable β required to access HyperConnect and the phone tree designer. Admin path: Configuration > Security > Security Roles > select a role > scroll to Zenoti HyperConnect > Connect Access Enable
- The phone tree must already exist. To create one, see Configure call routing.
- Open HyperConnect from Chat, then navigate to Settings > Voice tab > Phone Tree section to locate your flows.
Steps
Open a node for editing
- Open HyperConnect from Chat in the main navigation.
- Go to Settings > Voice tab > Phone Tree section.
- Select the flow you want to edit.
- On the canvas, click the node you want to configure. The node's configuration panel opens on the right side of the screen.
Note: If no node is selected, the panel displays: "Select a node in canvas to view its configuration and transitions."
Configure the Language field
The Language field sets the language the node uses when playing audio prompts or interacting with callers.
- In the node configuration panel, locate the Language dropdown.
- Select the language appropriate for this node.
- Click Save to apply.
Note: The language set at the node level applies to the audio and any automated interactions within that node. If your phone tree serves callers in multiple languages, use separate branches with language-specific nodes.
Set the Number on Loop field
The Number on Loop field controls how many times the menu prompt repeats before the system considers the caller unresponsive and progresses to the next configured transition.
- In the node configuration panel, locate the Number on loop field.
- Enter a whole number representing the repeat count (for example,
2causes the prompt to play twice before the system moves on). - Click Save.
Tip: Setting this to
1plays the prompt once with no repetition. Setting it to0may cause the system to proceed immediately β verify with a test call before publishing.
Configure Timeout Seconds
The Timeout Seconds field specifies how long the system waits for caller input after the prompt plays. If no input is received within this window, the node advances to the configured timeout transition.
- Locate the Timeout field in the node configuration panel.
- Enter the number of seconds the system should wait (for example,
5). - Click Save.
Important: Set a timeout that is long enough for callers to respond, but short enough to avoid excessive hold time for unanticipated situations. A value between 5 and 10 seconds is typical for menu prompts.
Associate an audio file with the Play Audio field
The Play Audio field lets you attach an audio clip β such as a greeting, instruction, or menu prompt β to the node.
- In the node configuration panel, locate the Play audio field.
- Click Upload audio file to upload a new file, or select an existing audio clip.
- Accepted format: MP3, up to 10 MB.
- After upload, the audio clip appears in the Audio file field.
- To preview the clip, click Play.
- To replace the file, click the upload control again.
- Click Save.
Note: If this field appears as Invalid input audio file, the uploaded file is in an unsupported format or exceeds the size limit. Re-upload a valid MP3 file.
Enable or disable call recording for a node
The Recording toggle enables or disables call recording for interactions that pass through this node.
- In the node configuration panel, locate the Recording toggle.
- Turn the toggle on to record calls at this node. The label reads: "Turn on the toggle if you want to record the call."
- Turn the toggle off to suppress recording for this node.
- Click Save.
Important: Recording preferences at the node level interact with organization-wide and center-level recording settings. If your center has auto-recording enabled for all calls, the node-level toggle may be overridden. Confirm your center's recording configuration in Settings > Voice tab > Call Recording section before relying on the node toggle alone. For full recording management, see Manage call recordings and transcripts.
Understand the read-only configuration banner
In certain situations β for example, when active-call constraints prevent modifications β the node configuration panel becomes non-editable and displays a banner:
"You cannot modify the configuration of this node at this time."
When this banner appears:
- All fields in the panel are read-only.
- No changes can be saved until the constraint is resolved.
- Navigate away from the node and return later, or check whether an active call is routing through this flow.
Tips
- Test before publishing. Use the Save as draft option to preserve your changes, then test with a real phone call before selecting Publish. Publishing immediately affects live call routing.
- Use descriptive audio files. Upload MP3 files with clear, concise prompts. Avoid background noise and keep individual prompts under 30 seconds for best caller experience.
- Balance loop count and timeout. A loop count of
2paired with a 5-second timeout gives callers approximately 10 seconds of prompt time before the system advances β useful for accessibility. - Language and audio alignment. If you set the Language field to a specific language, ensure the uploaded audio file matches that language. A mismatch creates a confusing caller experience.
- Node recording vs. center recording. If compliance requires recording all calls, do not rely solely on the node-level toggle β verify the center-level auto-record setting is also enabled.
Troubleshooting
| Symptom | Likely cause | Resolution |
|---|---|---|
| Audio file upload fails | File is not MP3 format, or exceeds 10 MB | Re-export the file as a standard MP3 at 128 kbps or lower and verify file size before re-uploading |
| Caller hears the prompt more than expected | Number on Loop is set higher than intended | Reduce the loop count to 1 or 2 in the node configuration panel |
| System advances before caller can respond | Timeout Seconds value is too low | Increase the timeout to at least 5 seconds |
| Node configuration panel shows a read-only banner | Active-call constraints are preventing edits | Wait for the active call to complete, or contact your administrator to identify the constraint |
| Recording does not occur despite the node toggle being on | Center-level recording may override or the toggle was not saved | Verify the Recording toggle is saved, then confirm center-level call recording settings in Settings > Voice tab |