# イベントの送信先を管理する

ワークベンチを使用して、イベントの送信先を設定し、Stripe からのイベントを受信します。

このガイドでは、ワークベンチを使用してイベントの送信先を設定する方法を説明しています。

Stripe アカウントに関するイベント受信の概要とベストプラクティスについては、[イベントガイド](https://docs.stripe.com/event-destinations.md)をご覧ください。

## 新しいイベントの送信先を作成する

Webhook エンドポイント、AWS EventBridge の送信先、Azure Event Grid の送信先に対して新しいイベントの送信先を作成できます。

#### Webhook

1. Workbench で [Webhooks](https://dashboard.stripe.com/webhooks) タブを開きます。
1. **新しい送信先を作成**をクリックします。
1. 使用する [events オブジェクト](https://docs.stripe.com/api/events.md)の API バージョンを選択します。
1. [Connect](https://docs.stripe.com/connect.md) を使用している場合は、**連結アカウントのイベント** をリッスンできます。それ以外の場合は、**アカウントのイベント** を選択します。
1. 送信先に送る[イベントタイプ](https://docs.stripe.com/api/events/types.md)を選択して、**続ける**をクリックします。
1. **Webhook** を選択して、イベントを HTTPS エンドポイントに送信します。
1. Stripe の Webhook 送信先である **エンドポイント URL** と、オプションのエンドポイントの説明を指定します。
1. **送信先を作成する** をクリックして、Webhook エンドポイントを作成します。

#### AWS EventBridge

1. Workbench で [Webhooks](https://dashboard.stripe.com/webhooks) タブを開きます。
1. **新しい送信先を作成**をクリックします。
1. 使用する [events オブジェクト](https://docs.stripe.com/api/events.md)の API バージョンを選択します。
1. [Connect](https://docs.stripe.com/connect.md) を使用している場合は、**連結アカウントのイベント** をリッスンできます。それ以外の場合は、**アカウントのイベント** を選択します。
1. 送信先に送る[イベントタイプ](https://docs.stripe.com/api/events/types.md)を選択して、**続ける**をクリックします。
1. イベントをお客様の AWS アカウントに直接送信するには、**AWS EventBridge** を選択します。
1. イベントの送信先の **AWS アカウント番号**を入力します。
1. イベントを受信する **AWS リージョン**を指定します。
1. (オプション) 送信先の名前と説明を含めます。

#### Azure Event Grid

1. Workbench で [Webhooks](https://dashboard.stripe.com/webhooks) タブを開きます。
1. **新しい送信先を作成**をクリックします。
1. 使用する [events オブジェクト](https://docs.stripe.com/api/events.md)の API バージョンを選択します。
1. [Connect](https://docs.stripe.com/connect.md) を使用している場合は、**連結アカウントのイベント** をリッスンできます。それ以外の場合は、**アカウントのイベント** を選択します。
1. 送信先に送る[イベントタイプ](https://docs.stripe.com/api/events/types.md)を選択して、**続ける**をクリックします。
1. **Azure Event Grid (Azure Event Grid)** を選択して、イベントを Azure サブスクリプションに直接送信します。
1. **Azure サブスクリプション ID** を指定し、イベントを受信する **Azure リージョン**を選択します。
1. Azure Event Grid の**リソースグループ名**を指定します。
1. (オプション) 送信先の名前と説明を含めます。
![Webhook タブで新しい Webhook を登録する](https://b.stripecdn.com/docs-statics-srv/assets/create-webhook-endpoint.92271ebcb6d3c1f936baaeeda36feafc.png)

## 既存のイベントの送信先を設定する

[Webhook](https://dashboard.stripe.com/webhooks) タブで、既存のイベントの送信先を更新または削除できます。また、送信先を一時的に無効にすることもできます。Stripe は、創始オン先が無効になっている間に生成されたイベントの再送信を試行しません。また、[イベントの送信先の管理](https://docs.stripe.com/api/v2/core/event_destinations.md)をプログラムで行うこともできます。

## イベント配信を表示する

[Stripe CLI](https://docs.stripe.com/stripe-cli.md) を使用して、端末で直接[イベントをリッスン](https://docs.stripe.com/webhooks.md#test-webhook)することもできます。

イベントの送信を表示するには、次の手順を実行します。

1. Workbench で [Webhook](https://dashboard.stripe.com/webhooks) タブを開きます。
1. イベントの送信先を選択します。
1. **イベントの配信**タブをクリックします。

**イベントの送信先**タブには、イベントのリストと、各イベントが (Delivered)、(Pending)、(Failed) のいずれであるかが表示されます。イベントをクリックして、**配信の試行**を表示すると、以前行われた配信の試行の HTTP ステータスコードや、保留中になっているイベントの今後の配信時刻が示されます。
![Webhook エンドポイントのイベントの送信先タブでイベント送信の試行を表示する](https://b.stripecdn.com/docs-statics-srv/assets/view-event-deliveries.375483a863ab143a0e92f01fa01c14b0.png)

Webhook エンドポイントの**イベントの送信先**タブでイベント送信の試行を表示します。

## イベントの送信を再試行する

本番環境では、Stripe は指数バックオフを使用して最長 3 日間、お客様の Webhook エンドポイントに特定のイベントの配信を試行します。ワークベンチに掲載されている Webhook エンドポイントの**イベントの送信先**セクションで、次回の再試行が発生する時期を表示できます。

[サンドボックス](https://docs.stripe.com/sandboxes.md)では、Stripe は数時間にわたって再試行を 3 回繰り返します。その後、ワークベンチの **Webhook** タブを使用して、目的のエンドポイントにリストされている**イベント配信**に移動し、Webhook エンドポイントへの個々のイベントの送信を手動で再試行できます。また、[見逃したイベントをクエリ](https://docs.stripe.com/api/events/list.md)して、任意の期間のデータを照合することもできます。
![Webhook エンドポイントのイベントの送信先タブを使用して、イベントの送信を再試行する](https://b.stripecdn.com/docs-statics-srv/assets/retry-failed-event-deliveries.225753ebf217cd1e9d0798f0c6f0a198.png)

Webhook エンドポイントの**イベントの送信先**タブを使用して、イベントの送信を再試行します。

## See also

- [インタラクティブな Webhook エンドポイントビルダー](https://docs.stripe.com/webhooks/quickstart.md)