Connect a Microsoft SharePoint Account to Self-Service Agent
- Identify your Microsoft Global Administrators. The SharePoint integration uses application permissions that require admin consent in Microsoft Entra. Only Global Administrators can grant admin consent for your organization.
- Ensure a Microsoft Global Administrator is available when you are configuring the connector for the first time so that they can grant admin consent during the course of the set up.
- Set up and enable Agent System of Record and Self-Service Agent:
You can enable the Self-Service Agent to use documents in your Microsoft SharePoint account to answer your employee's policy-related questions. Adding SharePoint as a document connector increases the relevancy of Self-Service Agent responses without the need to manually upload your existing documents to Workday.
When you don't have the Help SKU, ensure you connect to SharePoint before enabling the Policy Intelligence skill on the Self-Service Agent so that you don't encounter an error.
- You can use 1 of these methods:
- Use a Workday-managed OAuth app. When you connect to SharePoint from Workday, use a SharePoint account that is designated as a service account rather than an individual user’s account. This ensures that employee turnover doesn’t disrupt agent access or the employee experience.
- Use a custom OAuth app. See: Configure a Custom OAuth App for Self-Service Agent Sharepoint Connector.
- (For the Workday-managed OAuth app only) Grant Admin Consent in Microsoft Entra.
- Open a new browser window and access the Sharepoint permissions page.
- On the dialog window listing out the permissions, clickAccept.
- (For the Workday-managed OAuth app only) Verify that the app permissions were installed.
- Open Microsoft Entra and access .
- Click the account name to open the application Overview page.
- ClickPermissions.
- On theAdmin consenttab, confirm that these permissions are listed:API NameClaim ValueTypeMicrosoft GraphGroupMember.Read.AllApplicationMicrosoft GraphSites.Read.AllApplicationMicrosoft GraphUser.ReadBasic.AllApplicationMicrosoft GraphFiles.Read.AllApplicationMicrosoft GraphGroupMember.Read.AllDelegatedMicrosoft GraphSites.Read.AllDelegatedMicrosoft GraphUser.ReadBasic.AllDelegatedMicrosoft GraphFiles.Read.AllDelegatedMicrosoft GraphUser.ReadDelegatedMicrosoft Graphoffline_accessDelegatedOffice 365 SharePoint OnlineSites.Read.AllApplication
- Initiate SharePoint connection from Workday.
- Sign in to Workday as a security administrator.
- Access theAgent Management Hub.
- On theAgent Registrytab, clickSelf-Service Agent.
- On theDocumentstab, clickManage Connectors.
- On the Microsoft dialog, sign in with the SharePoint service account that you intend to use for ingesting the policy files.
- Select SharePoint files in Workday.
- Access theAgent Management Hub.
- On theAgent Registrytab, clickSelf-Service Agent.
- On theDocumentstab, clickAdd Documents.
- On the Microsoft dialog, sign in with the SharePoint service account that you intend to use for ingesting the policy files.
- Select the files and folders to ingest into Workday.Workday is optimized to ingest up to 1,000 files totaling 200 MB of content within a 24-hour window. While you can select more than 200 MB, you can't select more than 1,000 files. Workday won’t process beyond 200 MB and does not indicate which files it did not process. The agent cannot provide responses from the files that were not ingested. We strongly recommend that you ensure the total size does not exceed 200 MB. The ingestion can take up to 24 hours to process the files and the associated permissions. Check back later to confirm that there were no errors during the ingestion process. The files will display aSyncedstatus once completed.
- Enable thePolicy Intelligenceskill and configure thesearch_policy_documentstool.You no longer need the Help SKU to enable thePolicy Intelligenceskill. If you have the Help SKU, the Self-Service Agent will also provide responses from your Workday Help articles.
The Self-Service Agent can now access your SharePoint policy documents and use them to answer questions. Self-Service Agent enforces the SharePoint file security when providing answers.
Test the Self-Service Agent to verify the accuracy of its responses related to the information in your SharePoint policy documents.