飞书 Skill 开发入门指南：从零搭建你的第一个机器人应用

4次阅读

没有评论

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

飞书 Skill 是基于飞书开放平台开发的机器人应用，可以接收用户消息并作出智能响应。典型的应用场景包括：

自动回复常见问题
处理审批流程
集成第三方服务
团队协作辅助工具

首先需要在飞书开放平台注册开发者账号。

登录飞书开放平台
进入开发者后台
点击 ” 创建应用 ”
填写应用基本信息
记录下 App ID 和 App Secret

飞书机器人需要特定权限才能正常工作。最常见的几个权限：

获取用户发给机器人的单聊消息
发送消息
获取用户基础信息

以下是 Node.js 实现的完整示例：

const express = require('express');
const crypto = require('crypto');

const app = express();
app.use(express.json());

// 替换为你的应用配置
const APP_ID = 'your_app_id';
const APP_SECRET = 'your_app_secret';
const VERIFICATION_TOKEN = 'your_verification_token';

// 处理飞书事件回调
app.post('/webhook', (req, res) => {
  // 1. 验证签名
  const signature = req.headers['x-lark-signature'];
  const timestamp = req.headers['x-lark-request-timestamp'];
  const nonce = req.headers['x-lark-request-nonce'];

  const baseString = `${timestamp}\n${nonce}\n${JSON.stringify(req.body)}`;
  const hash = crypto.createHmac('sha256', VERIFICATION_TOKEN)
    .update(baseString)
    .digest('hex');

  if (hash !== signature) {return res.status(403).send('Signature verification failed');
  }

  // 2. 处理不同类型的消息
  const {challenge, event} = req.body;

  // 处理验证请求
  if (challenge) {return res.json({ challenge});
  }

  // 处理消息事件
  if (event && event.message) {
    // 这里简单实现一个 echo 机器人
    const reply = {
      msg_type: 'text',
      content: {text: ` 你发送了: ${event.message.content.text}`
      }
    };

    // 3. 构造响应
    return res.json(reply);
  }

  res.status(200).send('OK');
});

app.listen(3000, () => {console.log('Server running on port 3000');
});