This document walks through the installation steps for Sharepoint Online using OIDC. Before starting this guide, please review the Embedded AI Assistant SSO guides in the navigation menu to the left to find the setup guide for your SSO system and complete the steps to create an SSO application for authenticating the Embedded AI Assistant

Installing it on SharePoint Online (Cloud) using OIDC

Who can install this?

A SharePoint admin with the global administrator role.

(1) Upload the Embedded AI Assistant Application to your SharePoint Tenant

1. Download the Moveworks-for-Web Sharepoint package from here
2. Unzip the package to reveal the sppkg web-part file.
3. Navigate to this page: https://{{tenant}}.sharepoint.com/sites/appcatalog/AppCatalog/Forms/AllItems.aspx
4. Click upload, and upload the web-part file.

5. Check the box to deploy it to all sites in the organization.
6. Select Enable App
7. You should see the success message below, and under Apps for Sharepoint, the App should surface as Enabled. After it’s enabled, the web-part will be available in your web-part toolbox to add to any site.

(2) Configure SSO Configuration

1. Select ‘Edit Web Part’

2. Configure the following settings right(px), bottom (px), and zIndex - These settings determine where on the Site UI the Moveworks AI Assistant shows up.
3. Next configure the bot id — This will get generated in Moveworks Setup under Chatbots -> Manage Chatbots
4. Lastly, configure the server url overridebased on your Moveworks environment.

• For US commercial customers: https://webchat-kprod.moveworks.io (this is used by default)
• For EU customers: https://webchat.prod.am-euc1.moveworks.io
• For CA customers: https://webchat.prod.am-cac1.moveworks.io
• For AU customers: https://webchat.prod.am-apse2.moveworks.io
• For GovCloud customers: https://webchat.moveworksgov.com/
  • Note: Please confirm what the IDP redirect URL is within the SSO module of MW Setup for your SSO app. If your redirect domain is of the form https://<org_name>-chat.moveworksgov.com, then your server url override should be https://<org_name>-chat.moveworksgov.com as well.

5. Make sure to save and then Publish the page.

(3) Add the Web Part to a Page

If your user account is allowlisted to use Web Bot, then you will see it right away, if not, work with Moveworks to do so.

If you are still not seeing the AI Assistant appear, ensure the SSO application is assigned to the user.

Sharepoint Modern Site

It will look like this (a thin rectangle) if you successfully added it and are not allow listed (you can use the trash can to remove it, if desired):

Sharepoint Classic Site

Find the Embedded AI Assistant part located in the Other category, and insert it on the page.

After the web part is added to the page. Edit the web part configuration. Change Chrome Type to None.