Moveworks Implementation Starter Guide

The Moveworks Implementation Starter Guide provides a structured roadmap for configuring your Moveworks instance. It is designed to help implementation teams, Moveworks Administrators, and project stakeholders understand each stage of the process—from configuring access, and connectors through different capabilities such as ticketing, and provision management plugins.

This start guide links out to other detailed Overview and "How-To" Configuration Guides, which should be reviewed to develop a deeper understanding of the different features and capabilities of the Moveworks platform.

Section 1: Access, Administration & Identity

Learn how to access and administer MyMoveworks, configure SSO, manage users, and set roles/permissions.
Read More

Total Reading Time: 25 min

Modules to Configure

ModuleOverview LinkHow-To/Configuration GuideEst. Reading Time (min)
1.1: 1-Click Email Login-Guide4
1.2: Configure SSO-Guide5
1.2.1: Update Org Info-Guide3
1.2.2: Configure Roles & PermissionsOverviewGuide3
1.3: Configure User IdentityOverviewGuide5

Concepts to Learn

  • Review the Overview and How-To Guides in the table above to learn how to import and assign appropriate permissions to users in the MyMoveworks administrative application.

Section 2: Platform & Built-In Plugin Configuration

Configure system connectors, chatbot surfaces, management of built-in plugins, multilingual support, and Smart Handoff. Read More

Total Est. Reading Time: 32 min

Modules to Configure

Module

Overview Link

How-To/Config Guide

Est. Reading Time (min)

2.1: Add System Connectors

Overview

Guide

4

2.2: Configure Chatbot Surfaces

Overview

Slack

Microsoft Teams

4

2.2.1: Configure Embedded AI Assistant (Web)

Overview

SSO Setup: ADFS Azure OIDC Okta OIDC Okta SAML

Installation: ServiceNow Sharepoint Online Google Sites Unily

4

2.3: Configure Employee Communications

Overview

Guide

4

2.4: Turn on Plugins via Plugin Controls


Guide

3

2.5: Configure Smart Handoff

Overview

Guide

4

2.6: Configure Multilingual Support (MLS)

Overview

Guide

4

2.7: Configure People Lookups

Overview

Guide

5

Concepts to Learn

  • Review Moveworks Data Objects Overview to understand the different objects in the Moveworks platform.
  • Review Moveworks DSL languages overview to understand the Moveworks DSL language, what it is used for, and its syntax.
ModuleOverview LinkHow-To/Config GuideEst. Reading Time (min)
Configuration Languages (DSL)OverviewGuide2
Moveworks Data ObjectsOverview-3

Section 3: Content Configuration

Configure ingestion of various content sources (internal, external, and file sources). Read More

Modules to Configure

Total Est. Reading Time: 33 min

ModuleOverview LinkHow-To/Config GuideEst. Reading Time (min)
Ingestion PlatformOverview-6
RetrievalOverview-5
3.1: Internal Answers-Guide6
3.2: Configure FAQ-Guide5
3.3: External KnowledgeGuideGuide5
3.4: File SearchGuideGuide6

Concepts to Learn

  • Review Moveworks Content Ingestion Platform Overview to understand how Moveworks ingests content.
  • Review Permissions Platform Overview to understand the different ways Moveworks supports permissions.
ModuleOverview LinkHow-To/Config GuideEst. Reading Time (min)
Content Ingestion PlatformOverview-6
Permissions PlatformOverview-5

Section 4: Service Management

Configure ticketing, forms, approvals plugins alongside access permissions for ITSM workflows. Read More

Total Est. Reading Time: 21 min

ModuleOverview LinkHow-To/Config GuideEst. Reading Time (min)
4.1: TicketingOverviewGuide5
4.2: Forms PluginOverviewGuide5
4.3: ApprovalsOverviewGuide6
4.4: Permissions (ServiceNow Knowledge & Catalog Item User Criteria)OverviewGuide5

Section 5: Provision Management

Manage group, software provisioning and access account plugins. Read More

Total Est. Reading Time: 14 min

ModuleOverview LinkHow-To/Config GuideEst. Reading Time (min)
5.1: Access SoftwareOverviewGuide4
5.2: Access GroupsOverviewGuide5
5.3: Access AccountsOverviewGuide5

General FAQs

Moveworks Setup FAQs

Non- US Commercial Implementation Nuances

  1. Chat Interfaces:
    1. Microsoft Teams: You cannot use the App Store installation method for Teams Bots outside of the US, as the messaging endpoint refers to the US Commercial. Instead you will need to follow the instructions here to set up an Azure Bot in the organization's Microsoft tenant.
    2. Slack: You will need to ensure your messaging endpoint is pointing to the correct tenant.
    3. Web chat: You will need to ensure the URL you are iframing points to the correct tenant. For example EU would be: https://webchat.prod.am-euc1.moveworks.io/movewebchat-client-script.js
  2. Moveworks Agent: The auth and config urls in the agent_config.mwyml should refer to your region specific URLs.
  3. My Moveworks SSO Login: The Login URL for My Moveworks is unique per region. See the docs here for more details .