跳到文档内容
Anygent.ai文档

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

在公司飞书(企业租户)下创建自建应用接入平台:发布走管理员审批、可用范围按成员配置、支持公司群与外部群;可作为首个应用直接绑定,或在已有个人应用之外追加绑定。

开始前

  • 是目标企业租户的成员(发布版本可能需要租户管理员审批)

先分清两种租户

  1. 个人助手 vs 企业租户应用

    用哪个租户的账号登录开放平台,建出来的应用就属于哪个租户:个人版飞书建的是“个人助手”型应用,自己点发布就生效;企业租户建的应用归公司所有,发布通常要管理员审批,但同事可用、公司群可直接加。两种应用在本平台侧能力完全一致(私聊双向 + 群聊派活 + 群绑定),按需选择即可。

创建与发布

  1. 在企业租户创建自建应用

    推荐直接用平台的“一键创建应用(扫码确认)”——用企业租户的飞书账号扫码确认,应用就建在该租户下,权限 / 事件 / 回调全部预填。手动路线也一样可用:开放平台创建自建应用 → 启用「机器人」→ 事件订阅选「长连接」加 im.message.receive_v1 → 回平台填 App ID 后点「一键补全权限」。

  2. 发布版本并设置可用范围

    在「版本管理与发布」创建版本并提交发布——企业租户下通常需要管理员在管理后台审批通过才生效。发布时把“应用可用范围”设为需要使用的成员或全员;以后每次改权限、开对外共享都要再发一个新版本。

绑到平台

  1. 作为首个应用绑定(免费)

    如果账号还没绑过飞书应用,直接在「消息机器人 → 飞书机器人(自建应用)」填企业应用的 App ID / App Secret 保存,与个人应用的绑定方式完全一样。

  2. 在个人应用之外追加绑定(付费)

    已经绑了个人应用的话,用同一张卡片下方的“更多应用”再添加企业应用(可写备注区分,如“公司租户”)。追加应用是付费功能,含首个在内最多 5 个;每个应用的私聊 + 群聊能力与首个完全一致。

用起来

  1. 公司群里派活 / 绑定

    把机器人拉进公司群(内部群直接可加),@ 它派活或发「绑定」把群钉到对话——玩法与「接入飞书群聊」教程完全一致;哪条群绑定用的是哪个应用,回执和投递就从那个应用发出。

  2. 外部群与外部用户(可选)

    要进跨企业的外部群或让外部用户单聊:企业先完成飞书认证,再在发布新版本时开启「对外共享 → 允许机器人被添加到外部群 / 允许外部用户与机器人单聊」。之后同样可以用 AppLink 链接或二维码把机器人分享出去。

注意事项

  • 平台侧对个人 / 企业租户应用不作区分——不确定选哪个时,先用个人版跑通,再追加企业应用也不迟。
  • 企业应用改完权限 / 对外共享后必须“创建版本并发布”(并等管理员审批)才生效,这是最常见的“配了没反应”原因。
  • 群绑定额度按账号计算:免费版最多绑 2 个群,与应用个数无关。
  • 私聊推送绑定的是你自己的飞书账号(首次向机器人发消息回填);同事协作建议走群聊派活或群绑定,绑定情况在「飞书控制台」总览。