# AdvocateのWebhook購読を作成・管理する
Webhook は、イベントが発生したときに実行されるコードです。Advocate では、Webhook を使用して URL を登録でき、その URL に対して、プログラム内でイベントが発生するたびに POST が送信されます。たとえば、新しい参加者に対してバニティクーポンコードが作成されたときにイベントオブジェクトが作成されます。Webhook を作成および管理する方法は 2 つあります: [Advocate API 経由で](https://integrations.impact.com/impact-brand/docs/api-webhooks) または Advocate プラットフォームで行う方法です。このヘルプ記事では、Advocate プラットフォームを通じて webhook を管理する方法を説明します。
#### Webhook サブスクリプションを作成する
1. 上部のナビゲーションバーから  **\[ユーザープロフィール] → 設定**.
2. 以下の左側の列で *Advocate 設定*で **Webhook**.
3. 〜の *Webhook サブスクリプション* ページを開き、 **サブスクリプションを作成**.
4. 以下 *URL に POST*を選択し、特定のイベントに関するリアルタイム更新を送信するためにアプリケーションが使用する一意のアドレスを入力します。
5. 必要に応じて、下に *Webhook 名*新しい webhook サブスクリプションの名前を入力します。
6. 次を選択します **保存**.
#### Webhook ログのトラブルシューティング
プログラム内でイベントが発生するたびに Advocate が POST する URL を登録すると、ログを確認して、失敗した webhook イベントのトラブルシューティングを行えます。
**Webhook ログにアクセスする**
1. 上部のナビゲーションバーから  **\[ユーザープロフィール] → 設定**.
2. 以下の左側の列で *Advocate 設定*で **Webhook**.
3. 〜の *Webhook サブスクリプション* ページを開き、 **ログを表示**.
4. 以下のフィルターを使用して *Webhook イベントログ* Webhook を絞り込みます。
* 以下の *フィルター参照* 詳細については以下を参照してください。
フィルター参照
| フィルター | 説明 |
| ----- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| 種類 | 対象の webhook でフィルター [イベントタイプ](https://integrations.impact.com/impact-brand/docs/api-webhooks#section-webhook-events)。このフィルターの既定値は *すべての種類*. |
| 期間 | Webhook が最後に更新された期間でフィルターします。このフィルターの既定値は *全期間*. |
**Webhook の詳細を表示**
1. 特定の webhook を選択して *Webhook の詳細* ビューを開きます。
2. このビューには、webhook サブスクリプションのトラブルシューティングに使用できる情報が表示されます。
* 以下の *イベント参照* 詳細については以下を参照してください。
イベント参照
| フィルター | 説明 |
| ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 種類 | その webhook [イベントタイプ](https://integrations.impact.com/impact-brand/docs/api-webhooks#section-webhook-events). |
| Webhook ID | Webhook の一意の識別子です。 |
| 作成日 | Webhook が作成された日付です。 |
| イベントデータ | その webhook [ペイロード](https://integrations.impact.com/impact-brand/docs/api-webhooks#section-payloads). |
| サブスクリプション | その webhook が送信された webhook サブスクリプションとそのステータス。 |
| サブスクリプションの詳細 | webhook サブスクリプションのエンドポイントから受信したレスポンスの詳細。詳細には、webhook の配信試行、試行のタイムスタンプ、送信先から受信した HTTP ステータスコード、またリクエストの処理に時間がかかりすぎて送信先サーバーからの応答を受信できずにタイムアウトしたかどうかが含まれます。 |
**失敗したイベント配信のための webhook 再試行システム**
* Rest hook は、イベントがトリガーされた直後に配信されます。エンドポイントが配信試行に正常に応答しない場合（つまり、200 以外のステータスコードで応答した場合）、その配信は失敗と見なされます。
* 失敗した配信は、成功するか、72 回の試行が行われるまで、前回の失敗試行の 1 時間後に毎回再試行されます（1 時間に 1 回の再試行で、約 3 日間）。
* エラーを継続的に返す webhook エンドポイントは、以下のエラー数に達すると自動的に無効化されます:
| ステータスコード | 受信したエラー |
| -------- | ------- |
| 4xx エラー | 1000 |
| 5xx エラー | 2000 |
| 3xx エラー | 2000 |
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://help.impact.com/brand/ja/nitsuitebitaidesuka/advocate-program/advocate-program-settings/create-and-manage-advocate-webhook-subscriptions.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.