跳至主要内容

飞书(Lark)集成使用指南

本指南将帮助您快速配置并使用 FormAgent.ai 与飞书(Lark)的集成,实现访客对话自动同步到飞书,让您的客服团队可以在飞书中查看和回复访客咨询。

✨ 功能特点​

  • 🚀 一键授权 - 通过 OAuth 快速连接您的飞书租户
  • 🎯 可视化选择 - 授权后可直接选择接收消息的群组
  • 📊 自动同步对话 - 所有访客对话自动同步到飞书
  • 👤 访客画像显示 - 消息卡片包含访客详细信息(位置、设备、来源等)
  • 💬 双向消息同步 - 访客消息和客服回复实时双向同步
  • 🔄 人工接管 - 支持在飞书中一键开启/关闭人工服务
  • 🏷️ 真实姓名显示 - 自动显示操作人员的真实姓名

前提条件​

  • 已有飞书账号
  • 已注册 FormAgent.ai 账号并创建 Agent
  • 管理员已完成飞书应用的配置(如未配置,请联系您的系统管理员)

快速开始​

步骤 1: 进入集成配置页面​

  1. 登录 FormAgent.ai 管理后台
  2. 选择您的 Agent
  3. 进入 "Settings" → "Integrations" → "Lark"

步骤 2: 连接飞书​

  1. 点击页面上的 "Connect to Lark" 按钮
  2. 浏览器会跳转到飞书授权页面
  3. 选择您要授权的租户
  4. 查看权限列表,点击 "同意授权" 或 "Agree"

授权成功后,页面会自动返回 FormAgent.ai。

步骤 3: 在飞书中添加机器人到群组​

⚠️ 重要: 只有添加了 FormAgent.ai 机器人的群组,才会在下一步的群组列表中显示。

在飞书中创建或打开一个群组:

  1. 点击群组右上角的 "···" 菜单
  2. 选择 "群设置" → "群机器人"
  3. 点击 "添加机器人"
  4. 搜索并添加 FormAgent.ai

机器人成功加入群组后,您就可以在 FormAgent.ai 中选择该群组了。

步骤 4: 选择接收消息的群组​

返回 FormAgent.ai 集成配置页面:

  1. 从下拉列表中选择接收消息的群组(刚才添加了机器人的群组)
  2. 点击 "Save" 保存配置
  3. 开启 "启用集成" 开关

💡 提示:

  • 下拉列表只会显示已添加 FormAgent.ai 机器人的群组
  • 如果看不到某个群组,请先在飞书中将机器人添加到该群组
  • 可以随时更换群组,无需重新授权

使用功能​

查看访客对话​

当访客在您的网站上发送消息时:

  1. 飞书群组会自动创建一条富文本消息卡片
  2. 卡片包含访客画像信息
  3. 消息回复中显示访客消息和 AI 自动回复
  4. 卡片底部有 "🚀 开启人工服务" 按钮

人工接管对话​

当您需要人工介入时:

  1. 在飞书消息卡片中,点击 "🚀 开启人工服务" 按钮
  2. 系统会显示提示: "人工服务已开启"
  3. 此时 AI 自动回复会暂停
  4. 在消息回复中输入客服消息,访客会实时收到您的消息
  5. 访客的后续回复也会实时同步到飞书群组
  6. 系统会显示操作人员的真实姓名(而非用户 ID)

结束人工服务​

当对话结束或希望 AI 恢复自动回复时:

  1. 在飞书消息卡片中点击 "结束人工服务" 按钮
  2. 按钮状态会变回 "🚀 开启人工服务"
  3. AI 会恢复自动回复访客的新消息

常见问题​

如何更换群组?​

  1. 在飞书中,将 FormAgent.ai 机器人添加到新群组
  2. 进入 FormAgent.ai 集成配置页面
  3. 从下拉列表选择新群组
  4. 点击 "Save" 保存

💡 更换群组后,新对话会推送到新群组,旧对话仍在原群组

如何取消授权?​

方法 1: 在 FormAgent.ai 中取消

  1. 进入集成配置页面
  2. 点击 "Disconnect" 按钮
  3. 确认取消授权

方法 2: 在飞书中撤销

  1. 进入飞书工作台
  2. 选择 "应用管理" → "我的应用"
  3. 找到 FormAgent.ai,点击 "取消授权"

多个 Agent 可以共用一个授权吗?​

可以,但不推荐。

  • ✅ 推荐做法: 每个 Agent 单独授权,可选择不同的群组
  • ⚠️ 共用授权: 所有 Agent 的消息会发送到同一个群组,可能造成混乱

群组列表为空怎么办?​

可能原因:

  1. 您还没有在任何群组中添加 FormAgent.ai 机器人
  2. 您在飞书中没有加入任何群组
  3. OAuth 权限缺少必要权限(请联系管理员)

解决方法:

  1. 首先,在飞书中创建或加入一个群组
  2. 然后,在该群组中添加 FormAgent.ai 机器人(参见步骤 3)
  3. 最后,刷新 FormAgent.ai 页面,该群组即可在下拉列表中显示

💡 提示: 下拉列表只会显示已添加 FormAgent.ai 机器人的群组,而不是所有您加入的群组

为什么消息卡片按钮点击没有响应?​

可能原因:

  1. 未订阅卡片回调事件(请联系管理员)
  2. 消息卡片请求地址配置错误(请联系管理员)

解决方法: 请联系您的系统管理员检查配置

为什么显示用户 ID 而不是真实姓名?​

症状: 看到 "ou_xxx" 或短 ID 而不是真实姓名

可能原因: 飞书应用缺少读取用户信息的权限(请联系管理员)

解决方法: 请联系您的系统管理员添加相关权限

授权后跳转失败怎么办?​

可能原因:

  1. Redirect URL 配置错误
  2. 环境变量未正确配置

解决方法: 请联系您的系统管理员检查配置

支持​

如有疑问,请联系:

文档版本: v1.1 最后更新: 2025-11-26 更新说明: 调整步骤顺序,明确需先添加机器人后才能选择群组