> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Webhooks

> Game Manager 中的 PlayFab Webhooks 面板概览，包括如何访问它以及配置 Webhook 终结点以将事件数据转发到你的服务器。

<Note>
  我们建议使用 [自动化规则](/services/playfab/data-analytics/acting-data/action-rules-quickstart) 而不是 Webhooks，因为自动化规则支持 V2 操作，并提供与 Webhooks 相同的功能。
</Note>

在复杂的系统中，你可能希望在你的自定义服务器上提供额外的事件处理。为此，PlayFab 提供了 Webhooks。

每当发出新事件时，都可以通过向你的自定义 Web 终结点发出 POST 请求将其转发到你的服务器。然后，事件数据将作为请求的 JSON 正文传递。

<Info>
  实体 PlayStream 事件不支持使用 Webhooks 转发。
</Info>

## 访问 Webhooks

要访问 PlayFab **Game Manager** 屏幕中的 **Webhooks** 面板：

1. 在侧边菜单中选择 **Data**。
2. 然后选择 **Webhooks** 选项卡。

## Webhooks 面板概览

下图提供了 **Webhooks** 面板的概览。

1. **New Webhook** 按钮允许你创建和配置新的 Webhook。
2. **Webhook Name** 区域可用于访问和配置 Webhook。
3. **Status** 区域显示 Webhook 当前是否**已启用**。
4. **Failing Since** 区域显示 Webhook 终结点何时停止返回 **OK** 响应。
5. 选择一个或多个 Webhooks 时，你可以使用 **Delete** 按钮将其永久删除。

<img src="https://mintcdn.com/microsoft-4404708b/IwSYTY5BEqd_x-HK/images/playfab/data-analytics/acting-data/Webhook-Landing.PNG?fit=max&auto=format&n=IwSYTY5BEqd_x-HK&q=85&s=c574b5208aa05816dd5a86e23023fea9" alt="Game Manager - Data - Webhooks panel" width="1366" height="920" data-path="images/playfab/data-analytics/acting-data/Webhook-Landing.PNG" />

## 配置 Webhook

下图描述了用于配置 Webhook 的选项。

1. 使用 **Name** 字段创建一个可唯一标识 Webhook 的 Webhook 名称。
2. 设置 **Endpoint URI**。当 **Event** 发生时，将命中此 **URI**。
3. 你可以将 **Webhook** 设置为 **Enabled** - **true** 或 **false**。这允许你暂时暂停 Webhook 而无需将其从系统中完全删除。
4. 如果你希望将多个事件以数组形式发布到你的服务，可以设置 **Post multiple events in JSON array** 选项。如果选择此选项，你的服务必须能够处理多个事件和单个事件。
5. 你最多可以添加三个请求标头及这些标头的值。这允许你以安全的方式将标头发布到 Azure Event Hubs、Azure Functions、Google Functions 和 Amazon Lambda 等服务。

<Note>
  请求标头键最多可为 64 个字符，每个标头的值最多可为 256 个字符。
</Note>

1. 设置 **Filters** 以仅处理你需要的 **Events**。你可以按 **Event Name**、**Event Source** 和 **PlayerID** 进行筛选。

<Note>
  每个 **Group** 可以有多个 **Filters**，但每个 **Filter** 设置都必须匹配才能使事件落入 **Filter Group**。
</Note>

1. 你可以定义多个 **Filter Groups** 以包含不同的筛选器。**Events** 必须至少落入 *一个* 组才能传递给 Webhook。

<img src="https://mintcdn.com/microsoft-4404708b/IwSYTY5BEqd_x-HK/images/playfab/data-analytics/acting-data/Webhook-config.png?fit=max&auto=format&n=IwSYTY5BEqd_x-HK&q=85&s=25486fe826115b4b8f42360ae4001ff0" alt="Game Manager - Data - Webhooks - Webhook Configuration" width="1686" height="1080" data-path="images/playfab/data-analytics/acting-data/Webhook-config.png" />


## Related topics

- [从 CloudScript 发出 Webhook 调用](/zh-CN/services/playfab/live-service-management/service-gateway/automation/cloudscript/making-webhook-calls-from-cloudscript.md)
- [Photon 快速入门](/zh-CN/services/playfab/live-service-management/service-gateway/add-ons/photon/quickstart.md)
- [实时分析核心概念](/zh-CN/services/playfab/data-analytics/ingest-data/real-time-analytics-core-concepts.md)
- [Game Manager 参考](/zh-CN/services/playfab/live-service-management/gamemanager/reference.md)
- [使用 Azure Functions 的 PlayFab CloudScript 快速入门指南](/zh-CN/services/playfab/live-service-management/service-gateway/automation/cloudscript-af/quickstart.md)