Feishu / Lark

カタログにはFeishu/Larkの長時間接続プロファイルとWebhookプロファイルが宣言されています。標準の設定画面では、公開Webhookを必要としない既定のLong connectionアカウントを作成します。カタログにWebhookや切り替えアクションがあっても、標準UIにプロファイル選択機能があるとは限りません。

接続プロファイルと設定の制限

プロファイル	必要な認証情報	公開HTTPS
既定の長時間接続（feishu.websocket.v1）	App ID、App Secret	不要
Webhook（feishu.webhook.v1）	App ID、App Secret、Verification Token、Encrypt Key	必要

現在のアプリコンソールについては、プラットフォームの公式概要を参照してください。

プラットフォーム側の前提条件

どちらのプロファイルでも、次が必要です。

1. アプリを作成してボット機能を有効にします。
2. 必要なボットのメッセージング権限を付与します。
3. メッセージイベントを購読します。

プラットフォーム側の配信方式を、既存のAnyyプロファイルに合わせます。新規アカウントの標準設定では長時間接続を使用します。

接続する

Dashboard → Channel → AddからFeishu / Larkを選び、既定の長時間接続を設定します。App IDとApp Secretを入力します。ダイレクトメッセージの既定値はpairing、グループはmentionです。

対話型ターミナルでanyy setup channelを実行し、Feishuを選んでCLIのポリシー入力を変更します。標準のCLI、TUI、Dashboardの設定機能には、現在、接続プロファイルの選択や切り替え操作はありません。カタログの切り替え記述を、実際に使えるウィザードコマンドとして扱わないでください。

既存のWebhookアカウントは現在のプロファイルのまま更新されます。CLIフォームにはWebhook認証情報が含まれます。Dashboard/TUIでは、公開されているApp認証情報だけを更新できます。

既存のWebhookアカウントでは、メッセージングプラットフォームの共通リスナーとHTTPSプロキシを有効にして、次のパスを公開します。

/channels/feishu/ACCOUNT_ID/webhook

既定のアカウントIDはworkです。Feishu/LarkとAnyyに同じVerification TokenとEncrypt Keyを設定します。

アクセスポリシー

ダイレクトメッセージはpairing、open、allowlist、disabled、グループはmention、open、allowlist、disabledに対応します。これらのポリシー入力はCLIウィザードにあり、Dashboardの認証情報フォームにはありません。現在の設定にはFeishuの許可リスト項目エディターがないため、このポリシーを選ぶ前に共通の設定上の制限を確認してください。

anyy channel pairing list
anyy channel pairing approve --request REQUEST_ID

接続を検証する

anyy channel doctor feishu
anyy channel reload

まずダイレクトメッセージをテストし、その後グループでのメンションをテストします。

トラブルシューティング

問題	確認する項目
長時間接続が稼働状態にならない	App認証情報、ボット機能、イベント購読、外部へのネットワーク接続
Webhook検証に失敗する	公開HTTPSルート、Verification Token、Encrypt Key
イベントは届くがメッセージが無視される	DM／グループポリシー、ペアリング、メンション要件
返信が認可されない	ボットのメッセージング権限とアプリの公開状態
別の接続プロファイルが必要	現在の標準設定には切り替え選択機能がないため、プロファイルのフラグやアクションを推測しないこと