飞书Skill开发实战指南：从零构建高效机器人服务

2次阅读

共计 2426 个字符，预计需要花费 7 分钟才能阅读完成。

在企业 IM 场景下，传统的消息处理方式通常依赖人工监控或简单的自动化脚本，存在以下问题：

响应速度慢：人工处理消息延迟高，无法满足实时性要求
扩展性差：难以应对复杂的业务逻辑和流程自动化需求
维护成本高：需要专门人员持续监控和干预

飞书 Skill 通过提供标准化的机器人开发框架，完美解决了这些问题：

支持实时消息事件订阅和处理
提供丰富的 API 接口和企业数据权限
具备完善的鉴权和安全管理机制

特性	飞书 Skill	普通 Webhook
鉴权机制	多重验证（VerificationToken+EncryptKey）	通常仅 Basic Auth 或简单 Token
消息协议	标准事件格式（含消息元数据）	自定义格式居多
权限控制	细粒度权限申请和审批	通常全有或全无
开发支持	官方 SDK 和开发者工具	需要自行实现

登录飞书开放平台
创建自建应用
在 ” 功能 ” 菜单启用机器人能力
配置权限并申请发布

注意：生产环境需要提交应用审核，测试阶段可使用企业自用模式

核心安全参数处理要点：

VerificationToken：用于验证请求来源，应存储在环境变量中
EncryptKey：启用消息加密时需要，需妥善保管

Python 初始化示例：

from lark_oapi import Config

config = Config.builder(\
    app_id="your_app_id",\
    app_secret="your_app_secret"\
).build()

Node.js 初始化示例：

const {Client} = require('@larksuiteoapi/node-sdk');

const client = new Client({
  appId: 'your_app_id',
  appSecret: 'your_app_secret',
});

Python 完整实现：

import hashlib
from flask import Flask, request, jsonify

app = Flask(__name__)
VERIFICATION_TOKEN = "your_token"

@app.route("/webhook", methods=["POST"])
def webhook():
    # 1. 验证签名
    signature = request.headers.get("X-Lark-Signature")
    timestamp = request.headers.get("X-Lark-Request-Timestamp")
    nonce = request.headers.get("X-Lark-Request-Nonce")

    verify_str = f"{timestamp}{nonce}{VERIFICATION_TOKEN}".encode('utf-8')
    if hashlib.sha256(verify_str).hexdigest() != signature:
        return "", 403

    # 2. 处理消息
    data = request.json
    if data.get("type") == "url_verification":  # 飞书验证请求
        return jsonify({"challenge": data["challenge"]})

    # 3. 解析 @mention 消息
    event = data.get("event")
    if event and event.get("mention"):
        open_id = event["sender"]["sender_id"]["open_id"]
        message_id = event["message"]["message_id"]

        # 4. 异步回复（示例）reply_message = {
            "msg_type": "text",
            "content": {"text": f"<at user_id=\"{open_id}\"></at> 已收到您的消息"}
        }
        # 调用飞书 API 发送回复

    return "", 200

关键字段说明：

open_id：用户唯一标识
root_id：会话线程 ID
message_id：消息唯一 ID

使用 Redis 存储已处理事件的 message_id
设置合理的 TTL（建议 5 分钟）

遵循最小权限原则
分阶段申请权限
准备详细的权限使用说明

缓存 access_token（默认 2 小时有效期）
使用连接池管理 HTTP 客户端
异步处理耗时操作

进入应用管理后台
打开 ” 事件订阅 ” 测试工具
选择事件类型并触发

// 预请求脚本示例
const crypto = require('crypto');

const timestamp = new Date().getTime();
const nonce = Math.random().toString(36).substring(2);
const token = pm.environment.get("VERIFICATION_TOKEN");

const str = timestamp + nonce + token;
const signature = crypto.createHash('sha256').update(str).digest('hex');

pm.request.headers.add({
    key: 'X-Lark-Signature',
    value: signature
});
// 添加 timestamp 和 nonce 头...

飞书 Skill 与多维表格结合可以实现强大的自动化流程，例如：