> For the complete documentation index, see [llms.txt](https://docs.ebbot.ai/ebbot-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ebbot.ai/ebbot-docs/developer-resources/ebbot-chat/implement-chat-widget/adding-the-ebbot-widget-to-a-sharepoint-environment.md).

# Adding the Ebbot Widget to a SharePoint Environment

1. **Download the app package**\
   [Download the Ebbot widget app](https://drive.google.com/drive/folders/1BwjrmKLMq5bru7r--m79VD7LSI4ebnhX?usp=drive_link).\
   Make sure the file Ebbot.sppkg is saved locally.
2. **Upload the app to the SharePoint App Catalog**
   1. Go to your SharePoint App Catalog. The URL is usually:\
      https\://\[domain].sharepoint.com/sites/appcatalog/AppCatalog/Forms/AllItems.aspx
   2. Click New.\
      ![](/files/5Rr2KHT9f1PQzU2OmJ4l)
   3. Select Browse, then upload the downloaded Ebbot.sppkg file.
   4. Complete the upload and approve the app if prompted.
3. Add the widget to a SharePoint page
   1. Navigate to the SharePoint page where you want to add the widget.
   2. Click Edit to edit the page.
   3. Click the plus (+) icon to add a new web part.
   4. Select EbbotWidget from the list of available elements.\
      ![](/files/9nlbZ7JdjwILGMSQk0RU)
   5. In the widget configuration:
   6. Select the appropriate hosting environment
   7. Enter your Bot ID\
      ![](/files/PeWesny6BCzosjZj4WhQ)
4. Publish the page
   1. Save the page.
   2. Publish the page.
   3. Refresh the page to verify that the Ebbot widget is visible and working.

### Configure Trusted Script Sources (CSP)

With Microsoft’s Content Security Policy (CSP) enforcement for SharePoint Online, external scripts and connections are blocked by default unless explicitly allowed.

To ensure the Ebbot widget loads correctly, communicates with our APIs, and supports real-time chat, you must add Ebbot domains to your SharePoint **Trusted Script Sources**.

#### Identify Required Domains

Depending on your Ebbot environment, you need to allowlist three types of domains:

* **Asset Domain** (scripts and styles)
* **API Domain**
* **WebSocket Domain** (real-time communication)

| Environment          | Asset Domain                        | API Domain             | WebSocket Domain    |
| -------------------- | ----------------------------------- | ---------------------- | ------------------- |
| OVH EU               | <https://storage.gra.cloud.ovh.net> | <https://ebbot.eu>     | wss\://ebbot.eu     |
| Google EU            | <https://storage.v2.ebbot.app>      | <https://v2.ebbot.app> | wss\://v2.ebbot.app |
| Google North America | <https://storage.ca.ebbot.app>      | <https://ca.ebbot.app> | wss\://ca.ebbot.app |

> Note: You can verify the correct domains in the CSP section inside the Ebbot platform.

***

#### Add Domains in SharePoint

**Method A: SharePoint Admin Center (Recommended)**

1. Log in to the **SharePoint Admin Center**
2. Go to **Advanced → Script sources**
3. Click **+ Add source**
4. Add your **Asset Domain** and save
5. Repeat for:
   * API Domain
   * WebSocket Domain

#### Important Notes

* All three domains must be added for the widget to function properly
* Missing domains may result in:
  * Widget not loading
  * Failed API calls
  * Broken real-time chat
* Changes may take a few minutes to propagate