manage-call-settings

Configure person, workspace, and virtual line call settings in Webex Calling via wxcli.

3|Updated Mar 20, 2026
One-click install
npx skills add https://github.com/achobgood/wxops --skill manage-call-settings-achobgood
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: manage-call-settings
Source: https://github.com/achobgood/wxops/tree/main/.claude/skills/manage-call-settings
Command: npx skills add https://github.com/achobgood/wxops --skill manage-call-settings-achobgood

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Webex Calling exposes dozens of person-level, workspace-level, and virtual-line call settings across multiple API path families and CLI command groups, making it easy to use the wrong command, wrong scope, or wrong token type. This Skill maps each setting to the correct wxcli command group, required OAuth scopes, and known pitfalls so configuration changes succeed on the first attempt. ## Core Features & Use Cases - Scoped settings router: Routes any call setting (voicemail, forwarding, recording, SimRing, hoteling, monitoring, MS Teams, billing plans) to the correct command group across person, workspace, virtual line, location, org, and self-service scopes. - Verified command recipes: Provides tested wxcli command sequences for multi-step workflows like executive-assistant pairing, recording prerequisite chains, and mode management, with PUT-replacement and bare-name traps documented. - Scope and token validation: Maps every setting to its required OAuth scopes (people, telephony_config, workspaces, user-level self-service) so auth failures are caught before execution. - Use Case: An admin needs to enable call recording for a user. The Skill walks the three-level prerequisite chain (org vendor, location assignment, person setting) using wxcli call-recording and wxcli user-settings with the correct JSON body. ## Quick Start Ask the assistant to show or update a specific call setting for a user or workspace, for example: enable voicemail transcription for [email protected] using wxcli.

Frequently Asked Questions about manage-call-settings

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I configure call settings for a Webex Calling user from the CLI?

Use the wxcli user-settings command group with the person's ID, for example wxcli user-settings show-call-forwarding PERSON_ID. Look up the ID first with wxcli users list --email, and verify your token has spark-admin:people_read or people_write scope via wxcli whoami.

How do I enable call recording for a Webex user?

Call recording requires a three-level chain: configure the org vendor with wxcli call-recording, assign the vendor per location, then enable the person with wxcli user-settings update-call-recording using a JSON body. Direction-specific recording toggles require --json-body since no flags exist.

Why does updating workspace call settings return a 405 error?

Basic-licensed workspaces only support musicOnHold and doNotDisturb on the /telephony/config/workspaces/ path; other settings return 405 Invalid Professional Place. Use the /workspaces/{id}/features/ path for Basic workspaces, or upgrade to a Professional license.

Can an admin switch operating modes for a user in Webex Calling?

The mode-management command group is user-only and returns 404 for admin tokens because it uses /people/me/ endpoints. Admins can switch modes through per-feature location-scoped commands like auto-attendant switch-mode-for, call-queue switch-mode-for, or hunt-group switch-mode-for.

What settings require user-level OAuth instead of an admin token?

Self-service settings under /people/me/ require user-level OAuth with spark:people_read or spark:people_write scopes. These include sequential ring, priority alert, call notify, personal assistant, and hoteling guest settings, all accessible via the wxcli my-call-settings group.

How do I configure settings on a Webex virtual line?

Use the dedicated wxcli virtual-line-settings group, which mirrors most person settings with 65+ commands for forwarding, voicemail, permissions, caller ID, and billing. Do not use user-settings commands on a virtual line ID; detail is retrieved with show-virtual-lines, not the bare show command.