You can add, update, and delete Webex devices in Automate, including collaboration devices, ATA (analog telephone adaptor) devices, MPP (IP desk phone) devices, and Wi-Fi devices.

You can also add Webex devices in the Webex Control Hub and sync in those devices to the correct hierarchy in Automate.

Webex devices are added by their MAC address to either a user or to a new or existing workspace. In Automate, devices can be added and updated via the Webex Devices management page (described in this topic) or via Quick Add Webex Device.

Cisco Webex App devices are managed via the Webex Devices page, on the following tabs:

Device tab/panel

The Device tab/panel displays read-only device details, such as the MAC address (device name) for a particular device.

When adding a device, you'll choose the product (device type), and define whether to associate the device with a workspace or a person. When choosing a device, configuration settings relevant to the device type become available in Advanced Configuration.

Note

A device can be associated either with a workspace or with a person (Webex user), but not with both.

A device associated with a person is defined as a personal device. The Person column in the Webex Devices summary list view displays the person ID (converted to an email address) when a person (rather than a workspace) is associated with a device.

The email address is used to identify the device and the associated user so that both can be moved to the correct hierarchy in a sync.

Advanced Configuration tab/panel

The Advanced Configuration tab/panel defines the calling parameters for a device. The available configuration settings depend on the device type, for example, MPP, ATA, or Wi-Fi device.

If you wish to apply custom configuration settings to the device, select Define customized device settings to display the additional custom configuration options for the device.

Note

Device-specific custom configuration settings are the same settings that may be defined on the Control Hub for the device type.

The image displays custom configuration settings for a MPP device:

Note

For a MPP device, default PSK (programmable soft key) settings are automatically populated from the Control Hub. All the PSK fields on the form are editable string fields and can be added to or changed, or reset to default values, if required.
For a MPP device, settings in the Customize softkey menus fields comprise default values retrieved from the Control Hub, and are semi-colon separated lists of items that will display for the softkeys. These settings are editable strings that can be customized, or reset to default values, if required.

To reset values for the custom softkey menus or the PSKs, select the applicable Reset to Default Values checkbox. When saving your settings, the default values are retrieved from the Control Hub to replace any custom values.

The image displays custom configuration options for an ATA device:

The image displays custom configuration options for a Wi-Fi device:

Hide custom configuration settings

To hide the custom settings and apply default settings from the Control Hub for the customer and site, deselect Define customized device settings.

Model Details: device/spark/Device

An asterisk * in the title indicates the field is mandatory.
If a field has a default value, it is shown in the Description column.
If the field type is an array, the Field Name has a .[n] suffix, where n is the array index placeholder.
Object and array field names are listed to provide context. If a field belongs to an object or an array, the full field name is shown in dot separated notation.

Title			Description	Details
Identity			Group Assigned by FDP	Field Name: Identity Type: Object
	Name		A friendly name for the device.	Field Name: Identity.displayName Type: String
	Product		The product name.	Field Name: Identity.product Type: String
	Model		The model name - e.g. DMS Cisco 8845	Field Name: Identity.model Type: String
	Type		The product type.	Field Name: Identity.type Type: String
	Webex Device ID		A unique identifier for the device specifically for use with Webex Devices APIs.	Field Name: Identity.webexDeviceId Type: String
	Calling Device ID		A unique identifier for the device specifically for use with Webex Calling APIs.	Field Name: Identity.callingDeviceId Type: String
Associations			Group Assigned by FDP	Field Name: Associations Type: Object
	Organization ID		The organization associated with the device.	Field Name: Associations.orgId Type: String
	Workspace Id		The workspace ID associated with the device.	Field Name: Associations.workspaceId Type: String
	Workspace		The workspace Name associated with the device.	Field Name: Associations.workspaceName Type: String Target: device/spark/Place Target attr: displayName Format: uri
	Location Name			Field Name: Associations.locationId Type: String Target: device/spark/Location Target attr: name Format: uri
	Person Id		The person ID associated with the device.	Field Name: Associations.personId Type: String Target: device/spark/User Target attr: email Format: uri
	Person		The person Email associated with the device.	Field Name: Associations.personEmail Type: String Target: device/spark/User Target attr: email Format: uri
	Managed By		The entity responsible for managing the device.	Field Name: Associations.managedBy Type: String
Network			Group Assigned by FDP	Field Name: Network Type: Object
	IP Address		The current IP address of the device.	Field Name: Network.ip Type: String
	MAC Address		The unique address for the network adapter.	Field Name: Network.mac Type: String
	Active Interface		The current network connectivty for the device.	Field Name: Network.activeInterface Type: String
SIP & Calling			Group Assigned by FDP	Field Name: SIP & Calling Type: Object
	Primary SIP URL		The primary SIP address to dial this device.	Field Name: SIP & Calling.primarySipUrl Type: String
	SIP URLs		All SIP addresses to dial this device.	Field Name: SIP & Calling.sipUrls Type: String
Status & Health			Group Assigned by FDP	Field Name: Status & Health Type: Object
	Connection Status		The connection status of the device.	Field Name: Status & Health.connectionStatus Type: String
	Errors		This device has the following issues.	Field Name: Status & Health.errorCodes Type: String
	Capabilities		The capabilities of the device.	Field Name: Status & Health.capabilities Type: String
	Permissions		The permissions the user has for this device. For example, xapi means this user is entitled to using the xapi against this device.	Field Name: Status & Health.permissions Type: String
	Planned Maintenance		The maintenance mode of the device.	Field Name: Status & Health.plannedMaintenance Type: String
	Lifecycle		The lifecycle status of the device.	Field Name: Status & Health.lifecycle Type: String
Software & Updates			Group Assigned by FDP	Field Name: Software & Updates Type: Object
	Software		The operating system name data and version tag.	Field Name: Software & Updates.software Type: String
	Software Version		Parsed software version (major.minor.patch.build).	Field Name: Software & Updates.softwareVersion Type: String
	Device Platform		The platform the device runs on.	Field Name: Software & Updates.devicePlatform Type: String
	Upgrade Channel		The upgrade channel the device is assigned to.	Field Name: Software & Updates.upgradeChannel Type: String
Lifecycle & Timestamps			Group Assigned by FDP	Field Name: Lifecycle & Timestamps Type: Object
	Created		The date and time that the device was registered, in ISO8601 format.	Field Name: Lifecycle & Timestamps.created Type: String
	First Seen		Timestamp of the first time the device sent a status post.	Field Name: Lifecycle & Timestamps.firstSeen Type: String
	Last Seen		Timestamp of the last time the device sent a status post.	Field Name: Lifecycle & Timestamps.lastSeen Type: String
Inventory			Group Assigned by FDP	Field Name: Inventory Type: Object
	Serial		Serial number for the device.	Field Name: Inventory.serial Type: String
		Tags	Tags assigned to the device.	Field Name: tags.[n] Type: Array

Model: device/spark/Device

Devices (Webex App)

Device tab/panel

Lines tab/panel

Advanced Configuration tab/panel

Model Details: device/spark/Device