腾讯workbuddy接入飞书方法
WorkBuddy接入飞书全流程指南
将WorkBuddy的自动化能力集成至飞书,可显著提升工作流效率。本指南将引导您完成从创建飞书应用到最终启用的完整配置过程。
一、前提条件
开始配置前,请确保满足以下基本要求:
第一,确保已在您的计算机上完成WorkBuddy的安装,并确认其核心功能“Claw”已处于启用状态。
第二,您需要拥有一个飞书企业管理员账号,或具备创建企业内部应用的相应权限,这是后续所有操作的基础。
二、创建飞书应用
首先,我们需要在飞书开放平台创建一个自建应用,作为集成的桥梁。
登录开发者后台
访问飞书开放平台,使用企业管理员账号登录。在控制台主页,找到并点击「创建企业自建应用」按钮。
填写应用信息
在弹出的创建窗口中,按以下要求填写应用基础信息:
1、应用名称:建议使用如「WorkBuddy自动化助手」等清晰明确的名称。
2、应用描述:简要说明此应用用于连接WorkBuddy,实现自动化任务执行。
3、应用图标:上传一个与功能相关的标识性图片,增强辨识度。
4、确认信息无误后,点击「创建」按钮完成应用的初步建立。
进入应用详情
创建成功后,系统将自动跳转至该应用的管理后台详情页面。
三、添加机器人能力
应用需要机器人能力来处理用户指令。在应用详情页的「添加应用能力」区域,找到「机器人」卡片并点击「添加」按钮。
四、配置应用权限
为确保机器人能顺利调用飞书各项服务,需要为其配置全面的API访问权限。
进入权限管理
在左侧导航栏点击「权限管理」,然后进入「批量导入/导出权限」界面。
批量导入权限
1. 先清空权限输入框内的默认内容。
2. 将下方完整的权限JSON代码全部复制,并粘贴至输入框中。
3. 点击「确定新增权限」按钮提交。
4. 需要导入的权限列表:
{
"scopes":{
"tenant":[
"contact:contact.base:readonly",
"docx:document:readonly",
"im:chat:read",
"im:chat:update",
"im:message.group_at_msg:readonly",
"im:message.p2p_msg:readonly",
"im:message.pins:read",
"im:message.pins:write_only",
"im:message.reactions:read",
"im:message.reactions:write_only",
"im:message:readonly",
"im:message:recall",
"im:message:send_as_bot",
"im:message:send_multi_users",
"im:message:send_sys_msg",
"im:message:update",
"im:resource",
"application:application:self_manage",
"cardkit:card:write",
"cardkit:card:read"
],
"user":[
"contact:user.employee_id:readonly",
"offline_access",
"base:app:copy",
"base:field:create",
"base:field:delete",
"base:field:read",
"base:field:update",
"base:record:create",
"base:record:delete",
"base:record:retrieve",
"base:record:update",
"base:table:create",
"base:table:delete",
"base:table:read",
"base:table:update",
"base:view:read",
"base:view:write_only",
"base:app:create",
"base:app:update",
"base:app:read",
"board:whiteboard:node:create",
"board:whiteboard:node:read",
"calendar:calendar:read",
"calendar:calendar.event:create",
"calendar:calendar.event:delete",
"calendar:calendar.event:read",
"calendar:calendar.event:reply",
"calendar:calendar.event:update",
"calendar:calendar.free_busy:read",
"contact:contact.base:readonly",
"contact:user.base:readonly",
"contact:user:search",
"docs:document.comment:create",
"docs:document.comment:read",
"docs:document.comment:update",
"docs:document.media:download",
"docs:document:copy",
"docx:document:create",
"docx:document:readonly",
"docx:document:write_only",
"drive:drive.metadata:readonly",
"drive:file:download",
"drive:file:upload",
"im:chat.members:read",
"im:chat:read",
"im:message",
"im:message.group_msg:get_as_user",
"im:message.p2p_msg:get_as_user",
"im:message:readonly",
"search:docs:read",
"search:message",
"space:document:delete",
"space:document:move",
"space:document:retrieve",
"task:comment:read",
"task:comment:write",
"task:task:read",
"task:task:write",
"task:task:writeonly",
"task:tasklist:read",
"task:tasklist:write",
"wiki:node:copy",
"wiki:node:create",
"wiki:node:move",
"wiki:node:read",
"wiki:node:retrieve",
"wiki:space:read",
"wiki:space:retrieve",
"wiki:space:write_only"
]
}
}
5. 页面刷新后提示权限添加成功,表明机器人已获得必要操作权限。
五、获取应用凭证
连接需要身份验证,请获取以下关键凭证:
查看凭证信息
1. 在应用详情页,进入左侧「凭证与基础信息」菜单。
2. 在此页面记录两项核心信息:
AppID:应用的唯一身份标识。
AppSecret:应用密钥(点击“查看”获取),用于接口鉴权。
3. 安全提示:AppSecret属于敏感信息,请妥善保管,避免泄露。
六、在WorkBuddy中配置飞书
接下来,在WorkBuddy客户端内完成飞书服务的绑定。
1、打开Claw设置:于WorkBuddy主界面,点击右上角头像,选择「Claw设置」。
2、选择飞书集成:在Claw设置页面,点击进入「飞书集成」配置项。
3、填写凭证:将上一步获取的AppID与AppSecret,准确填入对应的输入框。
4、获取Webhook:点击「注册」按钮。系统将生成一个唯一的Webhook URL,请立即点击“复制”按钮保存该地址。
七、配置飞书事件回调
此步骤用于建立飞书与WorkBuddy之间的双向通信链路。
配置事件订阅
1. 返回飞书开放平台的应用详情页。
2. 进入左侧「事件与回调」菜单。
3. 在「订阅方式」中,选择「将事件发送至开发者服务器」。
4. 将WorkBuddy生成的Webhook地址,粘贴到“请求地址”栏。
5. 点击「保存」。
添加消息接收事件
在「事件配置」区域,点击「添加事件」,搜索并添加「接收消息」事件,确保机器人能监听用户消息。
配置卡片回调
如需实现交互式卡片功能,须额外配置:
1. 切换至「回调配置」页签。
2. 搜索并找到「卡片回传交互」。
3. 点击「确认添加」完成配置。
八、发布应用
完成配置后,需发布应用以供企业内使用。
1、创建版本:点击页面上方的「创建版本」按钮。
2、填写版本信息:
版本号:例如 1.0.0
版本描述:可备注“支持WorkBuddy自动化集成”
3、点击「确定」完成版本创建。
4、发布版本:在版本列表中找到刚创建的版本,点击其右侧的「发布」按钮。
5、提示:企业自建应用通常自动过审。如需人工审批,请联系企业超级管理员处理。
九、开始使用
集成现已完成,可开始测试与使用。
1、找到机器人:在飞书客户端(桌面或移动端)的搜索框中,输入您的应用名称进行搜索。
2、开始对话:点击搜索结果中的机器人,进入聊天界面。也可在应用目录中找到并「打开应用」。
3、发送任务:直接向机器人发送指令。例如,输入“创建一个项目甘特图”。WorkBuddy将接收指令并在本地执行相应自动化任务,最终将结果返回到当前飞书会话中。


















