跳到文档内容
Anygent.ai文档

接入飞书企业租户应用(区别于个人助手)

用公司飞书创建机器人应用,同事和公司群都能用。

开始前

  • 你是这家公司飞书的成员;发布版本可能要管理员审批。

先分清两种租户

  1. 个人应用还是企业应用

    用个人飞书建的应用,自己发布就生效;用公司飞书建的归公司,发布通常要管理员审批,但同事和公司群都能用。两者在 Anygent 里功能一样。

创建与发布

  1. 一键创建应用

    在「飞书设置」点「一键创建应用(扫码确认)」,用公司飞书账号扫码确认,权限、事件和回调都已预填。

  2. 或手动创建并保存凭据

    在开放平台建自建应用并启用「机器人」;回平台点「手动绑定已有应用」,填 App ID 和 App Secret 保存,等显示「已连接」再订阅事件。

  3. 订阅事件和回调

    「事件配置」选长连接,添加 im.message.receive_v1、im.chat.member.bot.added_v1、im.chat.member.bot.deleted_v1、im.chat.disbanded_v1、im.chat.member.user.added_v1、im.chat.member.user.deleted_v1;「回调配置」也选长连接,添加 card.action.trigger。

  4. 补全权限

    回平台点「一键补全权限」批量开通(含 im:chat:readonly、im:chat.members:bot_access)。老应用点「升级权限(扫码)」可一次补齐事件、回调和权限。

  5. 发布并设可用范围

    在「版本管理与发布」创建版本并提交,通常要管理员审批;可用范围设为要用的成员或全员。

绑到平台

  1. 首个应用免费

    账号还没绑过飞书应用时,企业应用就是你的首个应用,免费,绑定方式和个人应用一样。

  2. 追加企业应用(付费)

    已有个人应用时,点「+ 一键创建应用(扫码)」或「手动添加已有应用」再加一个。第 2 个起付费,含首个最多 5 个。

用起来

  1. 在公司群里用

    把机器人拉进公司群,@ 它派活或发「绑定」接入对话,用法同「接入飞书群聊」。

  2. 外部群和外部用户

    企业先完成飞书认证,再在新版本里开启「对外共享 → 允许机器人被添加到外部群 / 允许外部用户与机器人单聊」。

注意事项

  • 改完权限或对外共享,要「创建版本并发布」并等管理员审批才生效,这是「配了没反应」最常见的原因。
  • 免费版每个账号最多绑 2 个群,与应用个数无关。
  • 私聊推送只发给你自己;同事协作请用群聊派活或群绑定。