00 · Header

T2 · Webex Calling

Devices & Provisioning

Gateway Calling T2-R04 PhoneControl HubCUBEPSTN
Illustrated scene for Devices & Provisioning. Original drawing, not a product screenshot.
Sequence · Phone → Control Hub → CUBE → PSTN PhoneControl HubCUBEPSTN 123
Color-coded sequence: Phone → Control Hub → CUBE → PSTN. A packet moves along the arrows. Reduced motion keeps every step visible.

A phone joins Webex Calling by MAC address or by a 16-digit activation code. A blank MAC in Control Hub generates the code. The code lasts 30 days on an MPP phone and 7 days on a Room device. A professional workspace license holds up to five phones. A common-area workspace holds one.

Room T2-R04Version v0.1last-verified: 2026-10-14Difficulty L2Est. time 70–90 minPrereq T2-R01, T1-R04Reading 18 min

01 · Executive summary

Five lines, then why it matters

  • MPP firmware 11.3.1 SR2 or later is required to enter an activation code on the phone. The phone reboots and onboards after the code is entered. [cite:1]
  • CSV device type IP is for MPP, ATA, and DECT. WEBEX or WEBEX_CALLING is for RoomOS workspaces. The article’s example MAC is 001A2B3C4D5E. [cite:1]
  • A workspace device is assigned to the workspace, not to a user. Add it from Management > Devices > Add device, or from Management > Workspaces. [cite:3]
  • Calling service choices for a Board, Desk, or Room workspace include None, Call on Webex (1:1, non-PSTN, the default), Cisco Webex Calling, premises calling, and legacy Hybrid Calling. [cite:3]
  • Only specific roles can generate activation codes. The article points at the organization-role article for which roles. Role names stay in T1-R05. [cite:2]
Why it matters. A phone without a MAC or a code never registers. The license on the workspace decides whether a second phone is even allowed.

02 · Architecture map

Two ways onto the cloud

  • 1MAC
  • 2Activation code
  • 3User or workspace
  • 4Onboard
Mermaid source (not rendered)
flowchart LR
  Admin[Control Hub] --> MAC[MAC claim]
  Admin --> Code[16-digit code]
  Code --> Phone[Phone reboot]
  Phone --> Cloud[Webex Calling]

Studio asset still required: assets/diagrams/T2-R04/arch.svg

03 · Concept deep-dive

Claim, license, then calling service

The add-device article is dated September 01, 2026. The activation-code article is dated January 12, 2026. The shared-workspace article is dated April 21, 2026. [cite:1] [cite:2] [cite:3]

MAC16-digit codeMPPRoomOSWorkspace license
VISUAL placeholder · assets/images/T2-R04/hero.png · Studio draws a MAC label beside a 16-digit code.

Activation-code models named on September 01, 2026

FamilyModels the article lists for activation codesCite
6800 MPP audio6821, 6841, 6851[cite:1]
7800 MPP audio7811, 7821, 7841, 7861[cite:1]
8800 MPP audio8811, 8841, 8851, 8861[cite:1]
8800 MPP video8845, 8865[cite:1]
Conference7832 and 8832[cite:1]
Other namedDesk Phone 9800, Wireless 9821, Video Phone 8875[cite:1]

The same article says all listed devices can register by MAC address, and that the activation-code path is the subset above. Use activation codes for RoomOS. [cite:1]

Workspace limits and calling choices

RuleSentence to keepCite
Professional workspaceUp to five Cisco desk phones, Cisco MPP phones, wireless, ATAs, Phone OS, or third-party devices.[cite:3]
Where the extra phones are addedOnly from the new workspace page. Turn on Try new Workspaces. A notification blocks you at the maximum. Add Device is disabled at the maximum.[cite:3]
Common areaOnly one device.[cite:3]
AssignmentThe device belongs to the workspace, not to a user.[cite:3]
NameA workspace name cannot be longer than 128 characters and cannot contain % # < > / \ or ".[cite:3]
NoneNo calling service. Used for a standalone Room Navigator, Room USB, or Microsoft Teams Rooms.[cite:3]
Call on Webex1:1 call, non-PSTN. Default for Webex App and SIP address calling.[cite:3]
Cisco Webex CallingAssign a phone number and extension. PSTN may come from a local gateway, a service-provider bundle, or a cloud-connected PSTN provider.[cite:3]
One device typeA single space holds one type of device. Companion Mode is the exception: one Board and one Room Series device. A Room Navigator can be added in standalone mode.[cite:3]
DeleteDeleting a workspace that has an online MPP also deletes the phone and factory-resets it. An offline phone needs a manual factory reset.[cite:3]

Code handling

FactValueCite
Length16 digits[cite:2]
MPP expiry30 days[cite:2]
Room device expiry7 days[cite:2]
DeliveryCopy, Email, or Print. You can email a user other than the assignee.[cite:2]
Workspace pathWorkspaces, select the workspace, Add Device[cite:2]
User pathUsers, select the user, Devices, Add Device[cite:2]
CSV blank MACProvide a link, or email the activation code. Workspace mail goes to an admin. User mail goes to the user.[cite:1]
MPP actionsAdd, remove, reboot, check activation, new activation code. Apply config or update firmware.[cite:1]
ATA networkSet VLAN, IP address, and subnet mask before activation.[cite:2]
Tip

Enter the activation code only after the MPP is on firmware 11.3.1 SR2 or later. The phone reboots as part of onboarding. [cite:1]

Gotcha

An ATA’s network settings are fixed once the device activates. Change VLAN, IP address, and subnet mask before you enter the code. [cite:2]

License neighbor

Professional versus common-area calling licenses, and the rule that a professional workspace cannot be downgraded to common area, are in T1-R03. This room uses the device counts from the workspace article.

04 · Ecosystem

Ecosystem and sister technologies

PhoneControl HubCUBEPSTN This room
Mini map of the neighbors named on this room’s sequence. Orientation sketch, not a new product claim.

Glossary

MAC claim
Registration by the device MAC address. The add-device article says every device it lists can use this path. [cite:1]
Activation code
A 16-digit code from Control Hub. Blank MAC generates one. [cite:1] [cite:2]
MPP
Multiplatform phone. The activation-code subset is the model list in the core table. [cite:1]
RoomOS
The article says to use activation codes for RoomOS, and CSV types WEBEX or WEBEX_CALLING for RoomOS workspaces. [cite:1]
Professional workspace license
Allows up to five of the phone types the April 21, 2026 article names. [cite:3]
Common area workspace license
Allows one device on the workspace. [cite:3]
Call on Webex
1:1, non-PSTN calling. The default calling service when you add Board, Desk, or Room devices. [cite:3]
Companion Mode
The exception that allows one Board and one Room Series device in the same workspace. [cite:3]

Mind map

Mermaid source (not rendered)
mindmap
  root((Device))
    MAC
    Activation code
    Workspace license
    Calling service
    ATA network

Sister-technology matrix

SisterWhat it isWhy it matters hereConfig touchpointTypical failureCite
LocationsThe workspace is placed in a location. Cisco Webex Calling then takes a number from that location.T1-R04 owns locations. The number is chosen here.Location and phone number on the workspace wizard. The location updates during the nightly resync.A number from the wrong location.[cite:3]
LicensesProfessional workspace versus common area.Five devices versus one.Calling service step in the add-device wizard.A second phone on a common-area workspace.[cite:3]
PSTNLocal gateway, service-provider bundle, or CCP when Cisco Webex Calling is selected.Call on Webex is non-PSTN.Calling service choice.Expecting PSTN from the default Call on Webex choice.[cite:3]
Admin rolesOnly specific roles generate activation codes.T1-R05 lists who can add devices.The role article fs78p5, which ndb7w0db points at.A read-only admin trying to mint a code.[cite:2]
Firmware11.3.1 SR2 or later to type a code on an MPP.The phone cannot onboard on an older load.MPP Actions: update firmware.A code typed on older firmware.[cite:1]
CalendarOptional scheduling for OBTP. Hybrid Calendar is required for that option.A room device can be a calling device and a calendar resource.Scheduling on the workspace wizard.OBTP with no calendar mailbox.[cite:3]
Edge for DevicesPremises calling links an on-premises registered device.Different from Cisco Webex Calling.Premises calling choice.Mixing it with a cloud MAC claim.[cite:3]
IdentityHot desking lets a user sign in to a shared Board or Desk Series device with a Webex identity.The device stays on the workspace. The person is a sign-in.Hot desking toggle.Assigning the room phone to a user record.[cite:3]

Integration edges

FromToMechanismWhat movesCite
Control HubMPPMAC addressDevice claim for listed models[cite:1]
Control HubPhone or RoomOS16-digit activation codeOnboarding after reboot[cite:1] [cite:2]
CSVControl HubDevice type IP, WEBEX, or WEBEX_CALLINGBulk claim. Blank MAC yields a code.[cite:1]
AdminAssignee or another userCopy, Email, or PrintThe code[cite:2]
Workspace wizardLocationCalling service Cisco Webex CallingPhone number and extension[cite:3]
Workspace deleteOnline MPPFactory resetPhone returns to the activation-code screen[cite:3]
ATANetworkSettings before activationVLAN, IP address, subnet mask[cite:2]

Cross-platform bridges

Orientation only. Microsoft Teams Rooms is a reason to choose calling service None for a standalone device. The article does not publish a Teams Phone provisioning crosswalk. Enterprise-to-MPP migration licenses are a separate article and are not restated here. [cite:3]

Future-integration hooks

  • MPP Actions already include apply configuration and update firmware. A later room can attach line keys once the phone is online. [cite:1]
  • Canon planning: record code expiry beside the device type so a Room device is not left on a 30-day assumption.
  • The nightly location resync is the article’s timing for a location change on the workspace. [cite:3]

Ecosystem troubleshooting

SymptomLikely sister-system causeCheckFixCite
Add Device is disabled on the workspaceThe workspace is already at its device maximum.Professional cap of five, or common-area cap of one.Remove a device or use a professional license and the new workspace page.[cite:3]
The room has PSTN and the calling service was left on the defaultCall on Webex is 1:1 and non-PSTN.The calling service selected in the wizard.Choose Cisco Webex Calling and assign a number.[cite:3]
A second device type will not addOne type per space, aside from Companion Mode and a standalone Room Navigator.What is already in the workspace.Match the type, or use the documented exception.[cite:3]

05 · Flow

From a blank MAC to a registered phone

StepFromToProtocolNotesCite
1AdminControl HubUsers or WorkspacesAdd Device. Shared usage for a workspace.[cite:2] [cite:3]
2AdminLicenseProfessional or common areaFive versus one.[cite:3]
3AdminClaimMAC or blank MACBlank MAC generates a code. CSV type IP, WEBEX, or WEBEX_CALLING.[cite:1]
4Control HubPerson with the phoneCopy, Email, or Print16 digits. 30 days MPP, 7 days Room.[cite:2]
5MPPFirmware check11.3.1 SR2 or laterRequired before the code is entered.[cite:1]
6PhoneCloudActivationThe phone reboots and onboards.[cite:1]
7ATANetworkLocal settingsVLAN, IP, and mask before step 6.[cite:2]
8WorkspaceLocationNightly resyncLocation is updated during that resync.[cite:3]

06 · Config

Click paths

  1. For a user phone, open Users, select the user, open Devices, and click Add Device. Choose the device type and click Add device. [cite:2]
  2. For a shared phone, open Management > Devices > Add device, or Management > Workspaces > Add workspace. Choose Shared usage, then New workspace. [cite:3]
  3. Name the workspace within 128 characters and avoid % # < > / \ and ". Set room type, capacity, and location. [cite:3]
  4. Choose Cisco Desk Phone, or Cisco MPP, Wireless, ATA, or third-party device with Cisco Managed Devices. Pick Professional workspace or Common area workspace. [cite:3]
  5. Assign the location’s phone number and, if you want one, an extension. Save. [cite:3]
  6. Enter a MAC address, or leave it blank so Control Hub generates an activation code. For RoomOS, use the code. [cite:1]
  7. Copy, email, or print the 16-digit code. On an MPP, confirm firmware 11.3.1 SR2 or later, enter the code, and let the phone reboot. [cite:1] [cite:2]
  8. For an ATA, set VLAN, IP address, and subnet mask before that activation. [cite:2]
  9. For Board, Desk, or Room Series, choose the calling service: None, Call on Webex, Cisco Webex Calling, premises calling, or legacy Hybrid Calling. Activate with the code. [cite:3]

Screenshot placeholder. The paths above are the articles.

07 · Limits

Values the articles state

ItemValueSourceVerified?
Activation code length16 digits[cite:2]Quoted. Header January 12, 2026.
MPP code lifetime30 days[cite:2]Quoted
Room device code lifetime7 days[cite:2]Quoted
MPP firmware for a typed code11.3.1 SR2 or later[cite:1]Quoted. Header September 01, 2026.
Professional workspace devicesUp to 5[cite:3]Quoted. Header April 21, 2026.
Common area devices1[cite:3]Quoted
Workspace name128 characters, excluding % # < > / \ "[cite:3]Quoted
Example MAC001A2B3C4D5E[cite:1]Quoted as the article’s example

08 · Troubleshooting

Eight provisioning failures

SymptomLikely causeEvidenceFixCite
The MPP will not accept the codeFirmware older than 11.3.1 SR2.The phone’s load.Update firmware, then enter the code.[cite:1]
A Room device code from last month failsRoom device codes expire after 7 days. MPP codes expire after 30.When the code was generated and the device family.Generate a new code.[cite:2]
A sixth phone will not addProfessional workspace maximum is five.The device count and the license.The wizard notifies you and disables Add Device.[cite:3]
A second phone on a lobby workspace failsCommon area allows one device.The workspace license.Use a professional workspace license if five devices are required.[cite:3]
ATA VLAN changes disappear after activationNetwork settings cannot be changed after activation.Whether the ATA is already active.Set VLAN, IP, and mask first.[cite:2]
RoomOS was added with a MAC-only planThe article says to use activation codes for RoomOS.The device family.Generate a code. CSV type WEBEX or WEBEX_CALLING.[cite:1]
The room phone has no PSTNCall on Webex is the default and is non-PSTN.The calling service.Select Cisco Webex Calling and assign a number.[cite:3]
A deleted workspace leaves a configured MPPFactory reset runs when the phone is online. An offline phone is not reset.Whether the phone was reachable.Factory-reset an offline phone before reuse.[cite:3]

09 · Self-question ladder

Twelve rungs

L0What two claims does Control Hub offer?

MAC address, or an activation code. A blank MAC generates the code. [cite:1]

L0How long is the code?

16 digits. [cite:2]

L1How long does an MPP code last?

30 days. A Room device code lasts 7 days. [cite:2]

L1Which firmware can type the code?

MPP firmware 11.3.1 SR2 or later. [cite:1]

L2How many devices on a professional workspace?

Up to five of the phone types the article names. [cite:3]

L2How many on a common-area workspace?

One. [cite:3]

L3What is the default calling service for a Room or Desk workspace?

Call on Webex, which is 1:1 and non-PSTN. [cite:3]

L3Which CSV device types cover RoomOS?

WEBEX or WEBEX_CALLING. IP is for MPP, ATA, and DECT. [cite:1]

L4What must you set on an ATA before activation?

Network settings, including VLAN, IP address, and subnet mask. [cite:2]

L4Who may generate a code?

Only specific roles. The article points at the organization-role article rather than listing them. [cite:2]

L5What happens to an online MPP when its workspace is deleted?

The phone is deleted and factory-reset, and it returns to the activation-code screen. [cite:3]

L5When can a Board and a Room Series device share a workspace?

Companion Mode. A standalone Room Navigator can also be added beside other devices. [cite:3]

10 · Lab

Paper phones, no production claim

11 · Quiz

Twelve questions

Q1MCQ

What does a blank MAC produce?

Answer

An activation code. [cite:1]

Q2MCQ

MPP activation-code lifetime?

Answer

30 days. Room devices expire in 7 days. [cite:2]

Q3MCQ

Minimum MPP firmware to type a code?

Answer

11.3.1 SR2. [cite:1]

Q4MCQ

Professional workspace device cap?

Answer

Five of the phone types named in the April 21, 2026 article. [cite:3]

Q5MCQ

Common-area device cap?

Answer

One. [cite:3]

Q6MCQ

Default calling service for a new Room or Desk workspace?

Answer

Call on Webex, 1:1, non-PSTN. [cite:3]

Q7Scenario

You need PSTN on a workspace phone.

Answer

Choose Cisco Webex Calling and assign a number and extension. PSTN may come from a local gateway, a provider bundle, or CCP. [cite:3]

Q8MCQ

CSV type for an MPP?

Answer

IP. WEBEX or WEBEX_CALLING is for RoomOS workspaces. [cite:1]

Q9MCQ

What is fixed on an ATA after activation?

Answer

Network settings such as VLAN, IP address, and subnet mask. [cite:2]

Q10MCQ

Can you email the code to someone other than the assignee?

Answer

Yes. Copy, Email, or Print. [cite:2]

Q11MCQ

What does deleting a workspace do to an online MPP?

Answer

Deletes the phone and factory-resets it. [cite:3]

Q12Draw

Name the two claim methods and the two license caps.

Answer

MAC or 16-digit code. Professional workspace up to five. Common area one. [cite:1] [cite:3]

12 · Audio

Slots for Studio

Transcript slot

Studio fills this.

Transcript slot

Studio fills this.

Transcript slot

Studio fills this.

13 · Interview

Oral answers

30 seconds. I claim a phone by MAC or by a 16-digit activation code. MPP codes last 30 days and Room codes last 7. A professional workspace holds five phones. A common-area workspace holds one.

2 minutes. All of the listed devices can use a MAC. The activation-code subset is the 6800, 7800, and 8800 models the September 2026 article names, plus 7832, 8832, 9800, 9821, and 8875. RoomOS uses a code, and the CSV types are WEBEX or WEBEX_CALLING. An MPP needs firmware 11.3.1 SR2 before the code is typed, then it reboots. I can copy, email, or print the code, including to someone who is not the assignee. An ATA gets its VLAN and IP address first, because those settings lock after activation. If the room needs PSTN I choose Cisco Webex Calling, not the default Call on Webex service.

30 seconds, delete. Deleting a workspace factory-resets an online MPP and returns it to the code screen. An offline phone needs a manual reset.

2 minutes, what I will not merge. I will not put a second device type in one space unless Companion Mode or a standalone Room Navigator applies. I will not promise PSTN on Call on Webex. I will not generate a code with a role the organization-role article does not allow. Migration licenses from Enterprise firmware are a different article.

What you will say about the nightly job. The workspace article says the location is updated during the nightly resync.

14 · Citations

  1. Add a device — help.webex — article n9r1aac — help.webex.com article n9r1aac — header September 01, 2026 — retrieved 2026-10-14. MAC or activation code, model subset, RoomOS codes, CSV types IP and WEBEX or WEBEX_CALLING, example MAC, firmware 11.3.1 SR2, MPP actions, phone reboot.
  2. Generate an activation code for a device — help.webex — article ndb7w0db — help.webex.com article ndb7w0db — header January 12, 2026 — retrieved 2026-10-14. 16 digits, 30 days for MPP, 7 days for Room devices, Copy Email or Print, ATA network settings before activation, role pointer.
  3. Add shared devices and services to a workspace — help.webex — article 1mqb9cb — help.webex.com article 1mqb9cb — header April 21, 2026 — retrieved 2026-10-14. Five devices on a professional workspace, one on common area, calling service choices, workspace name rules, Companion Mode, delete and factory reset, nightly location resync.

15 · Re-engineer later

  • Open questions: whether the activation-code model list gains phones after September 01, 2026.
  • Facts still TODO-verify: 0.
  • Assets missing: Add Device screenshot, audio.
  • Ideas for v1.0: a card that pairs device family with code lifetime.
  • Next review: when n9r1aac or 1mqb9cb changes the model list or the five-device cap.

Sources and go deeper

Checked links were opened this month. A confirm row has no address because that page was not opened.

sources.json for this page.