如何通过单个Webhook获取多站点SharePoint文件变更事件？

核心思路是：为每个目标站点的文档库单独注册Webhook，但统一指向同一个接收端点。SharePoint Webhook虽为站点/库级，但允许多个不同站点的Webhook订阅同一个URL，以此实现统一接收多站点的变更事件。

具体实现步骤 #

1. 批量为多站点文档库注册Webhook #

使用脚本（PowerShell或Graph API）遍历所有需要监控的站点，为每个站点的目标文档库注册Webhook，指定同一个接收URL。

示例PnP PowerShell脚本

# 配置参数
$targetSites = @("https://contoso.sharepoint.com/sites/site1", "https://contoso.sharepoint.com/sites/site2")
$webhookReceiveUrl = "https://your-public-endpoint.com/receive-sharepoint-events"
$targetListTitle = "Documents"

# 遍历站点注册Webhook
foreach ($siteUrl in $targetSites) {
    Connect-PnPOnline -Url $siteUrl -Interactive
    $targetList = Get-PnPList -Identity $targetListTitle
    # 注册Webhook，设置1年过期时间
    Add-PnPWebhook -List $targetList -NotificationUrl $webhookReceiveUrl -ExpirationDate (Get-Date).AddYears(1)
    Disconnect-PnPOnline
}

注册完成后，每个站点的文档库都会向同一个URL推送变更事件，你可以通过事件payload中的subscriptionId、siteUrl、listId字段区分事件来源。

2. 统一处理接收端点的事件 #

你的Webhook接收端点需要解析来自不同站点的事件payload，关键字段示例：

{
  "subscriptionId": "a1b2c3d4-xxxx-xxxx-xxxx-xxxx",
  "siteUrl": "https://contoso.sharepoint.com/sites/site1",
  "listId": "e5f6g7h8-xxxx-xxxx-xxxx-xxxx",
  "resource": "drives/b!xxxx/lists/xxxx"
}

基于这些字段，你可以在端点中实现统一存储、分类处理等逻辑，比如按站点归档事件，或触发后续业务流程。

3. 维护Webhook订阅 #

• Webhook订阅默认最多1年过期，需定期批量更新订阅的过期时间，避免失效。可复用上述脚本，替换Add-PnPWebhook为Set-PnPWebhook延长有效期。
• 确保接收端点能处理Webhook注册时的验证请求：SharePoint会发送带validationToken的GET请求，端点需直接返回该token以完成订阅验证。

注意事项 #

• 接收端点必须是公网可访问的HTTPS地址，这是SharePoint Webhook的硬性要求。
• 注册Webhook的账户需拥有每个目标站点文档库的编辑权限，或具备管理Webhook的特定权限。
• 新增监控站点时，只需在脚本的targetSites数组中添加站点URL，重新运行注册脚本即可，无需修改接收端点代码。

内容的提问来源于stack exchange，提问作者Pawan Poojary