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

# Webhook

> Game Manager 中 PlayFab Webhooks 面板的概觀，包括如何存取該面板，以及設定 Webhook 端點以將事件資料轉送至您的伺服器。

> [!NOTE]
>
> 我們建議使用[自動化規則](https://docs.xbox.com/zh-TW/services/playfab/data-analytics/acting-data/action-rules-quickstart.md)而非 Webhook，因為自動化規則支援 V2 動作，並提供與 Webhook 相同的功能。

在複雜的系統中，您可能想要在自訂伺服器上提供額外的事件處理。為此，PlayFab 提供了 Webhook。

每當發出新事件時，都可以透過對您的自訂 Web 端點發出 POST 要求，將事件轉送至您的伺服器。事件資料接著會作為要求的 JSON 本文傳遞。

> [!NOTE]
>
> 實體 PlayStream 事件不支援透過 Webhook 轉送。

## 存取 Webhook

若要存取 PlayFab **Game Manager** 畫面中的 **Webhooks** 面板：

1. 在側邊欄功能表中選取 **Data**。
2. 然後選擇 **Webhooks** 索引標籤。

## Webhooks 面板概觀

下圖提供 **Webhooks** 面板的概觀。

1. **New Webhook** 按鈕可讓您建立及設定新的 Webhook。
2. **Webhook Name** 區域可用來存取及設定 Webhook。
3. **Status** 區域會顯示 Webhook 目前是否為 **enabled**。
4. **Failing Since** 區域會顯示 Webhook 端點從何時開始停止傳回 **OK** 回應。
5. 選取一或多個 Webhook 時，您可以使用 **Delete** 按鈕將其永久移除。

![Game Manager - Data - Webhooks 面板](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)

## 設定 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 個字元。

1. 設定 **Filters**，只處理您需要的 **Events**。您可以依 **Event Name**、**Event Source** 和 **PlayerID** 進行篩選。

> [!NOTE]
>
> 每個 **Group** 可以有多個 **Filters**，但事件必須符合每個 **Filter** 設定，才會歸入 **Filter Group**。

1. 您可以定義多個 **Filter Groups** 以包含不同的篩選條件。**Events** 必須至少歸入*一個*群組，才會傳遞至 Webhook。

![Game Manager - Data - Webhooks - Webhook 設定](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)


## Related topics

- [從 CloudScript 進行 Webhook 呼叫](https://docs.xbox.com/zh-TW/services/playfab/live-service-management/service-gateway/automation/cloudscript/making-webhook-calls-from-cloudscript.md)
- [PlayStream 事件功能](https://docs.xbox.com/zh-TW/services/playfab/data-analytics/ingest-data/playstream-event-capabilities.md)
- [Photon 快速入門](https://docs.xbox.com/zh-TW/services/playfab/live-service-management/service-gateway/add-ons/photon/quickstart.md)
- [即時分析核心概念](https://docs.xbox.com/zh-TW/services/playfab/data-analytics/ingest-data/real-time-analytics-core-concepts.md)
- [Game Manager 參考](https://docs.xbox.com/zh-TW/services/playfab/live-service-management/gamemanager/reference.md)