零成本搭建飞书机器人：基于 Webhook 的高效消息推送实践

为什么你需要一个飞书机器人

在日常工作中，通知需求无处不在。系统报警、任务提醒、审批结果反馈，这些场景如果依赖短信或邮件，往往面临成本高、实时性差的问题。飞书机器人提供了一种零成本且高效的替代方案。

记得去年负责 ERP 系统升级时，我们曾为关键业务流程的通知发愁。按每天 200 条短信计算，月成本就上千元。后来改用飞书机器人，不仅完全免费，还能支持富文本格式和精准的@提醒功能。

飞书机器人本质上是一个自动化程序，通过 Webhook 技术接收外部系统的 HTTP 请求，并将内容转发到指定的群聊中。这种机制特别适合企业内部系统与飞书的集成，比如运维报警、审批流程提醒、业务状态更新以及数据监控预警等。

5 分钟快速创建你的第一个机器人

创建过程非常简单，无需复杂开发经验。以电脑端操作为例，打开飞书客户端进入目标群聊，点击右上角的"..."菜单，选择"设置"并找到"群机器人"选项。点击"添加机器人"，在列表中选择"自定义机器人"。

填写名称和描述时，建议取个易识别的名字，例如"订单系统通知"或"服务器监控"。头像可以上传自定义图片，增加辨识度。创建完成后，最关键的一步是获取 Webhook 地址。在详情页面你会看到一个形如 https://open.feishu.cn/open-apis/bot/hook/xxxxxxxxxxxxxxxx 的 URL，这是机器人的唯一入口。

安全提示：这个地址相当于机器人的密码，务必妥善保管。一旦泄露，任何人都能向你的群聊发送消息。建议不要直接硬编码在脚本里，而是存储在环境变量或配置中心。

Webhook 消息发送实战指南

拿到 Webhook 地址后，就可以开始发送消息了。飞书机器人支持多种消息类型，最基础的是文本消息。下面分别用 Python 和 Node.js 演示如何构建请求。

Python 示例比较直观，使用 requests 库即可：

import requests
import json

webhook_url = "你的 Webhook 地址"
message = {
    "msg_type": "text",
    "content": {
        "text": "这是一条测试消息"
    }
}

resp = requests.post(webhook_url, json=message)
print(resp.status_code, resp.text)

这里要注意，json 参数会自动处理序列化，比手动拼接字符串更安全。如果返回状态码是 200，说明消息已成功推送到群聊。

如果你习惯使用 Node.js，逻辑也差不多，利用内置的 fetch API 或者 axios 都能轻松实现：

const webhookUrl = '你的 Webhook 地址';
const message = {
  msg_type: 'text',
  content: {
    text: '这是一条测试消息'
  }
};

fetch(webhookUrl, {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  : .(message)
})
.( res.())
.( .(data))
.( .(err));