Configure Agent Evaluation Metrics
HyperConnect allows administrators to define and customize the metrics used to evaluate agent performance during voice interactions. By adjusting metric weightages and adding custom metrics, you can align performance scoring with your organization's service standards and priorities.
Audience: Administrators who manage HyperConnect voice settings and agent performance evaluation.
Before you begin
HyperConnect must be enabled for your organization.
You need the following permission:
Permission: Connect Access Enable β Required to access HyperConnect settings. Admin path: Organization > Security > Security Roles > [your role] > Zenoti HyperConnect > Connect Access Enable
Steps
Open agent evaluation settings
- Open HyperConnect by navigating to Chat in the main navigation.
- Click the Settings icon in the app header.
- Select the Voice tab.
- Scroll to the Agent Performance Evaluation section.
The section displays the current list of evaluation metrics, including system-provided metrics and any custom metrics you have added. Each metric shows its name, definition, and current weightage percentage.
Edit metric weightages
- In the Agent Performance Evaluation section, locate the metric whose weightage you want to change.
- Click the Weight % field for that metric and enter the new percentage value.
- Repeat for each metric you want to adjust.
Important: The total weightage across all metrics must equal exactly 100% before you can save. If the total does not equal 100%, the system displays the error: Total weightage must equal 100%. Adjust individual metric values until the sum reaches 100%.
- Once the total equals 100%, click Save.
Add a custom metric
You can add up to a maximum of eight evaluation metrics in total (system-provided and custom combined).
- In the Agent Performance Evaluation section, click Add new metric.
- In the Metric field, enter a name for the custom metric.
- In the Definition field, enter a description that explains what the metric measures and how agents should be evaluated against it.
- In the Weight % field, enter the weightage percentage for this metric.
Note: Adding a new metric changes the total weightage. Adjust the weightages of other metrics so that the total remains at 100% before saving.
- Click Save.
Important: If any metric name or definition is invalid, the system displays: One or more metrics are invalid. Please review and try again. Review all metric fields and correct any errors before saving.
Remove a custom metric
System-provided metrics cannot be removed. You can only remove metrics that you have added.
- In the Agent Performance Evaluation section, locate the custom metric you want to remove.
- Click Delete next to that metric.
- Adjust the remaining metric weightages so that the total equals 100%.
- Click Save.
Reset metrics and weightages
To restore the default system metrics and weightages:
- In the Agent Performance Evaluation section, click Reset.
- A confirmation dialog appears: Reset confirmation β Are you sure you want to reset the metrics & weightage.
- Click Confirm to proceed.
Important: Resetting removes all custom metrics and restores the default system-provided metrics with their original weightage values.
Tips
- Plan your weightage distribution before making changes. Sketch out the percentages for all metrics so they sum to 100% before you begin editing.
- Use the Definition field to give agents clear guidance on what each metric measures. Specific definitions reduce ambiguity during performance reviews.
- If you are close to the eight-metric limit, consider whether an existing custom metric can be broadened rather than adding a new one.
- After saving, verify the updated metrics appear correctly in the call analysis view for recent calls to confirm the configuration is active.
Troubleshooting
| Problem | Resolution |
|---|---|
| Save is blocked and the error "Total weightage must equal 100%" appears | Review the Weight % field for each metric. Adjust values until the sum of all metrics equals exactly 100, then click Save again. |
| The Add new metric button is not available | You have reached the maximum of eight metrics. Remove an existing custom metric before adding a new one. |
| "One or more metrics are invalid" error appears on save | Check each metric's Metric name and Definition fields. Ensure neither field is empty and that the metric name does not duplicate an existing metric name. |