メインコンテンツへスキップ
設定 → 通知 で送信先を追加すると、ワークスペースのアラートをメール、Slack、Discord、Microsoft Teams、または独自の HTTPS Webhook に送信できます。送信先はワークスペースに属し、使い始める前にテストを送信できます。 認証情報と Webhook の URL は保存前に暗号化されます。チャンネルの認証情報は通知の配信だけに使い、漏えいした場合はローテーションしてください。

送信先を追加する

1

作成する

設定 → 通知 を開き、送信先を追加 を選択して名前を入力し、1 つ以上のチャンネルを選びます。送信先の詳細と、必要に応じてメンションを追加します。
2

各チャンネルをテストする

各チャンネルで テストを送信 を選択し、すべてのテストが成功したら送信先を作成します。
3

署名シークレットを保存する

カスタム Webhook には作成時に署名シークレットが発行されます。表示されるダイアログからコピーしてください。表示されるのは一度だけです。
スクリプトからは、管理キーを使って POST /v1/notifications/destinations で作成し、POST /v1/notifications/destinations/{id}/test で確認してから、PUT /v1/notifications/routes/{eventKind} で受け取るアラートを選びます。 メンションは控えめに使ってください。量の多いアラートは、広いグループに通知するより、監視されているチャンネルに送ってください。

製品アラートを有効にする

通知ページには、ワークスペースで利用できるアラートの種類が表示されます。送信先には、ダッシュボードに表示される組み込みの受信者に加えてアラートが届きます。 モデル非推奨アラート は、ワークスペースで使用中のモデルが提供終了になる前に通知します。 代替モデルの通知 は、提供終了モデルのルーティングが有効で、どのプロバイダーも提供しなくなったモデルへのワークスペースのリクエストに代替モデルが応答したときに送信されます。通知はモデルと代替モデルの組み合わせごとに 1 回、代替モデルが初めて正常に応答したときに送信されます。ワークスペースのオーナーには常にメールが届きます。チームにも通知を送るには、送信先を選択してください。

支出レポート

ワークスペースのオーナーには、毎週月曜 09:00(ワークスペースの請求タイムゾーン)に、前週の月曜〜日曜の支出レポートがメールで届きます。通知ページの 支出アラート → ワークスペースの支出設定 で、毎日(09:00 に前日分)、毎週、毎月(1 日に前月分)、オフから選べます。管理者にも送るかどうかも設定できます。支出のない期間は送信されません。 各レポートには、支出と前の期間からの変化、上位のキー・モデル・メンバー・部署、今月の予測、残高の持続日数、期間中の支出アラートとブロックが含まれます。受信者はメール内のリンクから配信を停止できます。停止されるのは、そのワークスペースのレポートのうち本人宛てのものだけです。支出レポート にルーティングされた送信先には、レポートごとに 1 件の要約が届きます。 同じ設定は通知設定 API の spend.report_cadence と spend.report_include_admins です。 支出、予算、予測、急増、残高不足のアラートと、支出が上限を超えたときのリクエストのブロックについては、支出アラートを参照してください。
支出レポートのメールは段階的に提供を開始しています。有効になるまでは、選択内容は保存されますがレポートは送信されません。

送信先を機能させ続ける

認証情報をローテーションした後やチャンネルを変更した後は、既存の送信先の横にある テストを送信 を使います。誰も監視していない送信先は削除してください。放置されたチャンネルに届いたアラートが、配信済みに見えてしまうのを防げます。 カスタム Webhook の受信側は、各リクエストを処理する前に検証し、速やかに成功レスポンスを返して、時間のかかる処理はバックグラウンドジョブに移してください。

Webhook の署名を検証する

Phaseo は、保存済みの送信先から送るテストを含め、すべてのカスタム Webhook 配信に動画とバッチの Webhook と同じ方式で署名します。各リクエストには次のヘッダーが含まれます。
x-phaseo-signature は、x-phaseo-timestamp の値、ドット(.)、変更されていないリクエストボディを連結し、送信先の署名シークレット(whsec_…)をキーにして計算した HMAC-SHA256 の 16 進文字列です。x-phaseo-timestamp は Unix 秒です。 配信を検証するには、次のようにします。
  1. JSON として解析する前に、生のボディを読み取ります。
  2. 署名を再計算し、定数時間で比較します。
  3. 自分の時計と 5 分以上ずれたタイムスタンプは拒否します。
  4. x-phaseo-event-id で重複を除外します。失敗した配信は再試行され、試行ごとに新しいタイムスタンプで署名し直されます。

シークレットを生成またはローテーションする

シークレットは送信先の作成時に一度だけ表示されます。置き換えるには、設定 → 通知 で送信先の横にある シークレットをローテーション を選ぶか、POST /v1/notifications/destinations/{id}/rotate-secret を呼び出します。次の配信から新しいシークレットで署名され、古いシークレットは使えなくなるため、すぐに受信側を更新してください。 署名機能の導入前に作成されたカスタム Webhook にはシークレットがなく、引き続き署名なしで配信されます。設定では 署名なし と表示されます。シークレットを生成 を選び、受信側にシークレットを設定してから、テストを送信して検証を確認してください。送信先を追加 のシートから保存前に送信したテストは、まだシークレットがないため署名されません。 メール、Slack、Discord、Microsoft Teams の送信先は署名されません。これらのサービスは Webhook の URL やボットトークンを自ら認証します。
最終更新日 2026年11月7日