Botpress StudioのNotion Integrationを使用すると、次のことが可能になります: ## バージョン `0.x` または `1.x` から `2.x` への移行 バージョン `2.0` のNotion Integration では OAuth のサポートが追加され、デフォルトの設定オプションになりました。 以前にNotion 開発者ポータルでNotion 統合を作成し、この統合を使い続けたい場合は、手動設定オプションを選択し、以下の手順に従ってください。 そうでない場合は、自動設定オプションを選択して認証ボタンをクリックし、画面の指示に従ってBotpress チャットボットをNotion接続してください。 ## 設定 ### OAuth による自動設定(推奨) これは統合を設定する最も簡単な方法です。OAuthを使用してNotion 統合を設定するには、認証ボタンをクリックし、画面の指示に従ってBotpress チャットボットをNotion接続します。この方法は、設定プロセスを簡素化し、チャットボットとNotion間の安全な通信を保証するため、推奨されます。 この設定モードを使用すると、Botpress Notion アプリケーションがNotion アカウントに接続するために使用されます。ボットによるアクションは、個人のNotion アカウントではなく、このアプリケーションに帰属します。 ### カスタムNotion インテグレーションによる手動設定 #### ステップ 1 - インテグレーションを作成する Notion インテグレーションを作成する [インテグレーションの作成 -Notion Developers]notion #### ステップ 2 -Notion アセットにアクセス権を与える Botpress で使用したいすべてのページとデータベースへのアクセス権を統合に与えます。Botpress #### ステップ3 - Botを設定する Botpress使用するすべてのページとデータベースにアクセスできるようにします。[インテグレーションとデータベースを共有する -Notion Developers]notion 新しく作成したNotion Integration _(Botpress StudioのNotion Integrationとは異なります)_をBotpress Studioに接続するにはトークンが必要です: - Auth Token` - このトークンは、`https://www.notion.so/mynotion下にあるインテグレーションをクリックすると表示されます。インテグレーションをクリックしたら、"秘密 "セクションに行き、"内部インテグレーション秘密 "フィールドを見つけます。表示」をクリックし、「コピー」をクリックします。ボットの "Integrations "タブにあるNotion 統合の "Auth Token "フィールドに、コピーしたトークンを貼り付けます。 これで、インテグレーションを有効にするだけで、Notionボットの機能を拡張することができます。 ## 利用方法 以下の操作では、ボットが扱うNotion エンティティの ID を知っている必要があります。すべてのnotion エンティティ(ページ、データベースなど)にはidがあり、ブラウザでNotion アカウントにアクセスするか、(...)メニューの "Copy Link "アイテムをクリックしてリンクを取得すると、URLにidが表示されます。詳しくは[データベース ID の取得 -Notion Developers]notionをご覧ください。 ### ディスカッションにコメントを追加する このアクションでは、既存のディスカッションにコメントを追加できます。コメントへの返信に使用します。 ### ページにコメントを追加する このアクションでページレベルのコメントを追加できます。 ### データベースを取得する データベースの詳細を取得できます。これは `Add Page to a Database` アクションと一緒に使うのが理想的です。Notion API からのレスポンス ([Retreive a Database -Notion Developers]notion) に加えて、このアクションは最適化された `structure` プロパティ (技術的には型宣言) を返します。このプロパティは AI タスクの入力として使用することができ、ユーザーの入力に基づいてNotion データベースにページを追加または更新するためのペイロードを生成するように指示することができます。 ### データベースへのページの追加 このアクションは、[AIタスク]botpressにペイロードを生成するように指示するために使用できるデータベースの構造を返す`Get a Database`と同時に使用するのが理想的です。詳しくは[Working with Databases -Notion Developers]notionを参照してください。 ### ブロックの削除 以下のエンティティを削除できます: - データベース内のページ - ページ - ブロック