SharePoint API

Create an app

Ebbot utilizes the Microsoft Graph API to fetch SharePoint content and convert it to Ebbot documents for EbbotGPT to generate responses from. In order to keep the content secure, our SharePoint scraper must be granted permissions to read the content of sites and pages. Each client therefore needs to create an app in their Microsoft Entra environment which has Full Control permissions to the SharePoint sites and pages in question. Ebbot has no control over this app, it will only be used to grant Ebbot read permissions to the selected sites.

Follow these steps to set up such an app.

Why a 'Full Control' App is Needed (And Why It's Safe)

We understand the term "Full Control" can sound concerning. Let's clarify exactly what it means in this context.

This permission does NOT give Ebbot full control over your SharePoint environment.

Instead, you will create a new, dedicated application within your own Microsoft Entra ID (Azure). Think of this app as a temporary, specialized administrator that only you control.

• You Create It, You Control It: This application is created and managed entirely by you. Ebbot has no access to or control over it.

• Its Sole Purpose: The only reason this app needs FullControl permissions is so it has the authority to grant another application (the Ebbot scraper) the simple read permission it needs to view content on specific sites.

Give Ebbot permission to read

When a FullControl app is in place, the app needs to grant the Ebbot app `read` permissons to each individual site that should be scraped. This process involves several steps to get everything working, and to help with this, we have created a Postman Collection that contains all the necessary API calls needed.

Follow this guide to import and use the Postman Collection

Authenticate in Ebbot

When all steps above are complete, you should be able to create a new source in Ebbot using your content from SharePoint. To do this, first log in to Ebbot

Then, in the left sidebar, navigate to EbbotGPT -> Knowledge

Click the "Sources" tab and the "Create new" button in the top left.

Select SharePoint API as type, then click "Authenticate with SharePoint". This opens a dialog box where you need to log in to the Microsoft Azure portal with an account that has permissions to your FullControl app.

Done! After Ebbot completes its run, you should see documents in Ebbot corresponding to your SharePoint sites!

Create app with Sites.FullControl.All permission in AzureEbbot SharePoint Postman Guide