--- availability: INSTALLABLE name: View Presence description: Lets employees ask which days they are due in the office and who else is expected, using presence data in the ServiceNow WSD module, and get an answer that accounts for both routines and one-off exceptions, via the Moveworks AI Assistant. installation_asset_uuid: 63f034cd-ad82-4a61-948b-c8603bbf7767 purple_chat_link: https://marketplace.moveworks.com/purple-chat?conversation=%7B%22messages%22%3A%5B%7B%22role%22%3A%22user%22%2C%22parts%22%3A%5B%7B%22richText%22%3A%22I+want+to+see+who+will+be+in+the+office+next+week+so+I+can+plan+my+commute.%22%7D%5D%7D%2C%7B%22role%22%3A%22assistant%22%2C%22parts%22%3A%5B%7B%22reasoningSteps%22%3A%5B%7B%22status%22%3A%22success%22%2C%22richText%22%3A%22Identifying+your+primary+collaborators+and+team+members+in+%3Cb%3EServiceNow%3C%2Fb%3E...%22%2C%22connectorName%22%3A%22servicenow%22%7D%2C%7B%22status%22%3A%22success%22%2C%22richText%22%3A%22Retrieving+office+presence+logs+and+hybrid+schedules...%22%2C%22connectorName%22%3A%22servicenow%22%7D%5D%7D%2C%7B%22richText%22%3A%22%3Cp%3EHere+is+the+expected+office+presence+for+your+team+next+week%3A%3C%2Fp%3E%3Cul%3E%3Cli%3E%3Cb%3EMonday%2C+Oct+21%3C%2Fb%3E%3A+Sarah+Jenkins%2C+Mike+Ross%3C%2Fli%3E%3Cli%3E%3Cb%3ETuesday%2C+Oct+22%3C%2Fb%3E%3A+Sarah+Jenkins%2C+Anita+Desai%2C+Harvey+Specter+%28%3Ci%3ELondon+Office%3C%2Fi%3E%29%3C%2Fli%3E%3Cli%3E%3Cb%3EWednesday%2C+Oct+23%3C%2Fb%3E%3A+Sarah+Jenkins%2C+Mike+Ross%2C+Anita+Desai%2C+Harvey+Specter+%28%3Ci%3ELondon+Office%3C%2Fi%3E%29%3C%2Fli%3E%3Cli%3E%3Cb%3EThursday%2C+Oct+24%3C%2Fb%3E%3A+Anita+Desai%2C+Mike+Ross%3C%2Fli%3E%3Cli%3E%3Cb%3EFriday%2C+Oct+25%3C%2Fb%3E%3A+No+collaborators+scheduled%3C%2Fli%3E%3C%2Ful%3E%3Cp%3E%3Cb%3ESummary%3A%3C%2Fb%3E+Most+of+your+team+will+be+in+mid-week.+%3Cb%3EWednesday%3C%2Fb%3E+is+the+best+day+to+visit+for+maximum+overlap.%3C%2Fp%3E%3Cp%3E%3Ca+href%3D%5C%22https%3A%2F%2Fservicenow.com%2Fpresence%2Fteam-dashboard%5C%22%3EManage+your+office+schedule%3C%2Fa%3E%3C%2Fp%3E%22%7D%2C%7B%22citations%22%3A%5B%7B%22connectorName%22%3A%22servicenow%22%2C%22citationTitle%22%3A%22Team+Presence+Schedule+-+Oct+21-25%22%7D%5D%7D%5D%7D%5D%7D solution_tags: - Workplace - Workplace Service Delivery - Workplace Experience - Facilities - Workspace - Collaboration systems: - servicenow --- # Description Knowing who's in and when shouldn't take a spreadsheet. An employee can ask the Moveworks AI Assistant questions about their planned office visits — such as which days they're due in, or who else is expected to be there — and get an answer straight away. Insights account for both the standing routine and any one-off exceptions, so the picture reflects where people will actually be, not just the default pattern. # User Experience Preview Refer to the [**Purple chat**](https://marketplace.moveworks.com/purple-chat?conversation=%7B%22messages%22%3A%5B%7B%22role%22%3A%22user%22%2C%22parts%22%3A%5B%7B%22richText%22%3A%22I+want+to+see+who+will+be+in+the+office+next+week+so+I+can+plan+my+commute.%22%7D%5D%7D%2C%7B%22role%22%3A%22assistant%22%2C%22parts%22%3A%5B%7B%22reasoningSteps%22%3A%5B%7B%22status%22%3A%22success%22%2C%22richText%22%3A%22Identifying+your+primary+collaborators+and+team+members+in+%3Cb%3EServiceNow%3C%2Fb%3E...%22%2C%22connectorName%22%3A%22servicenow%22%7D%2C%7B%22status%22%3A%22success%22%2C%22richText%22%3A%22Retrieving+office+presence+logs+and+hybrid+schedules...%22%2C%22connectorName%22%3A%22servicenow%22%7D%5D%7D%2C%7B%22richText%22%3A%22%3Cp%3EHere+is+the+expected+office+presence+for+your+team+next+week%3A%3C%2Fp%3E%3Cul%3E%3Cli%3E%3Cb%3EMonday%2C+Oct+21%3C%2Fb%3E%3A+Sarah+Jenkins%2C+Mike+Ross%3C%2Fli%3E%3Cli%3E%3Cb%3ETuesday%2C+Oct+22%3C%2Fb%3E%3A+Sarah+Jenkins%2C+Anita+Desai%2C+Harvey+Specter+%28%3Ci%3ELondon+Office%3C%2Fi%3E%29%3C%2Fli%3E%3Cli%3E%3Cb%3EWednesday%2C+Oct+23%3C%2Fb%3E%3A+Sarah+Jenkins%2C+Mike+Ross%2C+Anita+Desai%2C+Harvey+Specter+%28%3Ci%3ELondon+Office%3C%2Fi%3E%29%3C%2Fli%3E%3Cli%3E%3Cb%3EThursday%2C+Oct+24%3C%2Fb%3E%3A+Anita+Desai%2C+Mike+Ross%3C%2Fli%3E%3Cli%3E%3Cb%3EFriday%2C+Oct+25%3C%2Fb%3E%3A+No+collaborators+scheduled%3C%2Fli%3E%3C%2Ful%3E%3Cp%3E%3Cb%3ESummary%3A%3C%2Fb%3E+Most+of+your+team+will+be+in+mid-week.+%3Cb%3EWednesday%3C%2Fb%3E+is+the+best+day+to+visit+for+maximum+overlap.%3C%2Fp%3E%3Cp%3E%3Ca+href%3D%5C%22https%3A%2F%2Fservicenow.com%2Fpresence%2Fteam-dashboard%5C%22%3EManage+your+office+schedule%3C%2Fa%3E%3C%2Fp%3E%22%7D%2C%7B%22citations%22%3A%5B%7B%22connectorName%22%3A%22servicenow%22%2C%22citationTitle%22%3A%22Team+Presence+Schedule+-+Oct+21-25%22%7D%5D%7D%5D%7D%5D%7D) for a sample conversational experience between a user and the AI Assistant for this plugin. # Pre-requisites Before installing and using the **View Presence** plugin, ensure that the following requirements are met: ## **1. ServiceNow's Workplace Concierge** This plugin requires an active **Workplace Concierge** installation and configuration on your ServiceNow instance. - If you have not installed and configure the application, follow the **[Install Workplace Concierge](https://www.servicenow.com/docs/r/employee-service-management/workplace-concierge/install-workplace-concierge.html)** documentation - The minimum version of the Workplace Concierge application is: 1.7.11 - After the app is configured, follow the **[plugin installation documentation](https://help.moveworks.com/docs/ai-agent-marketplace-installation)** for detailed steps on how to install and activate the plugin in **Agent Studio**. ## **2. User Identity Ingestion from ServiceNow** This plugin operates on presence records under the requesting user's own ServiceNow identity. The `requested_for` fields are populated by dot-walking the user's profile in the Data Bank: `meta_info.user.external_system_identities.snow.external_id` The `external_id` serves two purposes: 1. **Authentication & role verification** — the `external_id` is used to verify that the user has the required `sn_wsd_core.workplace_user` role in ServiceNow. Without this, API calls will fail regardless of authentication status. 2. **Presence operations** — all presence operations are scoped to the authenticated user's identity in ServiceNow. This reads the user's ServiceNow `sys_id` from the identity source linked to their Moveworks profile, so your users must be ingested from ServiceNow for this value to populate. To set up user identity for your org, read our help docs on Identity Configuration in [**Moveworks Setup**](https://help.moveworks.com/service-management/moveworks-setup/identity-configuration). >⚠️ **Important — update this mapping to match your setup**. The `snow` key in that path must exactly match the name of `your` ServiceNow identity source in Moveworks Setup. If yours is named differently (e.g. `servicenow_prod`), update the Compound Action mapping to `meta_info.user.external_system_identities.servicenow_prod.external_id`. If it doesn't match, the path resolves to null and both authentication and presence operations will fail. ## **3. ServiceNow Connector** This plugin requires an active **ServiceNow connector** configured with **OAuth 2.0 using the Authorization Code grant (user-based / User Consent auth)**. - If you have not already configured the connector, follow the [**OAuth 2.0 Authorization Code guide**](https://docs.moveworks.com/agent-studio/connectors/http-connectors/oauth-20-authorization-code). The connector must be fully set up before installing this plugin. # Implementation details **Note:** References to the instance must be updated after the plugin is installed. ## Visual representation of how the plugin works ![Conversation flow](View%20Presence/flow.png) # **Implementation Details** ## API Details Before running the cURL examples, replace `YOUR_INSTANCE` with your instance hostname and `ACCESS_TOKEN` with the OAuth access token issued for the user. ### **API: Get Presence Data** This REST API retrieves the Presence Routine and any exceptions created for the requested time period. Information of the routine, exceptions, and collaborator information is returned. ```bash curl --location 'https:///api/sn_wsd_concierge/presence?include=collaborators' \ --header 'Authorization: Bearer ' \ --header 'Accept: application/json' ``` **Note** - The `include=collaborators` parameter is hardcoded into the actions path, and ensures information about the routines for the collaborators is included. ### API References This plugin uses **Workplace Concierge** and **Workplace Core REST APIs** to retrieve information. For detailed information on request parameters, response formats, error handling, and versioning, please refer to the **[official ServiceNow documentation](https://developer.servicenow.com/dev.do#!/reference/)**. # **What Is In Scope for This Plugin?** - Viewing the employee's weekly routine (which days they're normally in the office). - Viewing the employee's day-specific exceptions to said routine, from today through three months out. - Viewing the presence routine (routine and exceptions) of the employee's collaborators, complying with the collaborator's privacy settings. # **What Is Out of Scope for This Plugin?** - Viewing the routine with a date range outside **today through three months from today** for exceptions. - Setting presence status or updating the weekly routine requires the `Set Presence Status` and `Update Presence routine` plugins. - Adding or removing collaborators requires the `Manage Presence Collaborators` plugin.