> ## 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.

# Webhook

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

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

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

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

<Info>
  實體 PlayStream 事件不支援透過 Webhook 轉送。
</Info>

## 存取 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** 按鈕將其永久移除。

<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 面板" 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 設定" width="1686" height="1080" data-path="images/playfab/data-analytics/acting-data/Webhook-config.png" />


## Related topics

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