# 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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.ebbot.ai/ebbot-docs/developer-resources/ebbot-chat/implement-chat-widget/adding-the-ebbot-widget-to-a-sharepoint-environment.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.