2026/04/14 09:15

【Okta】NotionオートメーションのWebhookをOkta Workflowsで受けてコメント自動投稿する方法

はじめに

こんにちは、ネクストモード株式会社テクニカルサポート担当です。

先日以下の記事でNotionのデータベース機能とページレベルのアクセス権限を活用した簡易的な承認フローについてご紹介しました。

この記事の中でNotionデータベースのボタン操作の内容をコメントに自動反映する仕組みについて触れました。今日はOkta WorkflowsでNotion APIを実行する方法を解説します。

Notionオートメーション（データベースのボタン操作など）を起点にWebhookを送信する流れ
Okta WorkflowsのAPI EndpointトリガーでWebhookを受信し、ペイロードからページIDやpropertiesを取り出す方法
Okta Workflowsで取得した値から、Notion APIリクエスト用のHeaders（Notion-Version、Content-Type）を組み立てる方法
Notion APIのCreate comment（POST https://api.notion.com/v1/comments）を呼び出してページへコメント投稿する手順

以下のドキュメントを確認するとすべてのAPIリクエストにはヘッダーにNotion-Versionを含める必要があります。

今回は以下のCreate commentを利用します。記事執筆時点の最新バージョンは2026-03-11でしたので、Okta Workflowsの中でもこのバージョンを指定します。

Notion APIを呼び出すために、事前にNotionインテグレーションを作成してトークンを取得します。

Notionの設定から接続へ進みインテグレーションを作成または管理するへ進みます。もしくは https://www.notion.so/profile/integrations/internal へ進みます。
新しいインテグレーションを作成から以下のように作成し、表示される内部インテグレーションシークレットを控えます。
機能は最小限とするためコメントを挿入のみとしました。

作成したIntegrationは、コメントを投稿したいページ（またはページが含まれるデータベース）に招待して権限を付与する必要があります。

コンテンツへのアクセスから設定します。

Notion側でIntegrationを対象ページ/DBへ招待（アクセス権限付与）

権限が付与されていない場合、Okta Workflows側の設定が正しくてもNotion APIの呼び出しでエラー（401/403/404など）になることがあります。

最初にコネクションを作成します。

Okta Workflowsのコネクション作成（Authorization: Bearerシークレット）

全体図

API Endpoint（Trigger）
- NotionオートメーションからのWebhookを受信します。
- 送信されたペイロードから id や properties オブジェクトを後続処理で使います。
Get Multiple
- properties オブジェクトから必要な値を取り出します。
- 例：ステータス履歴.rich_text.0.plain_text
- ※「ステータス履歴」はNotion DBのプロパティ名に依存するため、環境に合わせて読み替えてください。
Construct（Headers）
- Notion API用のヘッダー（Notion-Version、Content-Type）を組み立てます。
Construct（Bodyの部品）
- コメント本文のベースとなる type と text.content を作成します。
List / Compose（rich_text）
- rich_text（リスト型）を作成します。
Construct（Body）
- parent.page_id と rich_text を指定してリクエストBodyを完成させます。
HTTP（POST）
- APIエンドポイント https://api.notion.com/v1/comments に、HeadersとBodyを指定してPOSTします。