ヘルプセンターに戻る

FeishuとElisi Agentを接続する

FeishuのボットをElisi Agentに接続する

設定が完了すると、Feishuで企業ボットに個別メッセージを送り、Elisi Agentにタスクやリストなどの記録・検索を頼めます。

始める前に

以下が必要です。

  • Elisiアカウント
  • Feishuの企業向けカスタムアプリを作成・公開する権限
  • 必要に応じて、企業管理者によるアプリ権限の承認

1. Feishuアプリを作成する

  1. Feishu Open Platformを開き、開発者コンソールに進みます。
  2. 企業向けカスタムアプリを作成します。
  3. アプリ機能を追加でボットを有効にします。
  4. 権限に次を追加します。
    • ユーザーからボットへの1対1メッセージを読み取る。
    • アプリとしてメッセージを送信する。
    • グループチャットで使う場合は、ボットへのメンションを含むメッセージを受信する権限も追加する。

App IDとApp Secretを控えてください。

2. Elisiでボットを接続する

  1. Elisiで設定を開きます。
  2. Elisi AIでFeishu / Lark Botを選択します。
  3. プラットフォームにFeishuを選びます。国際版Larkを使う場合はLarkを選択します。
  4. 任意のボット名、App ID、App Secret、Feishuコンソールに表示されたVerification Tokenを入力します。
  5. ボットを接続を選択します。

検証後、Elisiに次の情報が表示されます。

  • イベントコールバックURL
  • アカウント連携用の1回限りのコマンド

App Secretは一度しか表示されません。Elisiは暗号化して保存し、Agentには送信しません。

3. イベントコールバックを設定する

Feishu Open Platformに戻ります。

  1. イベントとコールバックまたはイベント購読を開きます。

  2. 開発者サーバーにイベントを送信を選択します。

  3. ElisiのイベントコールバックURLをコピーし、リクエストURLに貼り付けます。

  4. Encrypt Keyは空欄にします。

  5. URLを保存し、Feishuの検証成功を待ちます。

  6. イベントを追加を選択し、次を追加します。

    メッセージを受信 (im.message.receive_v1)

URLの検証だけでは不十分です。im.message.receive_v1も別途追加してください。

4. アプリを公開してインストールする

  1. Feishu Open Platformで新しいバージョンを作成します。
  2. 追加した権限とメッセージイベントが含まれていることを確認します。
  3. 審査に提出して公開します。必要な場合は先に管理者の承認を受けてください。
  4. 企業にアプリをインストールし、自分のFeishuアカウントが利用対象に含まれていることを確認します。

権限やイベント購読を変更した後は、新しいバージョンを公開しないと変更が反映されません。

5. Elisiアカウントを連携する

設定と公開には15分以上かかることがあります。公開後、Elisiに戻ります。

  1. ボットのカードで新しい連携コードを生成を選択します。

  2. 次のような1回限りのコマンド全体をコピーします。

    /elisi-bind AbCdEf123

  3. 15分以内にボットとの1対1チャットを開き、コマンドを送信します。

  4. 成功メッセージを確認したらElisiに戻り、状態を更新します。

状態が連携待ちから接続済みに変われば設定完了です。初回の連携はグループではなく1対1チャットで行ってください。

6. ボットを使う

  • 1対1チャット： ボットに直接テキストを送ります。
  • グループチャット： 連携済みのユーザーがメッセージ内でボットにメンションします。
  • 接続解除： Elisiのボットカードで接続解除を選択します。

現在のバージョンはテキストメッセージに対応しています。Encrypt Keyを使った暗号化コールバック、添付ファイル、インタラクティブカード、複数人による同じElisiアカウントの共有には対応していません。

トラブルシューティング

問題 確認すること
コールバックURLの検証に失敗する、またはchallengeが返らない URL全体とVerification Tokenの一致を確認します。Encrypt Keyを空にして保存し直します。
URL検証は成功するが、1対1チャットでボットが応答しない im.message.receive_v1が追加されているか確認します。イベントと権限の追加後、最新版を再公開・承認・インストールします。
Elisiに「連携待ち」と表示される 新しい連携コードを生成し、15分以内に1対1チャットからコマンド全体を送ります。古いコードは無効です。
アカウントは連携済みだが、ボットが返事をしない アプリとしてメッセージを送信する権限が承認され、最新バージョンに含まれているか確認します。
グループでボットが応答しない まず1対1チャットで連携し、その後、連携済みユーザーがグループでボットにメンションします。
ボットが見つからない、または個別メッセージを送れない アプリがインストールされ、アカウントが利用対象に含まれているか確認します。

解決しない場合は、Feishu Open Platformのイベント配信ログでim.message.receive_v1が記録されているか確認します。記録がなければ、イベント、権限、公開バージョン、利用対象の設定がまだ反映されていない可能性があります。