> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.moveworks.com/ai-assistant/ai-assistant-web-surfaces/moveworks-for-web/embedded-ai-assistant-installation-guide/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.moveworks.com/_mcp/server.

# Embedded AI Assistant Installation Guide

Please review our [Embedded AI Assistant Overview](/ai-assistant/ai-assistant-web-surfaces/moveworks-for-web) page for more details on behavior and requirements.

# Create a Chat Application in Moveworks Setup

1. Within Moveworks Setup, navigate to **Manage Chatbots** and click **Create** to generate a new chat application configuration for the Embedded AI assistant.
2. Configure the following fields:
   1. Channel: movewebchat
   2. Select Connector: movewebchat
   3. Bot ID: enter **1234** this ID value will be replaced with a generated ID upon save
   4. Bot Name (Moveworks Identifier): use your Moveworks organization name "-webchat"
      1. Example: acme-webchat
   5. Bot Friendly Name: User facing name of the Assistant
   6. Channel Configurations: Set to **Movewebchat Vars**
3. Leave the remaining fields blank and click **Submit**
4. Set the Config Title to the **Bot Name** from step iv (example "acme-webchat")
5. Once saved, click edit on the chat application you just created to retrieve the generated **Bot ID**. Note the ID down as it will be used later in the embed script.

# Customize the Embedded AI Assistant

1. Within Moveworks Setup, navigate to **Web Chatbot > Design Settings**
2. Customize Theme settings and add a publicly accessible avatar image URL. If your organization does not have an image hosting service, please contact Moveworks Support to utilize Moveworks image services.

# Create an SSO Application to authenticate the Embedded AI Assistant

> **Note**
>
> When embedding the Assistant on ServiceNow, we recommend using the **Moveworks for Employee Center plugin**, which utilizes the built-in authentication for ServiceNow. Skip this section and go straight to the instructions to embed the AI Assistant on [ServiceNow](/ai-assistant/ai-assistant-web-surfaces/moveworks-for-web/moveworks-for-web-installation-servicenow).

Follow one of our available guides to create an SSO application to authenticate the Embedded AI Assistant

[Azure OIDC SSO Setup Guide](/ai-assistant/ai-assistant-web-surfaces/moveworks-for-web/moveworks-for-web-installation-azure-oidc)

[Okta OIDC SSO Setup Guide](/ai-assistant/ai-assistant-web-surfaces/moveworks-for-web/moveworks-for-web-installation-okta-oidc)

[Okta SAML SSO Setup Guide](/ai-assistant/ai-assistant-web-surfaces/moveworks-for-web/moveworks-for-web-installation-okta-saml-sso)

[Onelogin OIDC SSO Setup Guide](/ai-assistant/ai-assistant-web-surfaces/moveworks-for-web/onelogin-setup-oidc)

[General SAML SSO Setup Guide](/ai-assistant/ai-assistant-web-surfaces/moveworks-for-web/moveworks-for-web-general-saml-code-snippet-adfs-configuration)

# Embed the AI Assistant on a webpage

Follow the system specific embed guides for the following systems to embed the AI Assistant as there are additional steps required to add the script to the page:

* [ServiceNow](/ai-assistant/ai-assistant-web-surfaces/moveworks-for-web/moveworks-for-web-installation-servicenow)
* [Google Site](/ai-assistant/ai-assistant-web-surfaces/moveworks-for-web/moveworks-for-web-google-sites)
* [Sharepoint Online](/ai-assistant/ai-assistant-web-surfaces/moveworks-for-web/moveworks-for-web-installation-sharepoint-online)
* [Unily](/ai-assistant/ai-assistant-web-surfaces/moveworks-for-web/moveworks-for-web-installation-unily)

For a standard webpage that allows for embedding HTML & Javascript use, use the script below to embed the AI Assistant on your page.

If your installation does not require any style overrides then use the following script, replacing the `<bot_id>` text  with the ID noted down from step 5 of **Create a Chat Application in Moveworks Setup** above.

**`Commercial`**

```Text Commercial
<script src="https://webchat-kprod.moveworks.io/script/<bot_id>" />
```

**`Gov`**

```Text Gov
The shortened script is not available for Gov region. Use the script below.
```

**`EU`**

```Text EU
<script src="https://webchat.prod.am-euc1.moveworks.io/script/<bot_id>" />
```

**`Canada`**

```Text Canada
<script src="https://webchat.prod.am-cac1.moveworks.io/script/<bot_id>" />
```

**`Australia`**

```Text Australia
<script src="https://webchat.prod.am-apse2.moveworks.io/script/<bot_id>" />
```

**`Japan`**

```Text Japan
<script src="https://webchat.jp.moveworks.com/script/<bot_id>" />
```

**`UK`**

```Text UK
<script src="https://webchat.uk.moveworks.com/script/<bot_id>" />
```

**`US Prod 4`**

```Text US Prod 4
<script src="https://webchat.prod4.us.moveworks.com/script/<bot_id>" />
```

**`US Prod 3`**

```Text US Prod 3
<script src="https://webchat.prod3.us.moveworks.com/script/<bot_id>" />
```

Use the following script to include style overrides:

**`Commercial`**

```Text Commercial
<div id="webchat">
    <script>
        var script = document.createElement('script');
        script.type = "text/javascript";
        script.onload = function () {
            window.mwwebchat.openMWWebChat(
                '', <!--Leave this blank; this is for token-based deploys. -->
                '<bot_id>',
                {
                    serverUrl: 'https://webchat-kprod.moveworks.io/login/<bot_id>',
                    styles: '<optional, see below>'
                },
            );
        };
        script.src = 'https://webchat-kprod.moveworks.io/movewebchat-client-script.js';
        document.getElementById('webchat').appendChild(script);
    </script>
</div>
```

**`Gov`**

```Text Gov
<div id="webchat">
    <script>
        var script = document.createElement('script');
        script.type = "text/javascript";
        script.onload = function () {
            window.mwwebchat.openMWWebChat(
                '', <!--Leave this blank; this is for token-based deploys. -->
                '<bot_id>',
                {
                    serverUrl: 'https://<org_name>-chat.moveworksgov.com/login/<bot_id>',
                    styles: '<optional, see below>'
                },
            );
        };
        script.src = 'https://<org_name>-chat.moveworksgov.com/movewebchat-client-script.js';
        document.getElementById('webchat').appendChild(script);
    </script>
</div>
```

**`EU`**

```Text EU
<div id="webchat">
    <script>
        var script = document.createElement('script');
        script.type = "text/javascript";
        script.onload = function () {
            window.mwwebchat.openMWWebChat(
                '', <!--Leave this blank; this is for token-based deploys. -->
                '<bot_id>',
                {
                    serverUrl: 'https://webchat.prod.am-euc1.moveworks.io/login/<bot_id>',
                    styles: '<optional, see below>'
                },
            );
        };
        script.src = 'https://webchat.prod.am-euc1.moveworks.io/movewebchat-client-script.js';
        document.getElementById('webchat').appendChild(script);
    </script>
</div>
```

**`Canada`**

```Text Canada
<div id="webchat">
    <script>
        var script = document.createElement('script');
        script.type = "text/javascript";
        script.onload = function () {
            window.mwwebchat.openMWWebChat(
                '', <!--Leave this blank; this is for token-based deploys. -->
                '<bot_id>',
                {
                    serverUrl: 'https://webchat.prod.am-cac1.moveworks.io/login/<bot_id>',
                    styles: '<optional, see below>'
                },
            );
        };
        script.src = 'https://webchat.prod.am-cac1.moveworks.io/movewebchat-client-script.js';
        document.getElementById('webchat').appendChild(script);
    </script>
</div>
```

**`Australia`**

```Text Australia
<div id="webchat">
    <script>
        var script = document.createElement('script');
        script.type = "text/javascript";
        script.onload = function () {
            window.mwwebchat.openMWWebChat(
                '', <!--Leave this blank; this is for token-based deploys. -->
                '<bot_id>',
                {
                    serverUrl: 'https://webchat.prod.am-apse2.moveworks.io/script/<bot_id>',
                    styles: '<optional, see below>'
                },
            );
        };
        script.src = 'https://webchat.prod.am-apse2.moveworks.io/movewebchat-client-script.js';
        document.getElementById('webchat').appendChild(script);
    </script>
</div>
```

**`Japan`**

```Text Japan
<div id="webchat">
    <script>
        var script = document.createElement('script');
        script.type = "text/javascript";
        script.onload = function () {
            window.mwwebchat.openMWWebChat(
                '', <!--Leave this blank; this is for token-based deploys. -->
                '<bot_id>',
                {
                    serverUrl: 'https://webchat.jp.moveworks.com/login/<bot_id>',
                    styles: '<optional, see below>'
                },
            );
        };
        script.src = 'https://webchat.jp.moveworks.com/movewebchat-client-script.js';
        document.getElementById('webchat').appendChild(script);
    </script>
</div>
```

**`UK`**

```Text UK
<div id="webchat">
    <script>
        var script = document.createElement('script');
        script.type = "text/javascript";
        script.onload = function () {
            window.mwwebchat.openMWWebChat(
                '', <!--Leave this blank; this is for token-based deploys. -->
                '<bot_id>',
                {
                    serverUrl: 'https://webchat.uk.moveworks.com/login/<bot_id>',
                    styles: '<optional, see below>'
                },
            );
        };
        script.src = 'https://webchat.uk.moveworks.com/movewebchat-client-script.js';
        document.getElementById('webchat').appendChild(script);
    </script>
</div>
```

**`US Prod 4`**

```Text US Prod 4
<div id="webchat">
    <script>
        var script = document.createElement('script');
        script.type = "text/javascript";
        script.onload = function () {
            window.mwwebchat.openMWWebChat(
                '', <!--Leave this blank; this is for token-based deploys. -->
                '<bot_id>',
                {
                    serverUrl: 'https://webchat.prod4.us.moveworks.com/login/<bot_id>',
                    styles: '<optional, see below>'
                },
            );
        };
        script.src = 'https://webchat.prod4.us.moveworks.com/movewebchat-client-script.js';
        document.getElementById('webchat').appendChild(script);
    </script>
</div>
```

**`US Prod 3`**

```Text US Prod 3
<div id="webchat">
    <script>
        var script = document.createElement('script');
        script.type = "text/javascript";
        script.onload = function () {
            window.mwwebchat.openMWWebChat(
                '', <!--Leave this blank; this is for token-based deploys. -->
                '<bot_id>',
                {
                    serverUrl: 'https://webchat.prod3.us.moveworks.com/login/<bot_id>',
                    styles: '<optional, see below>'
                },
            );
        };
        script.src = 'https://webchat.prod3.us.moveworks.com/movewebchat-client-script.js';
        document.getElementById('webchat').appendChild(script);
    </script>
</div>
```

* You can add these optional parameters along with the serverURL. See below.
  * `styles` controls the position of the avatar

**`Commercial`**

```Text Commercial
								{
                    serverUrl: 'https://webchat-kprod.moveworks.io/login/<bot_id>',
                    styles: { 
							        bottom: '0px',
							        right: '10px',
							        zIndex: 999,
							    },
                },
```

**`Gov`**

```Text Gov
								{
                    serverUrl: 'https://<org_name>-chat.moveworksgov.com/login/<bot_id>',
                    styles: { 
							        bottom: '0px',
							        right: '10px',
							        zIndex: 999,
							    },
                },
```

**`EU`**

```Text EU
								{
                    serverUrl: 'https://webchat.prod.am-euc1.moveworks.io/login/<bot_id>',
                    styles: { 
							        bottom: '0px',
							        right: '10px',
							        zIndex: 999,
							    },
                },
```

**`Canada`**

```Text Canada
								{
                    serverUrl: 'https://webchat.prod.am-cac1.moveworks.io/login/<bot_id>',
                    styles: { 
							        bottom: '0px',
							        right: '10px',
							        zIndex: 999,
							    },
                },
```

**`Australia`**

```Text Australia
								{
                    serverUrl: 'https://webchat.prod.am-apse2.moveworks.io/login/<bot_id>',
                    styles: { 
							        bottom: '0px',
							        right: '10px',
							        zIndex: 999,
							    },
                },
```

**`Japan`**

```Text Japan
								{
                    serverUrl: 'https://webchat.jp.moveworks.com/login/<bot_id>',
                    styles: { 
							        bottom: '0px',
							        right: '10px',
							        zIndex: 999,
							    },
                },
```

**`UK`**

```Text UK
								{
                    serverUrl: 'https://webchat.uk.moveworks.com/login/<bot_id>',
                    styles: { 
							        bottom: '0px',
							        right: '10px',
							        zIndex: 999,
							    },
                },
```

**`US Prod 4`**

```Text US Prod 4
								{
                    serverUrl: 'https://webchat.prod4.us.moveworks.com/login/<bot_id>',
                    styles: { 
							        bottom: '0px',
							        right: '10px',
							        zIndex: 999,
							    },
                },
```

**`US Prod 3`**

```Text US Prod 3
								{
                    serverUrl: 'https://webchat.prod3.us.moveworks.com/login/<bot_id>',
                    styles: { 
							        bottom: '0px',
							        right: '10px',
							        zIndex: 999,
							    },
                },
```

\

## Docs

- [Adding Embedded AI Assistant to ServiceNow](https://docs.moveworks.com/ai-assistant/ai-assistant-web-surfaces/moveworks-for-web/moveworks-for-web-installation-servicenow.md): 
- [Adding Embedded AI Assistant to SharePoint Online (Cloud)](https://docs.moveworks.com/ai-assistant/ai-assistant-web-surfaces/moveworks-for-web/moveworks-for-web-installation-sharepoint-online.md): 
- [Adding Embedded AI Assistant to Google Sites](https://docs.moveworks.com/ai-assistant/ai-assistant-web-surfaces/moveworks-for-web/moveworks-for-web-google-sites.md): This guide walks through installing Moveworks for Web on a Google Site.
- [Adding Embedded AI Assistant to Unily](https://docs.moveworks.com/ai-assistant/ai-assistant-web-surfaces/moveworks-for-web/moveworks-for-web-installation-unily.md): This guide walks through how to set up Moveworks for Web on Unily