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 simpleread
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!

Last updated
Was this helpful?