このドキュメントは AI によって自動翻訳されています。不正確な部分がある場合は、英語版 を参照してください。Dify は、Feishu または Lark の組織に作成したカスタムアプリを通じて動作します。このアプリは次の役割を担います。
- ボットを通じてメンバーにリクエストを送信します。
- Dify がメンバーディレクトリを読み取り、メールアドレスで各メンバーをワークスペースのメンバーと照合できるようにします。
- メンバーがリクエストのボタンをクリックすると、その応答を Dify に送り返します。
始める前に
次の点を確認してください。- Feishu の組織で、アプリの利用範囲をすべてのメンバーに設定できること。
TRIGGER_URLが、Feishu からインターネット経由でアクセスできるアドレスに設定されていること。カードのボタン操作を Dify に届けるために必要です。CONSOLE_WEB_URLが、メンバーがアクセスできるアドレスに設定されていること。リンクメッセージとして届くリクエストのリンク先は、このアドレスです。
アプリの作成
Feishu または Lark の開発者コンソールで、Create Custom App をクリックします。アプリには、「Dify」のようにメンバーが見てわかる名前を付けます。リクエストはこの名前のボットから届きます。続いて、次の手順を実行します。- Add Features で Bot を追加します。
-
Permissions & Scopes で Batch Actions をクリックします。メニューから Batch import/export scopes を選びます。Import タブで、例の内容を次のリストに置き換えます。
これらのスコープがあると、アプリは組織を識別し、カードを送信できます。誰かが応答した後にカードを更新したり、メンバーの名前、アバター、メールアドレスを読み取ったりすることもできます。
- 何も変更せずに Next ボタンを順にクリックし、最後に Add Scopes をクリックします。
- Version Management & Release で Create Version をクリックします。Availability をすべてのメンバーに設定し、バージョンを公開します。 Feishu の管理者でない場合は、先に管理者の承認が必要になることがあります。公開が完了してから、Dify での接続に進んでください。
Dify での接続
-
設定 > チャネル で Feishu または Lark を探し、接続 をクリックします。
すでに別の IM(インスタントメッセージングアプリ)を接続している場合は、代わりに 交換する をクリックします。先に 置き換えで消去される内容 を確認してください。
-
アプリの認証情報 に、Feishu アプリの値を入力します。
- アプリ ID と アプリシークレット:App ID と App Secret の値です。アプリの Credentials & Basic Info ページにあります。
- 検証トークン(任意):Verification Token の値です。Events & Callbacks > Encryption Strategy にあります。
- 暗号化キー(任意):Encrypt Key の値で、同じページにあります。Feishu 側で設定されている場合にのみ入力します。
Feishu 側で App Secret をリセットするなど、これらの値を変更した場合は、Dify 側も更新してください。 - 保存して続行 をクリックします。Dify は保存前に接続を確認します。
- コールバックを設定 で コールバック URL をコピーします。
コールバックの設定
- Feishu アプリで Events & Callbacks を開き、Callback Configuration タブに切り替えます。
- Subscription mode の横にある編集アイコンをクリックします。続いて、Send callbacks to developer’s server を選択します。
- Dify からコピーしたコールバック URL を Request URL に貼り付けて保存します。Feishu で保存できない場合は、トラブルシューティング で原因を確認してください。
-
Callback subscriptions で Add callback をクリックします。Card callback communication(
card.action.trigger)を追加します。 - Version Management & Release で新しいバージョンを作成して公開し、コールバックの設定を反映させます。再度、管理者の承認が必要になることがあります。
後で
TRIGGER_URL が変わると、コールバック URL も変わります。チャネル で Feishu または Lark の設定を開き、新しい URL を取得します。その URL で Feishu アプリ側を更新し、アプリの新しいバージョンを公開してください。同期とテスト
- チャネル で 今すぐ同期 をクリックし、メンバーの IM アカウントをバインドします。各結果の意味については、メンバーの同期 を参照してください。
- 自分宛てにテストリクエストを送信します。自分の IM アカウントをバインドした状態で、ワークフローを開き、人間の入力ノードでデバッグモードをオンにします。続いて Feishu または Lark を選択し、ワークフローをテスト実行します。 メッセージをテスト ではなく、デバッグモードを使ってください。テストメッセージは常にリンクメッセージとして届くため、カードやボタンのクリックが機能するかを確認できません。
- 代わりにリンクメッセージが届いた場合は、フォームに カードで表示できない要素 が含まれています。
- 何も届かない場合や実行が続行されない場合は、トラブルシューティング を参照してください。
メンバー側の表示

Feishu カードとして届いたリクエスト

リンクメッセージとして届いたリクエスト
- カードの見出しにはノードのタイトルが使われます。「人間の入力 2」ではなく「返金の承認」のように、受信者が理解できるタイトルをノードに付けてください。
- メンバーは、すべてのフィールドを入力しないとカードを送信できません。
- ファイルフィールド(単一ファイルまたはファイルリスト)
- 変数から挿入した長いレポートなど、非常に長いコンテンツ
トラブルシューティング
Dify での保存が API エラーコード 40004 で失敗する
Dify での保存が API エラーコード 40004 で失敗する
アプリがメンバーディレクトリ全体を読み取れていません。多くの場合、Availability がすべてのメンバーを対象にしていないことが原因です。新しいバージョンで Availability をすべてのメンバーに設定して公開し、Dify でもう一度保存してください。
Dify での保存時に「Feishu rejected the credential test」と表示される
Dify での保存時に「Feishu rejected the credential test」と表示される
App Secret が間違っているか、App ID と App Secret が別々のアプリのものになっています(本番用アプリとそのテスト版など)。両方とも、同じアプリの Credentials & Basic Info ページからコピーしてください。
テストリクエストが失敗する
テストリクエストが失敗する
何らかの原因で、Dify が送信できていません。メッセージをテスト で「テストに失敗しました。チャネル設定を確認して、もう一度お試しください。」と表示されるか、デバッグモードでの実行が「No one can approve this step.」というエラーで失敗します。次の順に確認してください。
- アプリにボットと
im:message:send_as_botスコープがあり、最新バージョンが公開されていること。 - 自分がアプリの Availability の範囲に含まれていること。
- 自分の IM アカウントがバインドされていること。
Feishu で Request URL を保存できない
Feishu で Request URL を保存できない
Dify の暗号化キーまたは検証トークンが Feishu 側の値と一致していないか、Feishu から URL にアクセスできていません。2 つの値を一致させてください。すでに一致している場合は、
TRIGGER_URL が Feishu からインターネット経由でアクセスできるアドレスに設定されているか確認してください。ボタンをクリックするとエラーコード 200671 が表示される
ボタンをクリックするとエラーコード 200671 が表示される
Dify がクリックを拒否しました。原因に応じて対処してください。
- 暗号化キーまたは検証トークンが Feishu 側の値と一致していない:値を一致させてください。
- カードの送信後に IM が置き換えられたか削除された:新しい実行を開始してください。デプロイの メール設定 が済んでいれば、メールから応答することもできます。
特定のカードのボタンだけが反応しない
特定のカードのボタンだけが反応しない
そのカードからは、リクエストに応答できなくなっています。
- リクエストがタイムアウトした、実行が停止された、またはメンバーがワークスペースから外れた:判断がまだ必要なら、新しい実行を開始してください。
- カードの送信後にメンバーの IM バインドが変わった:メンバーはメールから応答できます。
メンバーにカードが届かない
メンバーにカードが届かない
メンバーが「一致なし」のままになる
メンバーが「一致なし」のままになる
そのメンバーの Dify のメールアドレスが、Dify が Feishu から読み取ったメールアドレスと異なります。どちらかのメールアドレスを変更してもう一度同期するか、手動でバインド してください。