PolarDB:Feishu ボットと PolarDB Agent Express の統合

プロセスの概要

Feishu ボットを PolarDB Agent Express と統合するには、次の手順に従います。

1. Feishu アプリを作成し、その認証情報を取得します。

2. PolarDB Agent Express で Feishu チャネルを設定します。

3. Feishu でイベントコールバックを設定し、アプリを公開します。

Feishu アプリの作成

1. Feishu オープンプラットフォームにログインし、右上の [開発者コンソール] をクリックします。コンソールページで、[カスタムアプリを作成] をクリックします。[アプリ名]、[アプリの説明]、[アプリアイコン] を入力し、[作成] をクリックします。

2. アプリ管理ページに移動し、[ボット] 機能を見つけ、[追加] をクリックします。

3. 左側メニューで、[権限管理] をクリックします。[権限の一括インポート/エクスポート] をクリックします。[インポート] タブで、次の JSON 権限記述を貼り付け、[次へ、新しい権限を確認] をクリックし、[有効化を申請] をクリックします。

   {
     "scopes": {
       "tenant": [
         "aily:file:read",
         "aily:file:write",
         "application:application.app_message_stats.overview:readonly",
         "application:application:self_manage",
         "application:bot.menu:write",
         "cardkit:card:write",
         "contact:contact.base:readonly",
         "contact:user.employee_id:readonly",
         "corehr:file:download",
         "docs:document.content:read",
         "event:ip_list",
         "im:chat",
         "im:chat.access_event.bot_p2p_chat:read",
         "im:chat.members:bot_access",
         "im:message",
         "im:message.group_at_msg:readonly",
         "im:message.group_msg",
         "im:message.p2p_msg:readonly",
         "im:message:readonly",
         "im:message:send_as_bot",
         "im:resource",
         "sheets:spreadsheet",
         "wiki:wiki:readonly"
       ],
       "user": [
         "aily:file:read",
         "aily:file:write",
         "im:chat.access_event.bot_p2p_chat:read"
       ]
     }
   }

4. [認証情報と情報] ページに移動します。[アプリ ID] と [App シークレット] をコピーします。これらの認証情報は、PolarDB Agent Express の設定に必要です。

PolarDB Agent Express の Feishu チャネルの設定

Feishu アプリで取得した認証情報を PolarDB Agent Express に追加します。これにより、PolarDB Agent Express が Feishu ボットに接続できるようになります。

1. PolarDB コンソールにログインし、PolarDB Agent Express アプリの管理ページに移動します。

2. チャネル設定 で、Feishu チャネルを有効にします。前の手順で取得した ボット APP KEY と アプリシークレット を入力し、保存 をクリックします。

   重要

   この設定を保存すると、PolarDB Agent Express が設定を更新して再起動します。このプロセスには約 2 分かかります。

イベントコールバックの設定

Feishu アプリのイベントサブスクリプションとコールバック設定を行い、ボットがユーザーメッセージを受信できるようにします。

1. Feishu オープンプラットフォームにログインし、右上の [開発者コンソール] をクリックして、アプリに移動します。左側メニューで、[イベントとコールバック] をクリックします。[イベント設定] タブで、[サブスクリプション方法] に [ロングコネクション] を選択し、[保存] をクリックします。

2. [イベント設定] タブの [追加されたイベント] で、[メッセージ受信] イベントを追加します。

3. [コールバック設定] タブの [サブスクリプション方法] で、アプリが [ロングコネクション] を使用してコールバックを受信するように設定し、[保存] をクリックします。

Feishu アプリの公開

設定が完了したら、アプリを公開して変更を適用します。左側メニューで、[バージョン管理とリリース] をクリックします。右上で、[新しいバージョンを作成] をクリックします。バージョン番号と更新ノートを入力し、ページ下部の [保存] をクリックしてバージョンを公開します。

ボットの追加と検証

新規または既存のグループチャットにボットを追加するか、ダイレクトメッセージでボットと対話して、正常に動作することを確認できます。

• Feishu グループ設定ページに移動し、[グループボット] をクリックします。ボット管理ページで、右上の [追加] をクリックします。検索ボックスにボットの名前を入力し、結果から選択して [追加] をクリックします。

• ボットと対話するには、グループチャットで @メンションするか、ダイレクトメッセージを開始します。ボットは、Feishu 内または機能ページで名前を検索して見つけることができます。