{"meta":{"title":"webhookの作成","intro":"Webhook を作成して、GitHub で発生する特定のイベントにサブスクライブできます。","product":"Webhooks","breadcrumbs":[{"href":"/ja/webhooks","title":"Webhooks"},{"href":"/ja/webhooks/using-webhooks","title":"Webhook の使用"},{"href":"/ja/webhooks/using-webhooks/creating-webhooks","title":"Webhook を作成する"}],"documentType":"article"},"body":"# webhookの作成\n\nWebhook を作成して、GitHub で発生する特定のイベントにサブスクライブできます。\n\n## webhookの作成について\n\n特定のリポジトリ、組織、 GitHub Enterprise アカウント、 GitHub Marketplace アカウント、 または GitHub Sponsors で発生する GitHub App の具体的なイベントに対して購読するための Webhook を作成できます。\n\nさまざまな種類の Webhook の詳細については、「[Webhook の種類](/ja/webhooks/types-of-webhooks)」を参照してください。\n\nWebhook イベントの完全な一覧については、「[Webhook のイベントとペイロード](/ja/webhooks/webhook-events-and-payloads)」を参照してください。\n\n## リポジトリの Webhook の作成\n\n特定のリポジトリで発生したイベントをサブスクライブするWebhook を作成できます。 そのリポジトリに Webhook を作成するには、リポジトリのオーナーであるか、リポジトリの管理者アクセス権が必要です。\n\nGitHub Web インターフェイスまたは REST API を使って、リポジトリの Webhook を作成できます。 REST API を使用してリポジトリ Webhook を作成する方法の詳細については、「[リポジトリ ウェブフック の REST API エンドポイント](/ja/rest/webhooks/repos#create-a-repository-webhook)」を参照してください。\n\n1. GitHub で、リポジトリのメイン ページに移動します。\n2. リポジトリ名の下にある ** \\[Settings]** をクリックします。 \\[設定] タブが表示されない場合は、 **\\[]** ドロップダウン メニューを選び、 **\\[設定]** をクリックします。\n\n ![タブを示すリポジトリ ヘッダーのスクリーンショット。 \\[設定\\] タブが濃いオレンジ色の枠線で強調表示されています。](/assets/images/help/repository/repo-actions-settings.png)\n3. 左側のサイドバーで、** \\[Webhooks]** をクリックします。\n4. **\\[Webhook の追加]** を選択します。\n5. \\[ペイロード URL] の下に、ペイロードを受信する URL を入力します。\n6. 必要に応じて、 **\\[コンテンツ タイプ]** ドロップダウン メニューを選び、Webhook ペイロードを受信するデータ形式をクリックします。\n * **application/json**は、JSONペイロードを`POST`リクエストのボディとして直接配信します。\n * **application/x-www-form-urlencoded** は、JSON ペイロードを payload というフォーム パラメーターとして送信します。`payload`\n7. 必要に応じて、 \\[シークレット] フィールドの下に、 `secret`キーとして使用する文字列を入力します。 エントロピーの高いランダムな文字列を選択してください。 Webhook シークレットを使用して、GitHub から発信されたリクエストのみに受信を制限することができます。 詳しくは、「[Webhook 配信を検証する](/ja/webhooks/using-webhooks/securing-your-webhooks)」をご覧ください。\n8. \\[この Webhook をトリガーするイベントを指定してください] で、受信する Webhook イベントを選択します。 必要な Webhook イベントのみをサブスクライブしてください。\n9. **\\[個別のイベントを選択する]** を選択した場合、Webhook をトリガーしたいイベントを選択します。\n10. 構成を追加した直後に Webhook をアクティブにするには、 **\\[アクティブ]** を選びます。\n11. **\\[Webhook の追加]** を選択します。\n\n新しい Webhook を作成すると、GitHub から簡単な `ping` イベントが送信されて、Webhook が正しく設定されたことがわかります。 詳しくは、「[Webhook のイベントとペイロード](/ja/webhooks/webhook-events-and-payloads#ping)」をご覧ください。\n\n## 組織のウェブフック作成\n\n特定の組織で発生するイベントをサブスクライブする Webhook を作成できます。 その組織で Webhook を作成するには、組織のオーナーである必要があります。\n\nGitHub Web インターフェイスまたは REST API を使って、organization の Webhook を作成できます。 REST API を使用して organization の Webhook を作成する方法の詳細については、「[組織の Webhook の REST API エンドポイント](/ja/rest/orgs/webhooks#create-an-organization-webhook)」を参照してください。\n\n1. GitHub の任意のページで、右上隅にあるプロフィール画像クリックします。\n2. ```\n **[自分の組織]** をクリックします。\n ```\n3. 組織の右側にある **\\[設定]** をクリックします。\n4. 左側のサイドバーで、** \\[Webhooks]** をクリックします。\n5. **\\[Webhook の追加]** を選択します。\n6. \\[ペイロード URL] の下に、ペイロードを受信する URL を入力します。\n7. 必要に応じて、 **\\[コンテンツ タイプ]** ドロップダウン メニューを選び、Webhook ペイロードを受信するデータ形式をクリックします。\n * **application/json**は、JSONペイロードを`POST`リクエストのボディとして直接配信します。\n * **application/x-www-form-urlencoded** は、JSON ペイロードを payload というフォーム パラメーターとして送信します。`payload`\n8. 必要に応じて、 \\[シークレット] フィールドの下に、 `secret`キーとして使用する文字列を入力します。 エントロピーの高いランダムな文字列を選択してください。 Webhook シークレットを使用して、GitHub から発信されたリクエストのみに受信を制限することができます。 詳しくは、「[Webhook 配信を検証する](/ja/webhooks/using-webhooks/securing-your-webhooks)」をご覧ください。\n9. \\[この webhook をトリガーするイベントを指定してください]で、受信する Webhook の種類を選択します。 必要な Webhook イベントのみをサブスクライブしてください。\n10. ```\n **個別のイベントを選択する**場合は、Webhook をトリガーするイベントを選択します。\n ```\n11. 構成を追加した直後に Webhook をアクティブにするには、 **\\[アクティブ]** を選びます。\n12. ```\n **[Webhook の追加]** を選択します。\n ```\n\n新しい Webhook を作成すると、GitHub から簡単な `ping` イベントが送信されて、Webhook が正しく設定されたことがわかります。 詳しくは、「[Webhook のイベントとペイロード](/ja/webhooks/webhook-events-and-payloads#ping)」をご覧ください。\n\n## GitHub Marketplace Webhookを作成する\n\nGitHub Marketplace で発行したアプリに関連するイベントをサブスクライブする Webhook を作成できます。 GitHub Marketplace Webhook を作成できるのは、アプリの所有者またはアプリ マネージャーのみです。\n\n1. ```\n [GitHub Marketplace 一覧ページ](https://github.com/marketplace/manage) に移動します。\n ```\n2. 表示したい Webhook 配信の GitHub Marketplace 一覧の横にある **\\[リストの管理]** をクリックします。\n3. サイドバーで、**\\[Webhook]** をクリックします。\n4. \\[ペイロード URL] の下に、ペイロードを受信する URL を入力します。\n5. 必要に応じて、 **\\[コンテンツ タイプ]** ドロップダウン メニューを選び、Webhook ペイロードを受信するデータ形式をクリックします。\n * **application/json**は、JSONペイロードを`POST`リクエストのボディとして直接配信します。\n * **application/x-www-form-urlencoded** は、JSON ペイロードを payload というフォーム パラメーターとして送信します。`payload`\n6. 必要に応じて、 \\[シークレット] フィールドの下に、 `secret`キーとして使用する文字列を入力します。 エントロピーの高いランダムな文字列を選択してください。 Webhook シークレットを使用して、GitHub から発信されたリクエストのみに受信を制限することができます。 詳しくは、「[Webhook 配信を検証する](/ja/webhooks/using-webhooks/securing-your-webhooks)」をご覧ください。\n7. 構成を追加した直後に Webhook をアクティブにするには、 **\\[アクティブ]** を選びます。\n8. ```\n **[Webhook の作成]** をクリックします。\n ```\n\n新しい Webhook を作成すると、GitHub から簡単な `ping` イベントが送信されて、Webhook が正しく設定されたことがわかります。 詳しくは、「[Webhook のイベントとペイロード](/ja/webhooks/webhook-events-and-payloads#ping)」をご覧ください。\n\n## GitHub Sponsors webhook を作成する\n\nスポンサーに関連するイベントに登録するWebhookを作成できます。 スポンサーされたアカウントのオーナーのみが、そのアカウントのスポンサー Webhook を作成できます。 スポンサー Webhook がサブスクライブしているイベントの詳細については、[`sponsorship`「Webhook イベント」](/ja/webhooks-and-events/webhooks/webhook-events-and-payloads#sponsorship)を参照してください。\n\n1. 任意のページで、右上隅にあるプロフィール画像をクリックし、次に **\\[Your sponsors]** をクリックします。\n2. Webhook を作成するアカウントの横にある **\\[ダッシュボード]** をクリックします。\n3. 左のサイドバーで、 **\\[Webhooks]** をクリックします。\n4. **\\[Webhook の追加]** を選択します。\n5. \\[ペイロード URL] の下に、ペイロードを受信する URL を入力します。\n6. 必要に応じて、 **\\[コンテンツ タイプ]** ドロップダウン メニューを選び、Webhook ペイロードを受信するデータ形式をクリックします。\n * **application/json**は、JSONペイロードを`POST`リクエストのボディとして直接配信します。\n * **application/x-www-form-urlencoded** は、JSON ペイロードを payload というフォーム パラメーターとして送信します。`payload`\n7. 必要に応じて、 \\[シークレット] フィールドの下に、 `secret`キーとして使用する文字列を入力します。 エントロピーの高いランダムな文字列を選択してください。 Webhook シークレットを使用して、GitHub から発信されたリクエストのみに受信を制限することができます。 詳しくは、「[Webhook 配信を検証する](/ja/webhooks/using-webhooks/securing-your-webhooks)」をご覧ください。\n8. 構成を追加した直後に Webhook をアクティブにするには、 **\\[アクティブ]** を選びます。\n9. ```\n **[Webhook の作成]** をクリックします。\n ```\n\n## GitHub App 用 Webhook を作成する\n\nGitHub App のオーナーは、アプリを Webhook イベントにサブスクライブして、特定のイベントが発生したときに通知を受け取ることができます。 アプリ所有者が GitHub App のアプリ マネージャーを指定している場合、アプリ マネージャーはアプリを Webhook イベントにサブスクライブさせることもできます。 詳しくは、「[GitHub Apps での Webhook の使用](/ja/apps/creating-github-apps/creating-github-apps/using-webhooks-with-github-apps)」をご覧ください。\n\nそれぞれの GitHub App には、一つの Webhook があります。 GitHub App を登録するときに webhook を構成することも、既存の GitHub App 登録の Webhook 構成を編集することもできます。\n\nGitHub App を登録するときに Webhook を構成する方法の詳細については、「[GitHub アプリの登録](/ja/apps/creating-github-apps/registering-a-github-app/registering-a-github-app)」を参照してください。\n\n既存の GitHub App 登録の Webhook を設定するには:\n\n1. GitHub の任意のページの右上隅にある、自分のプロフィール写真をクリックします。\n2. アカウント設定にアクセスしてください。\n * 個人用アカウントが所有するアプリの場合は、**\\[設定]** をクリックします。\n * 組織が所有するアプリの場合:\n 1. **\\[自分の組織]** をクリックします。\n 2. 組織の右側にある **\\[設定]** をクリックします。\n3. 左側のサイドバーの ** \\[Developer settings]** をクリックします。\n4. 左側のサイドバーで、 **\\[GitHub Apps]** をクリックします。\n5. Webhook を設定する GitHub App の横にある **\\[編集]** をクリックします。\n6. \\[Webhook] で **\\[アクティブ]** を選択します。\n7. \\[Webhook URL] にペイロードを受信する URL を入力します。\n8. 必要に応じて、 \\[Webhook シークレット] フィールドに `secret` キーとして使用する文字列を入力します。 エントロピーの高いランダムな文字列を選択してください。 Webhook シークレットを使って、着信する要求を GitHub から発信されたもののみに制限できます。 詳しくは、「[Webhook 配信を検証する](/ja/webhooks/using-webhooks/securing-your-webhooks)」をご覧ください。\n9. \\[ **変更の保存] をクリックします**。\n10. サイドバーで、**\\[アクセス許可とイベント]** をクリックします。\n11. GitHub App の登録で選択できる具体的な Webhook イベントは、アプリに対して選択したアクセス許可の種類によって決まります。 まず、アプリに付与するアクセス許可を選択する必要があります。これで、そのアクセス許可のセットに関連する Webhook イベントにアプリをサブスクライブできます。\n\n セクション \\[リポジトリのアクセス許可]、\\[組織のアクセス許可]、\\[アカウントのアクセス許可] で、アプリがサブスクライブするイベントに必要なアクセス許可を選びます。 詳しくは、「[GitHub アプリのアクセス許可の選択](/ja/apps/creating-github-apps/creating-github-apps/choosing-permissions-for-a-github-app)」をご覧ください。 アクセス許可を変更する際に考慮すべき事項の詳細については、「[GitHub App 登録の変更](/ja/apps/maintaining-github-apps/modifying-a-github-app-registration#changing-the-permissions-of-a-github-app)」を参照してください。\n12. \\[イベントにサブスクライブする] で、GitHub App で受け取りたい Webhook イベントを選びます。\n13. \\[ **変更の保存] をクリックします**。\n\nREST API を使用して、GitHub App の Webhook を作成することもできます。 詳しくは、「[GitHub App Webhook の REST API エンドポイント](/ja/rest/apps/webhooks)」をご覧ください。\n\n## 参考資料\n\n* [webhook について](/ja/webhooks/about-webhooks)\n* [webhookの配信処理](/ja/webhooks/using-webhooks/handling-webhook-deliveries)"}