メインコンテンツへスキップ

Lark連携ガイド

本ガイドでは、FormAgent.aiとLarkの連携を素早く設定し、訪問者との会話を自動的にLarkに同期させ、カスタマーサービスチームがLark内で訪問者からの問い合わせを確認・返信できるようにする方法をご紹介します。

✨ 機能​

  • 🚀 ワンクリック認証 - OAuthでLarkテナントに素早く接続
  • 🎯 ビジュアル選択 - 認証後、インターフェースから直接メッセージ受信グループを選択可能
  • 📊 自動会話同期 - すべての訪問者会話が自動的にLarkに同期
  • 👤 訪問者プロフィール表示 - メッセージカードに訪問者の詳細情報（位置、デバイス、参照元など）を表示
  • 💬 双方向メッセージ同期 - 訪問者メッセージとエージェント返信がリアルタイムで同期
  • 🔄 人間による引き継ぎ - Lark内でワンクリックで人間によるサービスの有効化/無効化をサポート
  • 🏷️ 実名表示 - オペレーターの実名を自動表示

前提条件​

  • Larkアカウント
  • 作成済みのAgentを持つFormAgent.aiアカウント
  • 管理者がLarkアプリの設定を完了していること（未設定の場合は、システム管理者にお問い合わせください）

クイックスタート​

ステップ1：連携設定ページに移動​

  1. FormAgent.ai管理ダッシュボードにログイン
  2. Agentを選択
  3. 「Settings」 → 「Integrations」 → 「Lark」 に移動

ステップ2：Larkに接続​

  1. ページ上の 「Connect to Lark」 ボタンをクリック
  2. ブラウザがLark認証ページにリダイレクトされます
  3. 認証するテナントを選択
  4. 権限リストを確認し、「同意する」 または 「Agree」 をクリック

認証が成功すると、ページは自動的にFormAgent.aiに戻ります。

ステップ3：LarkのグループにBotを追加​

⚠️ 重要：FormAgent.ai Botが追加されたグループのみ、次のステップのグループリストに表示されます。

Larkでグループを作成または開きます：

  1. グループ右上の 「···」 メニューをクリック
  2. 「グループ設定」 → 「グループBot」 を選択
  3. 「Botを追加」 をクリック
  4. FormAgent.ai を検索して追加

Botがグループに正常に参加すると、FormAgent.aiでそのグループを選択できるようになります。

ステップ4：メッセージ受信グループを選択​

FormAgent.ai連携設定ページに戻ります：

  1. ドロップダウンからメッセージ受信グループを選択（先ほどBotを追加したグループ）
  2. 「Save」 をクリックして設定を保存
  3. 「連携を有効にする」 トグルをオンにする

💡 ヒント:

  • ドロップダウンリストには、FormAgent.ai Botが追加されたグループのみが表示されます
  • グループが表示されない場合は、まずLarkでそのグループにBotを追加してください
  • 再認証せずに、いつでもグループを変更できます

機能の使用​

訪問者会話の確認​

訪問者がウェブサイトでメッセージを送信すると：

  1. Larkグループにリッチテキストメッセージカードが自動作成されます
  2. カードには訪問者プロフィール情報が含まれます
  3. メッセージ返信に訪問者メッセージとAI自動返信が表示されます
  4. カードフッターに 「🚀 人間によるサービスを開始」 ボタンがあります

人間による引き継ぎ​

人間による介入が必要な場合：

  1. Larkメッセージカードで、「🚀 人間によるサービスを開始」 ボタンをクリック
  2. システムにプロンプトが表示されます：「人間によるサービスが有効になりました」
  3. AI自動返信が一時停止します
  4. メッセージ返信にカスタマーサービスメッセージを入力すると、訪問者がリアルタイムでメッセージを受信します
  5. 訪問者のその後の返信もリアルタイムでLarkグループに同期されます
  6. システムはオペレーターの実名を表示します（ユーザーIDではありません）

人間によるサービスの終了​

会話が終了するか、AIに自動返信を再開させたい場合：

  1. Larkメッセージカードで 「人間によるサービスを終了」 ボタンをクリック
  2. ボタンのステータスが 「🚀 人間によるサービスを開始」 に戻ります
  3. AIが訪問者の新しいメッセージへの自動返信を再開します

よくある質問​

グループを変更するには？​

  1. Larkで、新しいグループにFormAgent.ai Botを追加
  2. FormAgent.ai連携設定ページに移動
  3. ドロップダウンから新しいグループを選択
  4. 「Save」 をクリック

💡 グループを変更すると、新しい会話は新しいグループにプッシュされ、古い会話は元のグループに残ります

認証を取り消すには？​

方法1：FormAgent.aiで取り消す

  1. 連携設定ページに移動
  2. 「Disconnect」 ボタンをクリック
  3. 取り消しを確認

方法2：Larkで取り消す

  1. Larkワークスペースに移動
  2. 「アプリ管理」 → 「マイアプリ」 を選択
  3. FormAgent.aiを見つけて 「認証を取り消す」 をクリック

複数のAgentで1つの認証を共有できますか？​

できますが、推奨されません。

  • ✅ 推奨：各Agentが個別に認証し、異なるグループを選択可能
  • ⚠️ 認証の共有：すべてのAgentのメッセージが同じグループに送信され、混乱を招く可能性があります

グループリストが空の場合は？​

考えられる原因:

  1. まだどのグループにもFormAgent.ai Botを追加していない
  2. Larkでどのグループにも参加していない
  3. OAuth権限に必要な権限がない（管理者にお問い合わせください）

解決方法:

  1. まず、Larkでグループを作成または参加
  2. 次に、そのグループにFormAgent.ai Botを追加（ステップ3を参照）
  3. 最後に、FormAgent.aiページを更新すると、グループがドロップダウンに表示されます

💡 ヒント：ドロップダウンには、FormAgent.ai Botが追加されたグループのみが表示され、参加しているすべてのグループが表示されるわけではありません

メッセージカードボタンをクリックしても応答がない場合は？​

考えられる原因:

  1. カードコールバックイベントが購読されていない（管理者にお問い合わせください）
  2. メッセージカードリクエストURL設定エラー（管理者にお問い合わせください）

解決方法: システム管理者に連絡して設定を確認してください

ユーザーIDが表示され、実名が表示されない場合は？​

症状：実名ではなく「ou_xxx」または短いIDが表示される

考えられる原因: Larkアプリにユーザー情報を読み取る権限がない（管理者にお問い合わせください）

解決方法: システム管理者に連絡して関連する権限を追加してください

認証リダイレクトが失敗する場合は？​

考えられる原因:

  1. リダイレクトURLの設定エラー
  2. 環境変数が正しく設定されていない

解決方法: システム管理者に連絡して設定を確認してください

サポート​

ご質問がある場合は、以下までお問い合わせください：

ドキュメントバージョン: v1.1 最終更新: 2025-11-26 更新内容: ステップの順序を調整し、グループがドロップダウンに表示される前にBotを追加する必要があることを明確化