Configure Staff Alerts
configure_staff_alertsSet the phones, emails, escalation rules, and lead alert thresholds that KaiCalls staff alerts use. Each list you send replaces the saved list, so read current settings first and send every entry to keep.
Instructions
Save the business's alert contacts and post-call escalation rules. Read get_operational_settings first: each list you send (notification_phone, notification_email, escalation_rules) replaces the whole saved list, so include the entries to keep. Listed phones get after-call summary texts and escalation texts (one-recipient alerts go to the first phone); listed emails get escalation emails. lead_alerts chooses every lead or qualified leads only, and kaicalls_updates_enabled turns KaiCalls product and setup mail on or off (both default to quiet for a business a partner set up). Saving does not prove delivery.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "configure_staff_alerts"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| dry_run | No | Validate and show the proposed settings without writing. | |
| business_id | No | Business ID (optional only when the token has exactly one accessible business) | |
| lead_alerts | No | 'qualified' = alert only on leads scored 70+ and stop the per-call 'a call came in' texts and emails; 'all' = every real lead; 'default' = the account default (qualified for a business set up by a partner, else all). | |
| escalation_rules | No | Post-call escalation rules checked against each finished call. Replaces the saved rules. Each rule is { id?, when, then, enabled? }. | |
| sms_notifications | No | Enable or disable SMS staff alerts for this business. | |
| notification_email | No | Email addresses that get escalation emails. Replaces the saved list. Comma-separated string or array. | |
| notification_phone | No | Phones that get alert texts; the first also gets one-recipient alerts. Replaces the saved list. Comma-separated string or array. | |
| email_notifications | No | Enable or disable email staff alerts for this business. | |
| lead_alert_min_score | No | Exact lead score bar for alerts (0 = every lead). Overrides lead_alerts. null = account default. | |
| kaicalls_updates_enabled | No | KaiCalls product news, setup tips, weekly summaries and account nudges to this business. Off by default for a business set up by a partner. Billing receipts and team invitations always go. null = account default. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| error | No | Present when success is false | |
| dry_run | No | ||
| success | Yes | Whether the tool completed successfully | |
| settings | No | ||
| business_id | No | ||
| current_settings | No | ||
| proposed_settings | No |