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

> アクセス方法や、イベント データをサーバーに転送する Webhook エンドポイントの構成方法など、Game Manager の PlayFab Webhook パネルの概要。

<Note>
  Automation Rules は V2 アクションをサポートしており、Webhook と同じ機能を提供するため、Webhook の代わりに [Automation Rules](/services/playfab/data-analytics/acting-data/action-rules-quickstart) を使用することをお勧めします。
</Note>

複雑なシステムでは、カスタム サーバーで追加のイベント処理を提供したい場合があります。これを実現するために、PlayFab は Webhook を提供しています。

新しいイベントが発行されるたびに、カスタム Web エンドポイントに POST リクエストを行うことで、そのイベントをサーバーに転送できます。イベント データは、その後リクエストの JSON 本文として渡されます。

<Info>
  エンティティ PlayStream イベントは、Webhook を使用した転送をサポートしません。
</Info>

## Webhook にアクセスする

PlayFab **Game Manager** 画面の **Webhooks** パネルにアクセスするには:

1. サイドバー メニューから **Data** を選択します。
2. 次に **Webhooks** タブを選択します。

## Webhook パネルの概要

以下の画像は、**Webhooks** パネルの概要を示しています。

1. **New Webhook** ボタンで、新しい Webhook を作成して構成できます。
2. **Webhook Name** エリアを使用して、Webhook にアクセスして構成できます。
3. **Status** エリアは、Webhook が現在 **有効** かどうかを示します。
4. **Failing Since** エリアは、Webhook エンドポイントが **OK** レスポンスを返さなくなった時刻を示します。
5. 1 つ以上の 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 panel" width="1366" height="920" data-path="images/playfab/data-analytics/acting-data/Webhook-Landing.PNG" />

## Webhook を構成する

以下の画像は、Webhook を構成するためのオプションを説明しています。

1. **Name** フィールドを使用して、Webhook を一意に識別する名前を作成します。
2. **Endpoint URI** をセットアップします。この **URI** は、**イベント** が発生したときにヒットされます。
3. **Webhook** を **Enabled** - **true** または **false** に設定できます。これにより、Webhook をシステムから完全に削除 (削除) せずに一時的に一時停止できます。
4. サービスに複数のイベントを配列で投稿したい場合は、**Post multiple events in JSON array** オプションを設定できます。このオプションを選択した場合、サービスは複数と単一のイベントの両方を処理できる必要があります。
5. 最大 3 つのリクエスト ヘッダーとそれらのヘッダーの値を追加できます。これにより、Azure Event Hubs、Azure Functions、Google Functions、Amazon Lambda などのサービスに安全な方法でヘッダーを投稿できます。

<Note>
  リクエスト ヘッダーのキーは最大 64 文字、値は各ヘッダーごとに最大 256 文字にできます。
</Note>

1. 必要な **イベント** のみを処理するように **Filters** をセットアップします。**Event Name**、**Event Source**、**PlayerID** でフィルタリングできます。

<Note>
  **Group** ごとに複数の **Filters** を持つことができますが、イベントが **Filter Group** に該当するには、各 **Filter** 設定が一致する必要があります。
</Note>

1. 異なるフィルターを含む複数の **Filter Groups** を定義できます。**イベント** が Webhook に渡されるには、少なくとも *1 つ* のグループに該当する必要があります。

<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 呼び出しを行う](/ja-jp/services/playfab/live-service-management/service-gateway/automation/cloudscript/making-webhook-calls-from-cloudscript.md)
- [Photon クイックスタート](/ja-jp/services/playfab/live-service-management/service-gateway/add-ons/photon/quickstart.md)
- [リアルタイム分析の中核概念](/ja-jp/services/playfab/data-analytics/ingest-data/real-time-analytics-core-concepts.md)
- [Azure Functions を利用した PlayFab CloudScript のクイックスタート ガイド](/ja-jp/services/playfab/live-service-management/service-gateway/automation/cloudscript-af/quickstart.md)
- [Game Manager リファレンス](/ja-jp/services/playfab/live-service-management/gamemanager/reference.md)