ALVAO Knowledge Base SharePoint Connector

This module allows you to include documents from a Microsoft SharePoint document library in the Knowledge base page and other parts of Alvao, including the ALVAO for Teams module (and its chatbot) and the ALVAO Service Desk AI Assistant module.

Technical requirements

• ALVAO Service Desk
• Microsoft SharePoint
• ALVAO SaaS or Microsoft Entra ID user authentication

Configuration

1. Turn on the Administration - Settings - Microsoft Entra ID - Features - Knowledge from Microsoft SharePoint - Enable option, and let the Microsoft Entra ID tenant administrator to log into the application to provide consent on behalf of the entire organization.

2. On the same page, use the Select root folder link to specify a SharePoint document library folder containing knowledge documents.

   Documents of the following formats are supported:

   • pdf
   • docx, doc
   • txt

   Other documents are be ignored.

   Users can view only documents they are eligible to read in the document library.

3. Go to Administration - Service Desk - Services - choose a service - Edit - Properties - Extended section of the form - Knowledge folders from Microsoft SharePoint and click the Add link to add document library folders containing knowledge documents regarding this service.

   Repeat this step for other services.

The powershell script to grant read permission for the SharePoint site to the application:

$siteId = "<hostname>,<site-id>"
$params = @{
    roles = @(
        "read"

    )

    grantedTo = @{

        application = @{

            id = "<application-id>"

            displayName = "ALVAO Sharepoint Indexer"

        }

    }   

}

$permission = New-MgSitePermission -SiteId $siteId -BodyParameter $params
Write-Host "Permission Id: $($permission.Id)"
Write-Host "Application Id: $($permission.GrantedToIdentities.application.id)"
Write-Host "Display Name: $($permission.GrantedToIdentities.application.displayName)"
Write-Host "Role: $($permission.Roles -join ', ')"