> For the complete documentation index, see [llms.txt](https://docs.thousandeyes.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.thousandeyes.com/product-documentation/global-vantage-points/endpoint-agents/installing/cisco-devices/install-phoneos.md). # Endpoint Agent Installation on Cisco Phone Devices (PhoneOS) The Endpoint Agent on Cisco PhoneOS devices combines device data with Endpoint Agent telemetry. This data helps you identify whether call-quality problems originate on the phone, local network, network path, or broader network. This article explains how to activate the Endpoint Agent on supported Cisco phone devices. ## Prerequisites * You have a ThousandEyes account with the required admin permissions. * You have an Essentials or Advantage license. * You have one of the following supported devices, registered with Webex Calling multi-tenant (WxC MT), Webex Calling Dedicated Instance (WxC DI), or Cisco Unified Communications Manager (Unified CM): * [Cisco Video Phone 8875](https://www.cisco.com/c/en/us/products/collateral/collaboration-endpoints/unified-ip-phone-8800-series/video-phone-8875-ds.html) running PhoneOS 5.0.1 or later. * [Cisco Desk Phone 9861 or 9871](https://www.cisco.com/c/en/us/support/collaboration-endpoints/desk-phone-9800-series/series.html) running PhoneOS 3.2.1 or later. ## Getting Started ### Establishing the ThousandEyes and Webex Control Hub Connection 1. Create a token in ThousandEyes by going to the **User API Tokens** section in **Account Settings > Users and Roles > Profile**. ![](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-ffbaa85380abcec3bb54252a8e59cc9e4ad40f34%2Fproduct-documentation_global-vantage-points_endpoint-agents_installing_phoneos-1.png?alt=media) ![](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-85ed937f00647a5f465b64eea5ccac8778c4c2e9%2Fproduct-documentation_global-vantage-points_endpoint-agents_installing_phoneos-2.png?alt=media) 2. Follow [Integrate ThousandEyes with Troubleshooting in Control Hub](https://help.webex.com/en-us/article/nymfj2d/Integrate-ThousandEyes-with-Troubleshooting-in-Control-Hub#task-template_bdd45fbb-9087-45e4-87f1-ec396d886b57) to activate the integration. ### Configuring the Phone Device to Enable ThousandEyes The following instructions explain how to enable ThousandEyes on **Cisco Unified Communications Manager (Unified CM)** and **Webex Calling Dedicated Instance (WxC DI)**: #### Prerequisites 1. You have access to Unified CM. 2. For phones registered with an on-premises Unified CM deployment, log in to the Cisco Unified CM Administration screen at `https:///ccmadmin`. Use the **Navigation** dropdown to switch between applications, such as Cisco Unified Serviceability, Cisco Unified OS Administration, Disaster Recovery System, and Cisco Unified Reporting. Type your username and password. ![](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-5b1a90c611d12626a9b4f6655a64cab7c3cb1bad%2Fproduct-documentation_global-vantage-points_endpoint-agents_installing_phoneos-10.png?alt=media) 3. For phones registered with Webex Calling Dedicated Instance, open Unified CM from **Webex Control Hub > Calling > Dedicated Instance**. Select the UC application, and then select **Manage**. ![](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-ac8e951a3b56827de2743adf23c3d32c651f67b3%2Fproduct-documentation_global-vantage-points_endpoint-agents_installing_phoneos-11.png?alt=media) ![](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-290db0fff93ed015ee83c870e538876877d2c0fe%2Fproduct-documentation_global-vantage-points_endpoint-agents_installing_phoneos-12.png?alt=media) 4. Register your Cisco Phone (9800 series) by following the [standard instructions](https://help.webex.com/en-us/article/xbxgb3/Register-Cisco-Desk-Phone-9800-Series#task-template_ea413976-eedc-4bff-b8fb-fec3d3740f32). #### Activating ThousandEyes on Cisco 9800 Phone Series 1. Locate your registered phone by **Directory Number** or **Device Name** ![](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-9643a9a3cacbf36ef2a2d4f230cab645111534cd%2Fproduct-documentation_global-vantage-points_endpoint-agents_installing_phoneos-13.png?alt=media) ![](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-e49dc1357e8946d760e40c1ec828419712aa233d%2Fproduct-documentation_global-vantage-points_endpoint-agents_installing_phoneos-14.png?alt=media) 2. Now click the **Device Name** to open the **Phone Configuration** view. ![](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-e9ae2265522717013a24934be0f3b2232d98043e%2Fproduct-documentation_global-vantage-points_endpoint-agents_installing_phoneos-15.png?alt=media) 3. At the bottom of the **Phone Configuration** view, configure the following fields: * **ThousandEyes Enable**: Select **True**, and then select the adjoining checkbox. * **Connection String**: Type the connection string for your account group, and then select the adjoining checkbox. ![](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-bd37e3cce1a391ed8cd3838906677ced9f1c0784%2Fproduct-documentation_global-vantage-points_endpoint-agents_installing_phoneos-16.png?alt=media) 4. Select **Save**, and then select **Apply Config** from the top menu of the **Phone Configuration** view. The Endpoint Agent registers with the ThousandEyes platform in about five minutes. ![](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-c99e1199ed993456cbce3d768f191b4b2e4d0a00%2Fproduct-documentation_global-vantage-points_endpoint-agents_installing_phoneos-17.png?alt=media) ![](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-29b5edf8fd0135fd1a935da272eca83b6c1ceb99%2Fproduct-documentation_global-vantage-points_endpoint-agents_installing_phoneos-18.png?alt=media) ## Creating Tests in ThousandEyes 1. Copy the meeting site ID from Webex Control Hub. When you create tests, use this value as the **Webex Site ID**. ![](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-83e5ed9c8c21670b66d1625b1aa4857ba561ad0f%2Fproduct-documentation_global-vantage-points_endpoint-agents_installing_phoneos-3.png?alt=media) 2. In the ThousandEyes platform, go to the **Endpoint Agent > Test Settings** screen. ![](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-432a41d12f88a32901395dfa7684087bc2ec6a98%2Fproduct-documentation_global-vantage-points_endpoint-agents_installing_phoneos-4.png?alt=media) 3. Create a synthetic test by using the **Webex** template. For instructions, see [Deploy an Existing Test Template](https://docs.thousandeyes.com/product-documentation/end-user-monitoring/test-settings/synthetic-tests#deploying-an-existing-test-template). ### Running Tests and Analyzing the Results After the agents are active and the devices have participated in a few meetings, go to the Control Hub troubleshooting screen. On the **Troubleshooting** screen: 1. Search for the device on the **Meetings & Calls** tab. ![](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-0266186ecdc6722666e92df3c18b8a1cdf7d0917%2Fproduct-documentation_global-vantage-points_endpoint-agents_installing_phoneos-5.png?alt=media) 2. Search for the calls that you want to monitor. ![](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-1ddbc7c484fee00fe956ffb2bf238c1e933f0693%2Fproduct-documentation_global-vantage-points_endpoint-agents_installing_phoneos-6.png?alt=media) 3. View the Network Path for the selected call. ![](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-7c6268d9571d0098434e0320ac40122e6f31aa0b%2Fproduct-documentation_global-vantage-points_endpoint-agents_installing_phoneos-7.png?alt=media) 4. Hover over the dots in Network Path to view ThousandEyes network data. ![](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-ab7f75bff2bf61f8249179d2bb32271247a9366d%2Fproduct-documentation_global-vantage-points_endpoint-agents_installing_phoneos-8.png?alt=media) 5. Click the ThousandEyes icon to cross-launch into ThousandEyes and view more in-depth network data. ![](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-6a4a8d09bafc303d5a2a9a95547eac2fa3aa7f51%2Fproduct-documentation_global-vantage-points_endpoint-agents_installing_phoneos-9.png?alt=media) ### Limitations * Cisco Desk Phone 9811, 9851, and 9841 models are not supported. * Detailed Wi-Fi metrics are not available. * ICE-optimized calls, proxy configurations, VPNs, WebRTC, BroadWorks, and third-party call control are not supported. * Phones deployed with WxC MT do not support third-party meetings such as Microsoft Teams and Zoom. ### Next Steps After completing this integration, the following links will help you in getting the most out of the ThousandEyes Endpoint Agents: * [Viewing data for tests run by the Endpoint Agents](https://docs.thousandeyes.com/product-documentation/end-user-monitoring/viewing-data) * [Manage Endpoint Agent Settings](https://docs.thousandeyes.com/product-documentation/global-vantage-points/endpoint-agents/managing/manage-endpoint-agent-settings) * [Data collected by an Endpoint Agent](https://docs.thousandeyes.com/product-documentation/global-vantage-points/endpoint-agents/data-collected-by-endpoint-agent)