Skip to main content

Alerting

Alerting lets you define rules that automatically monitor your call metrics and notify you when something goes wrong — or right. Get alerted when call volume drops, latency spikes, or custom business metrics cross thresholds, without staring at dashboards all day.

How It Works

1

Define a rule

Create an alert rule with a metric, threshold, agents to monitor, and evaluation parameters.
2

Automatic evaluation

Callem Studio evaluates the rule at your configured frequency (every minute to once a day).
3

Incident creation

When the threshold is crossed, an incident is created and email notifications are sent to the configured recipients.
4

Auto-resolution

When the metric returns to normal, the incident is automatically resolved.

Creating an Alert Rule

Navigate to Monitor > Alerting and click Create Rule.

Rule Configuration

FieldDescriptionOptions
NameDescriptive name for the alerte.g. “Low engagement rate”, “High latency warning”
MetricWhat to measureTotal calls, Avg duration, Engagement rate, Transfer rate, Voicemail rate, LLM latency, TTS latency, Global latency, or a Custom rate
AgentsWhich agents to monitorSelect one, multiple, or all agents. Use Select All / Deselect All for convenience.

Threshold Configuration

SettingDescription
Threshold typeAbsolute — compare the metric value directly to a fixed number (e.g. engagement rate < 50%). Relative — compare the current value to the previous period’s value (e.g. call volume dropped by 30% compared to yesterday).
Comparator> Greater than, >= Greater or equal, < Less than, <= Less or equal
Threshold valueThe value that triggers the alert. For absolute, this is the raw metric value. For relative, this is the percentage change.

Evaluation Parameters

SettingDescriptionValues
Evaluation windowHow far back to look when computing the metric1 minute to 12 hours
FrequencyHow often to evaluate the rule1 minute, 5 minutes, 15 minutes, 30 minutes, 1 hour, 6 hours, 12 hours, 1 day
Notification emailsComma-separated list of email addresses to notify

Custom Rate Metrics

Beyond built-in metrics, you can define alerts on calculated percentages by specifying numerator and denominator filters:

How Custom Rates Work

A custom rate is calculated as: Rate=Calls matching numerator conditionsCalls matching denominator conditions×100\text{Rate} = \frac{\text{Calls matching numerator conditions}}{\text{Calls matching denominator conditions}} \times 100

Examples

AlertNumeratorDenominatorThreshold
Hot lead rate too lowcallAnalysis.leadQuality = hotisEngaged = true< 20%
Appointment booking ratecallAnalysis.appointmentBooked = trueAll calls< 15%
Negative sentiment spikecallAnalysis.sentiment = negativeisEngaged = true> 25%
Automated call successcallAnalysis.issueResolved = trueisVoicemail = false< 70%

Condition Logic

Both numerator and denominator support multiple conditions combined with AND or OR logic.

Call Analysis Filters

Add conditions based on your custom call analysis fields to create highly targeted alerts. The available fields are loaded dynamically from your agent configurations. Built-in filter fields:
  • duration, isEngaged, isTransferred, isVoicemail, callerNum, totalInteraction
Call Analysis filter fields (from your agent config):
  • Any field you’ve defined (e.g. sentiment, leadQuality, appointmentBooked, npsScore)
These fields appear in a separate “Call Analysis” section in the filter UI.

Evaluation Schedule

By default, alerts evaluate 24/7. You can restrict evaluation to specific windows to prevent false alarms during off-hours:
SettingDescription
DaysSelect which days of the week (e.g. Monday to Friday)
Time rangesOne or more time windows (e.g. 9:00-13:00 and 14:00-20:00)
Hourly frequencyEvaluate once per hour instead of continuous
Example: “Only evaluate this alert Monday to Friday, 9:00-13:00 and 14:00-18:00” — avoids alerts during nights, lunch breaks, and weekends when low volume is expected.
Scheduling is particularly useful for volume-based alerts. A “total calls < 10” alert would fire every night if evaluated 24/7, but is meaningful only during business hours.

Alert States

StateDescriptionVisual
OKMetric is within normal rangeGreen indicator
FiringThreshold has been crossed — incident created, notifications sentRed indicator
ResolvedMetric returned to normal — incident closed automaticallyReturns to green

Alert Rules List

The alert rules list provides an at-a-glance view of all your rules:
ColumnDescription
NameAlert rule name
StatusEnabled/disabled toggle
StateCurrent state (OK / Firing)
Last metric valueThe most recently measured value — useful for verifying that the alert definition is correct and the evaluation is working
Last evaluatedWhen the rule was last checked
BadgesIndicators for Custom Rate, Scheduled, etc.
Use Last metric value and Last evaluated to verify your alert rules are working correctly. If the value seems wrong, review your metric definition and filters.

Best Practices

Begin with alerts on critical metrics: total call volume (is the system working?), engagement rate (are calls successful?), and global latency (is the agent responsive?). Add specific custom rate alerts once the basics are covered.
Look at your analytics dashboard to understand normal metric ranges before setting thresholds. A threshold that’s too tight creates alert fatigue; too loose misses real issues.
If your agents only handle calls during business hours, schedule volume and rate alerts accordingly. Latency alerts can often run 24/7 since they indicate system health.
Built-in metrics catch infrastructure issues (latency, volume drops). Custom rates catch business quality issues (lead quality, appointment rates, sentiment).
As your call patterns change (seasonal volume, new agents, new prompts), revisit your alert thresholds and schedules to keep them relevant.