通知を設定する

通知を受信する GitHub のアクティビティのタイプと、これらの更新の配信方法を選択します。

この記事の内容

通知配信オプション

GitHub のアクティビティに関する通知は、次の場所で受け取ることができます。

  • GitHub Web インターフェイスの通知受信トレイ
  • Web インターフェイスの受信トレイと同期される、GitHub Mobile の通知受信トレイ
  • 認証済みのメール アドレスを使用し、Web インターフェースの通知受信箱および GitHub Mobile と同期できるメールクライアント

GitHub及びGitHub Mobile上で通知インボックスを使うには、通知設定でWeb及びモバイル通知を有効化しなければなりません。詳細については、「通知設定を選択する」を参照してください。

Tip

Web とメールの両方で通知を受け取る場合、通知の既読または未読状態を自動的に同期して、対応するメール通知を読んだら自動的に Web 通知が既読としてマークされるようにできます。 この同期を有効にするには、お使いのメール クライアントでnotifications@github.comの画像を表示できる必要があります。

通知インボックスの利点

通知受信トレイには、次のオプションを含む、GitHub 通知フロー用に特別に設計されたトリアージ オプションが含まれています。

  • 複数の通知を一度にトリアージする。
  • 完了した通知を [完了] としてマークし、インボックスから削除する。 [完了] とマークされているすべての通知を表示するには、is:done クエリを使います。
  • 後で確認するために通知を保存する。 保存した通知にはインボックスでフラグが設定され、無期限に保持されます。 保存したすべての通知を表示するには、is:saved クエリを使います。
  • 通知のサブスクライブを解除し、インボックスから削除する。
  • 通知受信トレイ内で、GitHub で発生した issue または pull request をプレビューする。
  • reasons ラベルを使って、インボックスから通知を受信する最新の理由の 1 つを表示する。
  • 必要に応じて、さまざまな通知に焦点を当てるカスタム フィルターを作成する。
  • リポジトリまたは日付によってインボックス内の通知をグループ化して、概要を簡単に把握し、コンテキスト切り替えを軽減する。

さらに、GitHub Mobile を使用して、モバイル デバイスで通知を受信およびトリアージすることもできます。 詳細については、「GitHub Mobile で通知設定を管理する」または「GitHub Mobile」を参照してください。

通知にメールクライアントを使用する利点

メールクライアントを使用する利点の 1 つは、メールクライアントのストレージ容量に応じて、すべての通知を無期限に保持できることです。 受信トレイの通知は、保存済みとしてマークしていない限り、GitHub に対して 5 か月間のみ保持 されます。 保存済の通知は、無期限に保持されます。 インボックスのアイテム保持ポリシーの詳細については、「通知について」を参照してください。

メールクライアントに通知を送信すると、メールクライアントの設定に従ってインボックスをカスタマイズすることもできます。これには、カスタムラベルまたは色分けされたラベルを含めることができます。

メール通知では、受信する各種通知に柔軟に対応し、更新用にさまざまなメールアドレスを選択できます。 たとえば、リポジトリの特定の通知を検証済みの個人のメールアドレスに送信できます。 メールのカスタマイズ オプションの詳細については、「メール通知をカスタマイズする」を参照してください。

参加と Watch 対象の通知について

リポジトリの Watch 時は、そのリポジトリでのアクティビティの更新をサブスクライブしています。

自分が Watch しているリポジトリを表示するには、Watch ページにアクセスします。 詳しくは、「GitHub におけるアクティビティのサブスクリプションを管理する」をご覧ください。

リポジトリに関する通知は、リポジトリ ページまたは Watch ページで設定できます。

カスタム通知について

リポジトリの通知はカスタマイズできます。 たとえば、リポジトリ内で複数のタイプのイベント (issue、pull request、リリース、セキュリティ アラート、またはディスカッション) の更新が発生した場合にのみ通知を受け取るか、リポジトリのすべての通知を無視するかを選択できます。 詳細については、後述の「個々のリポジトリの Watch 設定を行う」を参照してください。

会話への参加

会話にコメントしたり、あなたのユーザー名が @mentions されたりすると、会話に 参加 することになります。 デフォルトでは、会話に参加すると、会話に自動的にサブスクライブされます。 手動で参加した会話をサブスクライブ解除するには、Issue または Pull Request で [サブスクライブ解除] をクリックするか、通知インボックスの [サブスクライブ解除] オプションを使用します。

Watch 中または参加中の会話については、通知設定で GitHub またはメールで通知を受信するかを選ぶことができます。 詳細については、「通知設定を選択する」を参照してください。

たとえば、[通知の設定] ページで次のようにします。

  • メールで通知を受け取らない場合は、参加中とウォッチ中の通知で [電子メール] をオフにします。
  • 会話に参加したときにメールで通知を受け取る場合は、[参加中] の [電子メール] をオンにします。

Watch または参加通知に対して [通知する: GitHub で] を有効にしない場合、通知受信トレイは更新されません。

メール通知をカスタマイズする

メール通知を有効化すると、GitHub はコンテンツを HTML とプレーン テキストの両方で含むマルチパートのメールとして通知を送信します。 メール通知のコンテンツには、GitHub のオリジナルのコンテンツに含まれる Markdown、@mentions、絵文字、ハッシュリンクなどがすべて含まれます。 メールでテキストだけを見たいなら、プレーンテキストのコピーだけを表示するようにメールクライアントを設定できます。

Tip

Web とメールの両方で通知を受け取る場合、通知の既読または未読状態を自動的に同期して、対応するメール通知を読んだら自動的に Web 通知が既読としてマークされるようにできます。 この同期を有効にするには、お使いのメール クライアントでnotifications@github.comの画像を表示できる必要があります。

Gmailを使っているなら、通知メールの横にあるボタンをクリックして、通知を生成したオリジナルのIssueあるいはプルリクエストにアクセスできます。

参加中または Watch 中の会話の更新を送信するデフォルトのメールアドレスを選択します。 また、既定のメール アドレスの用途として、GitHub のどのアクティビティの更新を受信するかを指定することもできます。 たとえば、次の場所からの更新をデフォルトのメールに送信するかどうかを選択します。

  • Issue や pull request へのコメント
  • プルリクエストのレビュー
  • Pull request のプッシュ
  • Issue や pull request のオープン、コメント、クローズなどの、自分自身の操作による更新

リポジトリを所有する Organization に応じて、さまざまなメールアドレスに通知を送信することもできます。 Organization では、特定のドメインのメールアドレスを検証する必要がある場合があります。 詳しくは、「通知を設定する」をご覧ください。

特定のリポジトリの通知をメールアドレスに送信することもできます。 詳しくは、「リポジトリへのプッシュに対するメール通知について」をご覧ください。

通知メールを受信するのは、通知設定でメール通知を選択している場合のみです。

あなたがメンバーになっているOrganizationがメール通知を承認されたメールドメインに制限しているなら、メールアドレスを検証して、そのドメインでOrganization内のアクティビティに関するメール通知を受けるようにしなければなりません。 詳しくは、「Organizationのメール通知の制限」を参照してください。

メール通知のフィルタリング

GitHub が送信する各メール通知には、ヘッダー情報が含まれています。 各メールのヘッダー情報には一貫性があるので、それを使ってメール クライアントですべての GitHub 通知あるいは特定の種類の GitHub 通知をフィルタリングしたりフォワードしたりできます。

自分に属していない通知を受け取っていると思われる場合は、その X-GitHub-Recipient ヘッダーと X-GitHub-Recipient-Address ヘッダーを調べます。 これらのヘッダは、対象の受信者を示しています。 メールの設定によっては、別のユーザ向けの通知を受け取る場合があります。

ヘッダー情報は、GitHub からのメール通知に含まれています。

Header情報
From アドレスこのアドレスは常に、notifications@github.com または notifications@SUBDOMAIN.ghe.com になります。
To のフィールドこのフィールドはスレッドに直接接続します。 メールに返信すると、会話に新しいコメントが追加されます。
Cc アドレスあなたが会話をサブスクライブしていれば、GitHub Enterprise Cloud はあなたに Cc します。 2 番目の Cc メール アドレスは、通知の理由にマッチします。 これらの通知理由のサフィックスは、@noreply.github.com または @noreply.SUBDOMAIN.ghe.com になります。 通知の理由には以下のようなものがあります。
  • assign: あなたに Issue または Pull Request が割り当てられた。
  • author: あなたが Issue または Pull Request を作成した。
  • ci_activity: あなたがトリガーした GitHub Actions ワークフローの実行が完了した。
  • comment: Issue または Pull Request にあなたがコメントした。
  • manual: あなたが手動でサブスクライブした Issue または Pull Request が更新された。
  • mention: Issue または Pull Request についてあなたがメンションされた。
  • push: あなたがサブスクライブしている Pull Request に誰かがコミットした。
  • review_requested: あなた、またはあなたがメンバーになっている Team が Pull Request のレビューをリクエストされた。
  • security_alert: GitHub で、あなたがアラート受信者になっているリポジトリに脆弱性が検出された。
  • state_change: あなたがサブスクライブしている Issue または Pull Request がクローズまたはオープンされた。
  • subscribed: あなたが Watch しているリポジトリに更新があった。
  • team_mention: あなたが属している Team が、Issue または Pull Request についてメンションされた。
  • your_activity: あなたが Issue または Pull Request をオープン、コメントまたはクローズした。
List-Id のフィールドこのフィールドはリポジトリの名前とそのオーナーを特定します。 このアドレスの形式は常に OWNER/REPOSITORY <REPOSITORY.OWNER> となり、例としては List-Id: grain-lang/grain <grain.grain-lang.github.com> となります。
X-GitHub-Severity のフィールド1 つ以上のリポジトリに影響する Dependabot alerts のメール通知には、X-GitHub-Severity ヘッダー フィールドが含まれます。 X-GitHub-Severity ヘッダー フィールドの値を使用して、Dependabot alerts のメール通知をフィルター処理できます。 考えられる重大度レベルは次のとおりです。
  • low
  • moderate
  • high
  • critical
詳しくは、「Dependabot アラートについて」をご覧ください。

メール通知への返信

GitHub Enterprise Cloud からメール通知に返信すると、返信が issue、pull request、またはディスカッションに投稿されます。

各メール通知の reply-to アドレスにより、スレッドとコメントの投稿元アカウントが特定されます。 このメール アドレスは、パスワードをリセットするまで有効なままです。

GitHub Enterprise Cloud は、常に完全なメール コンテンツを含むとは限らず、メールの返信を介して作成されたコメントから個人情報を削除しようとします。

  • octocat@github.com などの標準形式のメール アドレスは、***@***.*** に変換されます。
  • メール クライアントが > を使用してこれらのセクションをマークした場合、署名と引用符で囲まれた応答チェーンは削除されます。
  • メール通知の登録解除リンクが引用符で囲まれる場合もありますが、リンクはアカウントにサインインしている場合にのみ機能します。
  • 作成されたコメントには、メールの添付ファイルは含まれません。
  • メールの返信で作成されるコメントの最大長は 65,530 文字です。

通知設定を選択する

  1. 任意のページの右上隅で をクリックします。

    GitHub のヘッダーの右隅のスクリーンショット。 受信トレイ アイコンには、未読の通知があることを示す青い点があります。

  2. 左側のサイドバーの、リポジトリ リストの下にある [通知の管理] ドロップダウンを使用して、 [通知設定] をクリックします。

    [通知] ページのスクリーンショット。 [通知の管理] というタイトルのドロップダウン メニューが、オレンジ色の枠線で強調されています。

  3. 通知設定ページで、次の場合の通知の受信方法を選択します。

    • Watch しているリポジトリ、または参加している会話に更新がある場合。 詳細については、「参加と Watch 対象の通知について」を参照してください。
    • 新しいリポジトリにアクセスするか、新しい Team に参加した場合。 詳細については、「自動 Watch」を参照してください。
    • リポジトリには新しい Dependabot alerts があります。 詳細については、「Dependabot alerts の通知オプション」を参照してください。
    • GitHub Actions で設定されたリポジトリにワークフロー実行の更新がある場合。 詳細については、「GitHub Actions の通知オプション」を参照してください。
    • あなたが所有者である Organization に属するリポジトリに、新しいデプロイ キーが追加された場合。 詳細については、「Organization アラートの通知オプション」を参照してください。

自動 Watch

デフォルトでは、新しいリポジトリにアクセスすると、そのリポジトリの Watch が自動的に開始されます。 新しいチームに参加するたびに、更新が自動的にサブスクライブされ、その Team が @mentioned されたときに通知を受け取ります。 自動でサブスクライブしない場合は、通知設定で自動 Watch オプションの選択を解除できます。

[Automatically watch repositories] (リポジトリを自動的に監視する) と [Automatically watch teams] (チームを自動的に監視する) のトグルのスクリーンショット。

「リポジトリを自動的に Watch する」が無効になっている場合、自分のリポジトリを自動的に Watch することはありません。 リポジトリページに移動して、Watch オプションを選択する必要があります。

詳しくは、「通知を設定する」をご覧ください。

個々のリポジトリの Watch 設定を行う

リポジトリごとに Watch するどうかを選択できます。 issue、pull request、リリース、セキュリティ アラート、またはディスカッション (リポジトリで有効になっている場合) など、特定のイベントの種類のみについて通知するように選択したり、個々のリポジトリを完全に無視したりすることもできます。

  1. GitHub で、リポジトリのメイン ページに移動します。

  2. 右上隅の [ウォッチ] ドロップダウン メニューを選んで、ウォッチ オプションをクリックします。

    通知をさらにカスタマイズする場合は、 [カスタム] をクリックし、参加と @mentions に加えて、通知を受け取る特定のイベント (issue や pull requests など) を選びます。

    たとえば、[Issue] を選ぶと、リポジトリ内のすべての issue (このオプションを選ぶ前からあった issue を含む) についての更新の通知を受け取り、それに登録されます。 このリポジトリの Pull Request で @mentioned されている場合は、その通知も受信し、Issue についての通知に加えて、その特定の Pull Request の更新をサブスクライブします。

Organization のメール通知の送信先を選択する

Organization に所属している場合、Organization のアクティビティに関する通知の送信先にするメールアカウントを指定できます。 たとえば、職場の Organization に所属している場合、通知を個人のアドレスではなく、職場のアドレスに送信する方が良いでしょう。

通知メールを受信するのは、通知設定でメール通知を選択している場合のみです。

あなたがメンバーになっているOrganizationがメール通知を承認されたメールドメインに制限しているなら、メールアドレスを検証して、そのドメインでOrganization内のアクティビティに関するメール通知を受けるようにしなければなりません。 詳しくは、「Organizationのメール通知の制限」を参照してください。

  1. 任意のページの右上隅で をクリックします。

    GitHub のヘッダーの右隅のスクリーンショット。 受信トレイ アイコンには、未読の通知があることを示す青い点があります。

  2. 左側のサイドバーの、リポジトリ リストの下にある [通知の管理] ドロップダウンを使用して、 [通知設定] をクリックします。

    [通知] ページのスクリーンショット。 [通知の管理] というタイトルのドロップダウン メニューが、オレンジ色の枠線で強調されています。

  3. [既定の通知メール] で、通知の送信先にするメールアドレスを選びます。

Organization ごとにメールの送信先を設定する

2 つ以上の Organization のメンバーになっている場合は、各 Organization で、通知が自分の検証済みメール アドレスに送信されるよう設定できます。 詳細については、「メールアドレスを検証する」を参照してください。

  1. 任意のページの右上隅で をクリックします。

    GitHub のヘッダーの右隅のスクリーンショット。 受信トレイ アイコンには、未読の通知があることを示す青い点があります。

  2. 左側のサイドバーの、リポジトリ リストの下にある [通知の管理] ドロップダウンを使用して、 [通知設定] をクリックします。

    [通知] ページのスクリーンショット。 [通知の管理] というタイトルのドロップダウン メニューが、オレンジ色の枠線で強調されています。

  3. [既定の通知メール] で、 [カスタム ルーティング] をクリックします。

    [既定の通知メール] セクションのスクリーンショット。 [カスタム ルーティング] というタイトルのボタンがオレンジ色の枠線で強調表示されています。

  4. [新しいルートの追加] をクリックします。

  5. [Organization の選択] を選び、カスタマイズする Organization をクリックします。

  6. 検証済みメール アドレスのうち 1 つを選択し、 [保存] をクリックします。

    [カスタム ルーティング] ページのスクリーンショット。 ユーザーが使用可能なメール アドレスを示すドロップダウン メニューがオレンジ色の枠線で強調表示されています。

Dependabot alerts の通知オプション

ユーザー アカウントの通知オプションは、https://github.com/settings/notifications にあります。 各リポジトリの通知設定は、リポジトリの Watch 設定で構成できます。

リポジトリの Dependabot alerts に関する通知を受け取るには、これらのリポジトリを監視し、"すべてのアクティビティ" 通知を受け取るようにサブスクライブするか、"セキュリティ アラート" を含めるようにカスタム設定を構成する必要があります。 詳しくは、「通知を設定する」を参照してください。 通知の配信方法と、通知が送信される頻度を選択できます。 既定では、通知が届きます。

  • インボックスで、Web 通知として。 Web 通知は、Dependabot がリポジトリで有効にされていて、新しいマニフェスト ファイルがリポジトリにコミットされたときに、重要度が重大または高の新しい脆弱性が見つかった場合に送信されます ( [GitHub 上] オプション)。
  • メールで。 メールは、Dependabot がリポジトリで有効にされており、新しいマニフェスト ファイルがリポジトリにコミットされたときに重要度が重大または高の新しい脆弱性が見つかった場合に送信されます ([Email] オプション)。
  • コマンド ラインで。 安全ではない依存関係があるリポジトリにプッシュを行うと、コールバックとして警告が表示されます ([CLI] オプション)。
  • GitHub Mobile では、Web 通知として表示されます。 詳しくは、「通知を設定する」を参照してください。

Note

メールと Web および GitHub Mobile の通知は次のとおりです。

  • Dependabot がリポジトリで有効にされているとき、または新しいマニフェスト ファイルがリポジトリにコミットされたときは、"リポジトリごと"。
  • 新しい脆弱性が検出されたときは、"組織ごと"。
  • 新しい脆弱性が検出されたときに送信されます。 脆弱性が更新されたときには、GitHub は通知を送信しません。

Dependabot alertsに関する通知を受け取る方法をカスタマイズできます。 たとえば、 [週単位のメール ダイジェスト] オプションを使用すると、最大 10 個のリポジトリについてアラートを要約した週単位のダイジェスト メールを受け取ることができます。

利用可能な通知の配信方法の詳細と、Dependabot alerts の通知を最適化するためのアドバイスについては、「Dependabot アラートの通知を構成する」を参照してください。

Secret scanning 通知オプション

新しいシークレットが検出されると GitHub Enterprise Cloud によって、通知設定に従ってリポジトリのセキュリティ アラートにアクセスできるすべてのユーザーに通知されます。 これらのユーザーは次のとおりです。

  • リポジトリ管理者
  • セキュリティマネージャー
  • 読み書きアクセス権が与えられるカスタム ロールを持つユーザー
  • Organization 所有者とエンタープライズ所有者。シークレットが漏洩したリポジトリの管理者である場合

Note

シークレットを誤ってコミットしてしまったコミット作成者には、通知の基本設定に関係なく通知が行われます。

次の場合に、電子メール通知を受け取ります。

  • リポジトリをウォッチしている。
  • リポジトリ で [すべてのアクティビティ]、またはカスタムの [セキュリティ アラート] の通知を有効にしている。
  • 通知設定にある [サブスクリプション] の [ウォッチ] で、電子メールによる通知を受け取ることを選んだ。

シークレット スキャンニング アラート の通知を構成する方法の詳細については、「シークレット スキャンからのアラートの監視」を参照してください。

GitHub Actions の通知オプション

GitHub Actions で設定されており、確認中のリポジトリについては、ワークフロー実行更新を受信する方法を選べます。

  1. [通知設定] ページの [システム] で、[アクション] の下にある [通知しない] ドロップダウン メニューを選びます。

    通知設定の [システム] セクションのスクリーンショット。 [アクション] の下に、[通知しない] というタイトルのドロップダウン メニューがオレンジ色の枠線で強調表示されています。

  2. Web 通知をオプトインするには、ドロップダウン メニューから [GitHub で] を選択します。

    メール通知をオプトインするには、ドロップダウン メニューから [メール] を選択します。

  3. または、失敗したワークフロー実行についての通知のみ受信する場合は、[失敗したワークフローについてのみ通知する] を選び、 [保存] をクリックします。

組織アラートの通知オプション

Organization の所有者は、Organization のメンバーが Organization 内のリポジトリに新しいデプロイ キーを追加すると、既定で電子メール通知を受け取ります。 これらの通知はいつでもサブスクライブ解除できます。 通知設定ページの「組織アラート」で、「電子メール」の選択を解除します。

GitHub Mobile で通知設定を管理する

GitHub Mobile をインストールすると、自動的に Web 通知が有効になります。 アプリケーション内で、次のイベントのプッシュ通知を有効にできます。

  • ダイレクトメンション
  • Issue またはプルリクエストへの割り当て
  • プルリクエストのレビューをリクエスト
  • デプロイメントの承認をリクエスト

GitHub Mobile がモバイルデバイスにプッシュ通知を送信するタイミングをスケジュール設定することもできます。

GitHub Enterprise Server では、プッシュ通知をサポートするためにバックグラウンド フェッチを使用するので、プッシュ通知の受信に遅延が生じることがあります。

GitHub for iOS

で通知設定を管理する

  1. 下部のメニューで、 [プロファイル] をタップします。
  2. 設定を表示するには、 をタップします。
  3. 通知設定を更新するには、 [通知] をタップしてから、トグルを使用して、好みの種類のプッシュ通知を有効または無効にします。
  4. オプションで、GitHub Mobile がモバイル デバイスにプッシュ通知を送信するタイミングをスケジュールするには、 Working Hours をタップし、 Custom working hours トグルを使用して、プッシュ通知を受信するタイミングを選択します。

GitHub for Android

で通知設定を管理する

  1. 下部のメニューで、 [プロファイル] をタップします。
  2. 設定を表示するには、 をタップします。
  3. 通知設定を更新するには、 [通知の構成] をタップしてから、トグルを使用して、好みの種類のプッシュ通知を有効または無効にします。
  4. オプションで、GitHub Mobile がモバイル デバイスにプッシュ通知を送信するタイミングをスケジュールするには、 Working Hours をタップし、 Custom working hours トグルを使用して、プッシュ通知を受信するタイミングを選択します。

GitHub Mobile を使用して個々のリポジトリの Watch 設定をする

リポジトリごとに Watch するどうかを選択できます。 また、Issue、Pull Request、ディスカッション (リポジトリで有効になっている場合) などの特定のイベント タイプと新しいリリースのみを通知したり、個々のリポジトリを完全に無視したりすることもできます。

  1. GitHub Mobile で、リポジトリのメイン ページに移動します。
  2. [Watch] をタップします。
  3. 通知を受け取るアクティビティを選択するには、目的の Watch 設定をタップします。 たとえば、参加しているか @mentioned の場合にのみ通知を受け取ること、または [カスタム] オプションを使って通知を受け取る特定のイベントを選ぶことができます。