在之前的分享中，我们陆续展示了如何用Coze平台开发招聘、培训、薪酬、绩效等各类HR智能体。但很多同学开发完之后都会问同一个问题：

“智能体做好了，怎么让团队用起来？”

这是一个非常实际的部署问题。目前主要有三种部署方式：

1. 接入即时通讯工具（企业微信、飞书、钉钉等）

2. 自建网页平台集中展示

3. 接入公司内部网站或ERP系统

其中，接入飞书是很多企业的首选——因为HR团队日常就在飞书上协作，智能体直接变成“群聊机器人”，@一下就能用，体验最顺畅。

而且，飞书和Coze同属字节跳动旗下，接入过程相对简单。今天我就把完整的接入步骤整理出来，供大家参考。

智能体接入飞书——安装配置指南

文档概述

本文档旨在指导用户完成智能体与飞书平台的集成配置，使智能体能够在飞书环境中正常接收和回复用户消息。

一、前提条件

在开始配置之前，请确认您已具备以下条件：

二、配置步骤

2.1 创建飞书应用

1. 打开 飞书开发者后台

2. 点击 「创建企业自建应用」

3. 输入应用名称（如“HR数字员工”），上传应用图标

4. 点击 「创建」

2.2 启用机器人功能

1. 进入应用详情页

2. 点击左侧菜单 「机器人」

3. 开启 「启用机器人」 开关

2.3 配置事件订阅（核心步骤）

1. 点击左侧菜单 「事件与回调」 → 「事件订阅」

2. 在 「请求地址配置」 处输入您的服务器回调地址：

   text

   https://your-domain.com/feishu/webhook

   请将 your-domain.com 替换为您的实际服务器域名

3. 点击 「保存」 按钮，系统将自动发送验证请求，验证通过后状态显示为“可用”

4. 在 「已添加事件」 区域，点击 「添加事件」

5. 搜索并勾选以下事件：

• im.message.receive_v1（接收消息事件）

6. 点击 「确认添加」

2.4 配置回调（可选）

若需要处理飞书卡片交互等回调：

1. 点击顶部 「回调配置」 标签页

2. 在回调 URL 处输入与事件订阅相同的地址

3. 点击 「保存」

2.5 添加所需权限

1. 点击左侧菜单 「权限管理」

2. 搜索并开启以下权限：

如有其他业务需求，可酌情添加 im:chat:readonly、contact:user.id:readonly 等权限。

2.6 发布应用

1. 点击左侧菜单 「版本管理与发布」

2. 点击 「创建版本」

3. 填写版本号（如 1.0.0）和更新说明

4. 点击 「申请发布」

5. 企业管理员审批通过后，应用正式生效

三、平台侧集成配置

在智能体平台（如 Coze）中完成以下配置：

1. 进入您的智能体项目

2. 找到 「集成」 或 「工具」 配置入口

3. 搜索并选择 「飞书多维表格」 或 「飞书 Base」 集成项

4. 点击 「配置」 → 「授权」

5. 按提示跳转至飞书完成账号授权

此步骤用于获取飞书 API 调用凭证（Tenant Access Token），是智能体回复消息的必要前提。

四、配置验证

完成上述所有步骤后，可通过以下方式验证配置是否成功：

五、常见问题排查