> For the complete documentation index, see [llms.txt](https://docs.spectralink.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.spectralink.net/amie-essentials/using-the-platform/versity-devices.md).

# Versity Devices

The Devices page has two options: the *Device Holding Area* and the *Device List*.

## The Holding Area

![](https://3032864282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxfLF6IpyutR429bMnvvf%2Fuploads%2Fgit-blob-3f2934e37474c39a6afac7e4efa37b059a20572c%2Fimage59.png?alt=media)

The Device Holding Area is the place where devices are approved for management, temporarily rejected, or deleted completely from the system. Initially this area displays Pending phones: phones that have presented themselves to SAM but have not yet been approved. Devices that have been manually configured through the SAM Client app or configured via EMM first appear here. Once a pending phone is approved, SAM sends the appropriate settings to the phone and locks the phone’s app settings so that users cannot alter them.

Once you have configured a phone to connect to SAM, it may take up to a minute to appear in the Pending area.

### Auto Approval of New Devices

The Preferences option in the banner includes an option for auto approval of devices. You may want to bypass the steps of approving individual devices and simply accept them all onto the Device List. When Auto Approval is selected, the devices will be listed on the Device List as soon as they heartbeat into SAM.

### Phone not appearing?

If a phone does not appear, check the SAM Client app on the phone to verify its settings:

1. Open SAM Client by clicking its icon.
2. From the overflow menu select Settings. The SAM URL should be using HTTPS (for example <https://172.29.76.20>).
3. The account key, a 22-character random string, should exactly match that found in the About SAM area.
4. The heartbeat switch should be enabled.
5. Also, the phone must have the SAM server’s certificate installed if using the self-signed certificate. If using a root or public CA-signed certificate, the phone should have the root or public CA certificate chain installed. The most popular public CA certificate chains are pre-installed. Verify with your EMM that it’s sending the proper certificate and settings. If no EMM is in use, a certificate can be manually installed over a USB cable: navigate to the phone menu Settings > Security > Encryption > Install From Storage and proceed from there.

### Approving Devices

You approve Pending phones to begin managing them with SAM. A SAM license is required for each phone. If you have used all available licenses and then attempt to approve an additional device, you will see a message to contact your service provider to purchase additional licenses.

Using the displayed MAC address, the administrator can identify the device using the Versity Implementation Plan (VIP) as described in the *Versity Deployment Guide*. Click the check box beside the target phone and select either Approve Device(s) or Reject Device(s) from the **Select actions** menu. Clicking the check box in the title bar allows you to select all phones in the Pending area, whether visible or not. If you reject a phone, it will not receive settings and will remain in the Rejected area indefinitely. If you approve a phone, it will move to the Approved tab and will also be visible in the Device List.

### Rejecting Devices

You can reject a phone from either the Pending or Approved tabs. Click the Approved tab to see the list of devices already approved. Click the check box beside the target phone and select Reject Device(s) from the **Select actions** menu to move the phone under the Rejected tab.

If you reject a Pending phone, it never receives any further configuration settings from SAM and does not use a license.

If you reject an Approved phone, the phone no longer receives updates but retains its last settings. Rejecting a previously approved phone returns its license to the license pool, allowing you to add another phone. The settings for a rejected phone remain in the database so that if you approve it again, it will get its previous settings along with any changes since it was rejected.

### Deleting Devices

You can delete a phone from the Rejected tab. Click the Rejected tab to see the list of devices previously rejected. Click the check box beside the target phone and select Delete Device(s) from the **Select actions** menu to remove all device level settings set on that specific phone from the database. SAM essentially forgets that the device ever existed.

If you do not reset the phone to factory settings as well, it will continue trying to contact SAM and will reappear in the Pending list after some period of time.

### Export all devices

Use the Export All device(s) option from the Select actions list to export all devices in the Holding area to a .csv file for further handling. You can also export all devices in the Device List or in the Rejected List.

![](https://3032864282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxfLF6IpyutR429bMnvvf%2Fuploads%2Fgit-blob-3847ad507198da2e74985bc27f71901efdf65acf%2Fimage60.png?alt=media)

Export Device procedure

1. From the Select Action dropdown menu, select Export All device(s).
2. At the bottom of the screen, the .csv download file appears. Save this file to your computer.
3. Open the .csv file in Excel. It will contain the relevant information about each device as it was entered or configured earlier.

### Exported fields

* MAC address
* Device serial
* Last heartbeat
* Groups
* SIP extension
* Device Info 1
* Device Info 2
* Device Info 3
* Device Info 4
* Status (approved, pending, rejected)
* Device name (used by Web API)
* Software version (Spectralink Firmware Version)
* AP SSID (last AP connected)

## Approving Devices

Using the displayed MAC address, the administrator can identify the device using the Versity Implementation Plan (VIP) as described in the *Versity Deployment Guide*. The **Select actions** menu allows the administrator to approve or reject devices in this list.

## Device List

The Device List is a list of all devices that have been Approved in SAM. Once devices appear in the device list, they are managed by SAM.

![](https://3032864282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxfLF6IpyutR429bMnvvf%2Fuploads%2Fgit-blob-1d926e9e369e39dcb015a8d2eb17681972fdb88b%2Fimage61.png?alt=media)

The columns (Device MAC Address, Device Serial, Last Heartbeat, Device Name, Device Info 1-4, SIP Extension) can be moved by clicking and dragging them. Columns can be hidden or displayed by clicking **Change Columns**. Enabling various headings causes them to appear at the end of the existing columns. Disable columns to suppress them in the Device List.

![](https://3032864282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxfLF6IpyutR429bMnvvf%2Fuploads%2Fgit-blob-f455040f55059c61fbb44b154f24732f53ed8278%2Fimage62.png?alt=media)

To search for specific devices from the Device List, choose the focus of your search from the dropdown menu to the right of *Search*, enter your search query in the field, and click **Search**.

{% hint style="info" %}
**Direct navigation to a device’s analytics page in AMIE Advanced**

*This feature is only available for users with an* AMIE Advanced *license:* Click on an individual phone’s serial number in the *Device Serial* column to open a new tab showing that phone’s *AMIE Advanced* analytics page. (See NOTE below.)
{% endhint %}

{% hint style="info" %}
**NEW: AMIE Advanced Analytics link**

SAM 1.15 adds links in the *AMIE Essentials* interface that take administrators directly to related insights in [AMIE Advanced](https://www.spectralink.com/amie-advanced-for-wi-fi/), Spectralink’s cloud analytics platform. *AMIE Advanced* is a separate product from *AMIE Essentials*. It runs in a web browser and shows how your device fleet is performing, with detailed views of battery, device, call, and network performance.

To use these links, an administrator must:

Have an *AMIE Advanced* account.

Be signed in to *AMIE Advanced* in their web browser.

Have an active *AMIE Advanced* license on that account. Licenses that have expired or haven’t started yet won’t work.

This integration with the *Device List* will be available in mid-Q4 2026.
{% endhint %}

{% hint style="info" %}
**The values shown in Device Info 1-4 are actual device values**

If you have configured *Device Info 1-4* values in the Device Settings app but haven’t sent them to the phone yet, then the *Device Info 1-4* values shown in the Device List reflect the phone’s current settings, and might differ from your configurations in the Device Settings app.

Until the phone heartbeats in, gets the new settings, and responds back to the SAM server with these updated values, there might be some discrepancy between what’s shown in the *Device Info 1-4* columns here and the settings in the Device Settings app. (SAM-1227)
{% endhint %}

![](https://3032864282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxfLF6IpyutR429bMnvvf%2Fuploads%2Fgit-blob-734c2af3f4d553c95a53f64a7aeb4bafd4879ee3%2Fimage63.jpg?alt=media)

**Device List actions**

Management actions are provided for remote management of individual devices. Select the device(s) you wish to manage and then click the *Select actions* dropdown menu. Select the desired action:

* *Change Config*\
  Typically used when a single phone needs unique configuration parameters. This action will open the Applications page in the device context, meaning that only the selected phone will receive changes.
* *Re-apply Config*\
  Causes SAM to resend its entire configuration on the next heartbeat. Used when a phone has been reset to factory settings and reconnected to SAM. Also needed when a phone has been out for repair.
* *Trigger Heartbeat*\
  Immediately forces the Versity smartphone to heartbeat into SAM. Usually used when a configuration parameter has changed or a software update is needed and the administrator wants to deploy them without delay.

  Use this option sparingly when doing a software update (1GB+) as it could negatively affect Wi-Fi network performance for large phone deployments with few access points.
* *Export All Devices*\
  Exports all approved devices to a .csv file with a subset of configuration parameters for identification purposes.

{% hint style="info" %}
**Heartbeat Interval**

Versity smartphones check into SAM using a “heartbeat.” The minimum heartbeat interval is 15 minutes, and maximum is 24 hours. The interval is set in the SAM Client app when first connecting the phone to SAM. At the heartbeat, the phone asks SAM for any configuration changes and SAM returns them. The changes take effect immediately.

An administrator can select any single device or many devices from the Device List and force a heartbeat if necessary. See Device List actions below.

A smartphone will heartbeat at longer intervals while it is inactive. An immediate heartbeat can also be forced using the smartphone SAM Client app.
{% endhint %}

## Re-Deploying Devices

SAM is designed to be the primary configuration method for all Spectralink applications. If the Erase all data (factory reset) option has been selected from the Android Settings app on the smartphone, Spectralink recommends re-provisioning the smartphone using the steps below.

{% hint style="info" %}
**Reconfiguring smartphones**

This re-deploying technique is an efficient way to remove all Device level settings from a smartphone and reset it to the Enterprise settings.

(NOTE: The phone will reboot twice after a factory reset. This is a normal part of the reset process.)
{% endhint %}

**To factory reset and then re-configure a device:**

1. Go to the Approved tab in the Device Holding Area, click the smartphone, and select **Reject Device(s)** from the action menu to move it to the Rejected list.
2. Click the Rejected tab. Select **Delete Device(s)** from the action menu to remove device level settings for the device.
3. On the phone, open the Settings app. Navigate to **System** > **Reset Options**. Click **Erase all data** and follow the prompts.
4. Set up the phone by either using the NFC bump from an EMM master device or configuring it manually as device owner. You may need to delete it from the EMM for this step. After it enrolls, the smartphone will associate with SAM and show up in the Pending list.
5. Approve the smartphone in SAM. After it is re-approved, it will receive the Enterprise settings. It now shows up in the Device list and can be configured.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.spectralink.net/amie-essentials/using-the-platform/versity-devices.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.