跳到文档内容
Anygent.ai文档

接入飞书群聊:@ 派活、群绑定对话与分享机器人

把飞书机器人拉进工作群:@ 机器人即可派活,绑定对话后群内消息直达 agent;再用一条 AppLink 链接(或二维码)把机器人分享给任何人。

开始前

  • 已完成飞书机器人接入(见「接入 QQ / 微信 / 飞书通知机器人」)

进群与 @ 派活

  1. 把机器人拉进群

    在目标群「设置 → 群机器人 → 添加机器人」选择你的机器人(内部群直接可加)。外部群(含跨企业成员)需要企业先完成飞书认证,再在应用「版本管理与发布」新建版本时开启「对外共享 → 允许机器人被添加到外部群」并发布。

  2. @ 机器人派活

    群里发 `@机器人 列表` 查看你的对话,`@机器人 #1 帮我看下 xxx` 即可给 1 号对话派活。机器人会给原消息打“收到”表情、引用原话回一张实时状态卡;AI 完成通知和审批卡片都发回群里,任何成员回复卡片就能续聊,回复“批准 / 拒绝”即可决断审批。

群绑定对话(可选)

  1. 发送“绑定”,选一个对话

    群里发 `@机器人 绑定`,点卡片里的「打开绑定页」(链接 15 分钟有效),登录后把左侧栏的对话拖进落区、或按“机器 → 工作区 → 对话”选定,完成后群里那张卡会原地翻新成 ✅。

  2. 绑定后:群消息直达对话

    绑定后群内所有文本消息(不用 @)都会持续投递进这个对话,AI 回复和完成通知自动回群;对话挂了团队 topic 时会自动切成 team 模式(消息以工单评论投递,其他 agent 的回复也镜像回群)。解绑随时发 `@机器人 解绑`。

分享机器人给别人

  1. 拼一条 AppLink

    把下面 URL 里的 App ID 换成你自己的(飞书开发者后台「凭证与基础信息」页复制),就得到机器人的通用链接——不需要任何开发。

    https://applink.feishu.cn/client/bot/open?appId=cli_xxxxxxxxxxxxxxxx
  2. 链接随便发,二维码随手做

    这就是个普通链接:微信、邮件、网页、飞书消息里直接发都行。对方在飞书内点开直接跳到机器人会话页;在飞书外(浏览器 / 微信)点开会先出引导页,自动尝试唤起飞书客户端(没装会提示下载)。把这条 URL 扔进任意二维码生成器,就是“扫码添加机器人”物料。

  3. 对方点开之后

    进入机器人会话页 → 首次会弹确认框(需要你发布的版本开了「允许外部用户与机器人单聊」)→ 确认后单聊建立。如果你发布时勾了「首次单聊需应用所有者审核」,你的“开发者小助手”会先收到审批消息,你同意后对方才能开聊。单聊一建立,平台就能拿到对方的 open_id,之后机器人可以主动给 TA 发消息、把 TA 拉进外部群。

  4. (备选)飞书内直接转名片

    打开机器人的资料页 → 右上角分享 / 转发,把名片直接转给已经是外部联系人的人,效果和 AppLink 一样。

注意事项

  • 外部用户和机器人单聊要求对方飞书 ≥ 7.22;iOS 上主动发起需要 ≥ 7.68,低版本会看到升级提示。
  • 绑定后“不 @ 也投递”依赖 `im:message.group_msg` 权限——记得加权限后创建新版本并发布。
  • 群里的审批决断只认 @ 派活建立该对话绑定的那位成员,防止误批。
  • 谁完成群绑定,群消息就进谁的对话、用谁的额度——别人也能借你的机器人绑他自己的对话;作为应用号主可在「飞书控制台」总览和管理这些绑定。