メインコンテンツまでスキップ

通知設定

Takumi から診断完了時に通知を受け取ることができます。

通知先​

以下 3 種類を指定可能です。

  • Slack チャンネル:連携済み Slack のチャンネル。連携方法は「Slack を連携する」を参照してください。
  • メールアドレス:組織のメンバーのメールアドレス、または組織のメール許可リストのアドレス。
  • Webhook:組織に登録済みの Webhook URL。登録方法は「Webhook エンドポイントをセットアップする」を参照してください。

設定方法​

  • 診断中の待機画面:診断開始後に表示される画面から設定できます。

    「通知を受け取る」の Slack・メール・Webhook ボタン

  • 定期診断:定期診断の設定画面の「通知先」で設定できます。以後、当該定期診断で作成されるすべての診断に適用されます。

    定期診断の設定画面の「通知先」

Webhook の形式​

Webhook を指定した場合に送信されるデータの形式は以下のとおりです。その他の共通の仕様については「Webhook 通知」を参照してください。

フィールド説明
assessment_id診断の ID
assessment_name診断の名前
statusイベント後の診断のステータス。CRAWLED(クロール済)・COMPLETED(診断済)・PENDING(診断再開待ち)のいずれかです。
urlコンソール上の診断ページの URL
finding_counts深刻度ごとの検出件数です。critical・high・medium・low・none の 5 つで、assessment.completed と assessment.pending に含まれます。

assessment.completed の例:

{
"type": "assessment.completed",
"timestamp": "2026-10-27T03:00:00Z",
"data": {
"assessment_id": "AS01J...",
"assessment_name": "flatt.tech の週次診断",
"status": "COMPLETED",
"url": "https://cloud.shisho.dev/{org_id}/assessments/AS01J...",
"finding_counts": {
"critical": 1,
"high": 2,
"medium": 0,
"low": 1,
"none": 0
}
}
}

assessment.pending の例:

{
"type": "assessment.pending",
"timestamp": "2026-10-27T03:00:00Z",
"data": {
"assessment_id": "AS01J...",
"assessment_name": "flatt.tech の週次診断",
"status": "PENDING",
"url": "https://cloud.shisho.dev/{org_id}/assessments/AS01J...",
"finding_counts": {
"critical": 1,
"high": 2,
"medium": 0,
"low": 1,
"none": 0
}
}
}

assessment.crawled の例:

{
"type": "assessment.crawled",
"timestamp": "2026-10-27T03:00:00Z",
"data": {
"assessment_id": "AS01J...",
"assessment_name": "flatt.tech の週次診断",
"status": "CRAWLED",
"url": "https://cloud.shisho.dev/{org_id}/assessments/AS01J..."
}
}