外部アクションをアクションフローで使用するには、アクションビルダーを外部システムへ接続する必要があります。

現在のプランを確認
Suite、すべてのバージョン Team、Growth、Professional、EnterpriseまたはEnterprise Plus
Support Team、ProfessionalまたはEnterprise

要約：◀▼

アクションフローをNotionに連携させることで、ページの作成、更新、検索、コメントの追加、コンテンツブロックの挿入といったタスクを自動化できます。コネクションには専用のサービスアカウントを使用し、権限を慎重に確認してください。これらのアクションにより、複数のプラットフォームにまたがるワークフローを連携させ、サポートプロセスにおけるコラボレーションとコンテンツ管理を改善できます。

アクションビルダーをNotionなどの外部システムに接続すると、管理者は自動化されたワークフロー内でZendeskと外部システムを連携させ、コラボレーションを強化し、複数のプラットフォームにわたってシームレスなエクスペリエンスを維持できます。
メモ：アクションフロー内の外部システムに関わるステップは、総称して「外部アクション」と呼ばれます。
この記事では、以下のトピックについて説明します。
  • アクションビルダーをNotionに接続する
  • アクションフローでのNotionアクションの使い方

アクションビルダーをNotionに接続する

外部アクションをアクションフローで使用するには、アクションビルダーを外部システムへ接続する必要があります。

外部システムに接続してアクションフローで外部アクションを使用する場合は、以下のベストプラクティスをお勧めします。
  • アクションフローによって実行される外部アクションは、すべて外部システムを接続したユーザーに帰属します。したがって、各外部システムに接続する場合、個人の資格情報ではなく専用のサービスアカウントを使用することが推奨されます。
  • すべてのインテグレーションでは、必要なスコープへのアクセスが要求されます。ただし、外部システムへの接続を承認する前に、スコープを確認し、妥当性を検証することが重要です。
  • OpenAIなどのAPIキーベースのツールの認証情報を管理する場合は、キーを安全な保管庫または認証情報マネージャーに保存することをお勧めします。
アクションビルダーをNotionに接続するには
  1. 管理センターで、サイドバーにある「 アプリおよびインテグレーション」をクリックし、「アクション」>「アクションフロー」を選択します。
  2. アクションフローを新規作成するか、既存のアクションフローを編集します。
  3. ステップサイドバーを開きます。
  4. 「外部アクション」セクションで、「Notion」をクリックします。
  5. 「接続」をクリックします。
  6. Notionの指示に従って認証を行い、接続を完了します。

    コネクションを承認するとNotionにリダイレクトされ、Zendeskアカウントに必要な権限を付与するよう求められます。

    Notionコネクションは、OAuth 2.0の認証コードグラント方式を使用しています。コネクションを承認する前に、権限を慎重に確認してください。これらの権限により、アクションフローは、ユーザーに代わってNotionワークスペース内のページの作成と変更、コメントの追加、データベース項目の管理、コンテンツの更新を行えるようになります。

    メモ：アクションフローによって実行される外部アクションは、すべて外部システムを接続したユーザーに帰属します。したがって、各外部システムに接続する場合、個人の資格情報ではなく専用のサービスアカウントを使用することが推奨されます。

接続が完了すると、接続していることを示すインジケーター、接続したインスタンスの詳細情報、およびNotionで利用可能なアクションが表示されます。

アクションフローでのNotionアクションの使い方

以下のNotionアクションを使用できます。
  • ページを作成
  • ページを更新
  • ページを参照
  • コメントを追加
  • ページにブロックを追加

ページを作成する

「ページを作成」アクションを使用して、Notionで親ページの下またはワークスペースレベルに新しいページを作成します。

このアクションには以下の入力と出力が含まれます。

  変数
入力 必須：Title

オプション：Parent page、Create at workspace level、Content

「親ページ」を指定するか、「ワークスペースレベルでの作成」を true に設定する必要があります。ワークスペースレベルのページは、パブリックインテグレーションでのみ利用可能です。「親ページ」フィールドを使用すると、名前を指定してNotionのページを検索することができます。
出力 ページの詳細情報：ID、URL、作成日時など。

ページを更新する

「ページを更新」アクションを使用して、既存のNotionページのタイトルやアーカイブステータスを更新します。
メモ：ワークスペースレベルのページのアーカイブは、Notion API経由ではサポートされていません。

このアクションには以下の入力と出力が含まれます。

  変数
入力 必須：Page ID

オプション：Title、Archived
出力 ページの詳細情報：ID、URL、最終編集日時など。

ページを参照する

「ページを参照」アクションを使用して、ページIDまたは完全に一致するタイトルを指定し、Notionページを取得します。

このアクションには以下の入力と出力が含まれます。

  変数
入力

オプション：Page ID、Title

「Page ID」または「Title」のいずれかが必須です。取得するページを特定するため、いずれかのフィールドを指定してください。
出力 ページの詳細：ID、URL、タイトル、アイコン、作成日時、最終編集日時、アーカイブステータスなど。

コメントを追加する

「コメントを追加」アクションを使用して、Notionページまたはブロックにコメントを追加します。

このアクションには以下の入力と出力が含まれます。

  変数
入力

必須：Page ID or Block ID、Comment text

「Page ID」または「Title」のいずれかが必須です。取得するページを特定するため、いずれかのフィールドを指定してください。
出力 コメントID、作成日時、作成者の情報。

ページにブロックを追加する

「ページにブロックを追加」アクションを使用して、Notionページにコンテンツブロック（段落、見出し、または引用など）を追加します。

このアクションには以下の入力と出力が含まれます。

  変数
入力

オプション：Page IDまたはBlock type、Content

使用可能なブロックタイプ：段落、見出し1、見出し2、見出し3、引用。
出力 ブロックID、タイプ、作成日時。
Powered by Zendesk