飞书授权对接方式

了解飞书开放平台的多种授权方式,选择最适合你业务场景的方案

当前应用配置

App ID

cli_a937896ac839dcba

OAuth 回调

✓ 已配置

Webhook

✓ 已配置

网页应用授权
OAuth 2.0 扫码登录
已实现

用户通过飞书扫码授权登录,获取用户基本信息

核心功能

用户扫码授权登录获取用户 Open ID获取用户基本信息无需记住密码

使用场景

  • 用户注册/登录
  • 身份认证
  • 用户信息同步
机器人事件订阅
Webhook 消息推送
已实现

飞书主动推送群消息和事件到你的服务器

核心功能

接收群消息接收机器人进群事件接收机器人退群事件支持签名验证

使用场景

  • 群聊机器人
  • 消息监控
  • 自动回复
企业自建应用
Tenant Token

使用企业自建应用,获取企业级权限

核心功能

企业级权限访问企业通讯录发送企业消息管理企业资源

使用场景

  • 企业内部系统
  • OA 集成
  • 企业通知推送
应用商店应用
App Store

发布到飞书应用商店,供其他企业安装使用

核心功能

公开分发多租户支持商业化能力飞书审核

使用场景

  • SaaS 产品
  • 商业化应用
  • 公开服务
常见问题:机器人进群后无法接收消息

问题原因

飞书机器人需要配置「事件订阅」才能接收群消息,仅添加机器人到群是不够的。

解决方案

  1. 1在飞书开放平台「事件订阅」中配置 Request URL:https://claw.workzs.com/api/bot/webhook
  2. 2添加事件订阅:「接收消息」(im.message.receive_v1)
  3. 3在「权限管理」中开通:im:messageim:message:receive_as_bot
  4. 4发布应用版本,等待审核通过(开发环境可直接使用)
新功能:机器人运行模式

互动模式(默认)

机器人会自动回复群内所有消息,适合客服、问答、互动等场景。

  • 自动回复群消息
  • 支持 AI 对话
  • 适合客服场景

💡 可以在「管理后台 → 机器人管理 → 机器人详情」中随时切换运行模式