Agent Status Configuration (HyperConnect Integration)
The Agent status tab in AI Lead Manager lets you control which HyperConnect agent statuses count as available for lead assignment routing. When a workflow assigns a lead to an agent using round robin or a specific-employee rule, only agents in statuses you mark eligible receive new leads. This article explains how to view, configure, and refresh agent statuses.
Audience: Administrators who configure AI Lead Manager settings for centers that use HyperConnect.
Availability: The Agent status tab is visible only when the HyperConnect integration with agent status management is enabled for your center. If the tab does not appear in your AI Lead Manager configuration, contact your Zenoti representative to confirm that HyperConnect agent status management is active for your center.
On this page
Before you begin
Your center must have the HyperConnect integration with agent status management active. If the Agent status tab is not visible on the AI Lead Manager configure page, the feature is not enabled for your center.
You need the following permissions to edit lead assignment settings:
Permission: Edit on My Leads β Required to edit lead configuration for leads assigned to you. Admin path: Lead Management > AI Lead Manager > Lead settings > Configure
Permission: Edit on All Leads β Required to edit lead configuration across all agents. Admin path: Lead Management > AI Lead Manager > Lead settings > Configure
Agent statuses are sourced from HyperConnect. You cannot create, rename, or delete statuses from within AI Lead Manager. Any changes to status definitions must be made in HyperConnect.
Changes to eligibility toggles are held as pending edits until you select Save. No changes are sent to the server until you explicitly save.
Steps
Open the Agent status tab
Navigate to Lead Management > AI Lead Manager > Lead settings.
Select the Lead configuration option, which uses the label {Opportunity} configuration in the sidebar.
On the configuration page, select the Agent status tab.
Note: If the Agent status tab is not visible, agent status management has not been enabled for your center in HyperConnect. Contact your administrator or Zenoti representative.
Review agent statuses
The Agent status tab displays all statuses returned from HyperConnect, organized into two grouped sections:
| Section | What it contains |
|---|---|
| System status | Built-in HyperConnect statuses (such as Available, Busy, or Offline). The count of statuses in this group is shown in the section heading. |
| Custom status | Statuses your organization has defined in HyperConnect. The count is shown in the section heading. |
Each status row displays the following read-only information sourced from HyperConnect:
| Column | Description |
|---|---|
| Status | The status name as defined in HyperConnect, shown with a colored dot using the status color code. |
| Eligible for assignment | A toggle indicating whether agents in this status are available to receive new leads. |
Note: The status name, color, and description are owned by HyperConnect and cannot be edited in AI Lead Manager. Statuses are listed in the order returned by HyperConnect.
Set eligibility for assignment
- Locate the status you want to configure in either the System status or Custom status group.
- Toggle the Eligible for assignment switch:
- On β Agents in this status are considered available for lead assignment routing (round robin, specific employee, or workflow-based assignment).
- Off β Agents in this status are excluded from lead assignment routing. Leads will not be routed to agents with this status.
- Repeat for each status you want to configure.
Important: Your changes are held as pending edits. They are not saved until you select Save on the page. If you navigate away without saving, your changes are lost.
Worked example: Your center uses three statuses β Available (system), On a call (custom), and Break (custom). You want leads to route only to agents who are Available. Toggle Eligible for assignment on for Available and off for On a call and Break, then select Save.
Save your changes
- After setting eligibility toggles for all relevant statuses, select Save on the configuration page.
- Confirm that the settings saved successfully. All pending toggle changes are sent to the server at this point.
Refresh the status catalog
The status catalog is fetched from HyperConnect when the tab loads. If your HyperConnect administrator adds, removes, or renames statuses, use the Refresh button to pull the latest catalog.
- On the Agent status tab, select Refresh.
- AI Lead Manager re-fetches the agent status catalog from HyperConnect.
- Any eligibility toggle changes you made that have not yet been saved are preserved for statuses that still exist after the refresh.
Note: If HyperConnect is unreachable when you select Refresh, and stored status records are available, a warning banner appears on the tab indicating that cached data is being shown and, when available, the date and time the catalog was last synced from HyperConnect.
If no statuses are returned:
When no agent statuses are available and an automatic refresh also returns an empty result, the tab displays an empty state with a Retry action. This typically indicates that agent status management has not been fully configured in HyperConnect for your center.
If the status catalog fails to load:
If loading agent statuses fails, the tab displays an error message with a Retry action. Select Retry to attempt to reload the catalog. If the error persists, contact your HyperConnect administrator.
Tips
- Plan your eligibility settings before saving. Because all pending changes are committed together when you select Save, review all toggle positions before saving to avoid sending an incomplete configuration.
- Align status eligibility with your team's workflow. If agents use custom statuses to indicate temporary unavailability (such as a training status), turn off eligibility for those statuses so that leads are not assigned to unavailable agents.
- Refresh after HyperConnect changes. When your HyperConnect administrator adds or removes agent statuses, use Refresh on the Agent status tab to ensure AI Lead Manager shows the current catalog. Eligibility settings for statuses that still exist after a refresh are preserved.
- Review the cached-data banner carefully. If the warning banner appears indicating cached data is shown, your eligibility configuration is based on the last synced status list. Wait until HyperConnect is reachable and select Refresh again to ensure your settings apply to current statuses.
Troubleshooting
The Agent status tab does not appear on the configuration page.
The tab is visible only when HyperConnect agent status management is enabled for your center. Confirm with your Zenoti representative or HyperConnect administrator that the feature is active. If you recently had it enabled, try refreshing the page.
A warning banner shows that cached data is displayed.
AI Lead Manager could not reach HyperConnect when the tab loaded or when you selected Refresh. The banner shows the last known sync date and time when available. Your eligibility settings are still configurable against the cached statuses. Select Refresh again when HyperConnect connectivity is restored to load the current catalog.
After saving, a message says agent statuses changed in HyperConnect and the list was reloaded.
If the status catalog changed in HyperConnect between when you loaded the tab and when you selected Save, AI Lead Manager reloads the list and preserves your edits for statuses that still exist. Review the reloaded list and select Save again to confirm your settings against the current catalog.
The Retry action on the empty state does not load any statuses.
If the empty state persists after selecting Retry, agent status management may not be configured for your center in HyperConnect. Contact your HyperConnect administrator to confirm the setup. Once HyperConnect is configured, select Refresh on the Agent status tab to load the catalog.
Eligibility changes are not taking effect in lead assignment.
Confirm that you selected Save after making toggle changes β pending edits are not sent to the server until saved. Also confirm that the workflow or assignment rule using the agent statuses is active and published in AI Lead Manager.