This document walks through the installation steps for Sharepoint Online using OIDC. Before starting this guide, please complete the steps outlined here to set up Azure OIDC authentication: https://help.moveworks.com/docs/moveworks-for-web-installation-azure-oidc

Installing it on SharePoint Online (Cloud) using OIDC

Who can install this?

A SharePoint admin with the global administrator role.

(1) Upload the Moveworks for Web 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 bot 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-eu-central.moveworks.io
• For CA customers: https://webchat.prod.am-ca-central.moveworks.io
• For AU customers: https://webchat.prod.am-au-southeast.moveworks.io
• For GovCloud customers: https://webchat.moveworksgov.com

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 bot 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 Moveworks for Web web 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.