极简的微信消息通知接口怎么用

上个月服务器半夜磁盘写满，第二天早上才看到。

当时想的是「要是能直接推到微信就好了」。装个 APP 太麻烦，企业微信又要建群拉机器人，配置一堆。

后来用了息知（xz.qqoq.net），一行 URL 解决。

它到底是个什么东西

打开首页，介绍只有一句话：

一个极简的微信消息通知接口，只需一行代码就能立即将消息推送到你的微信。

用起来的实际形式是这样的：

https://xizhi.qqoq.net/{你的key}.send?title=标题&content=内容

微信扫码登录，拿到一个 key，把它拼进 URL，浏览器打开就能收到消息。

没有 SDK，没有依赖，不需要 access_token 换取流程。

和别的方案比

同样是「推消息到手机」，我试过三种：

企业微信群机器人 —— 要建群、加机器人、复制 webhook。能用，但每次换群要重新配，而且消息是推到群里，个人容易漏看。

Server 酱这类中转服务 —— 功能全，但免费额度有限，推送多了要付费，而且部分功能要绑定公众号。

息知 —— 直接推到你自己的微信，扫码即用。相对简单。

三者的本质区别在于：是推到「一个群」还是「你本人」。

告警这种场景，推给本人更合适。

三种用法

一、curl 一句话

最直接的方式，适合临时测试：

curl "https://xizhi.qqoq.net/你的key.send?title=测试&content=这是一条测试消息"

返回结果里能看到是否成功。

二、Shell 脚本里用

比如定时备份完成后通知：

#!/bin/bash
KEY="你的key"
URL="https://xizhi.qqoq.net/${KEY}.send"

# 备份
tar -czf /backup/site-$(date +%F).tar.gz /www/wwwroot/

# 通知
if [ $? -eq 0 ]; then
  curl -s "${URL}" -G \
    --data-urlencode "title=备份完成" \
    --data-urlencode "content=$(date +%F %H:%M) 备份成功，大小 $(du -h /backup/site-$(date +%F).tar.gz | cut -f1)"
else
  curl -s "${URL}" -G \
    --data-urlencode "title=备份失败" \
    --data-urlencode "content=$(date +%F %H:%M) tar 执行出错，请检查"
fi

扔进 crontab，每天跑一次。

注意用 -G 加 --data-urlencode，不然中文和空格会出问题。我第一次直接用拼字符串，标题里的中文变成乱码。

三、接监控

Uptime Kuma 支持自定义 webhook，可以直接把息知的 URL 填进去。

设置里选「HTTP(s)」类型的通知，URL 填：

https://xizhi.qqoq.net/你的key.send?title={STATUS}&content={MONITOR_NAME} {MSG}

这样站点挂了，微信直接响。

几个实际用法

我现在挂了这些：

磁盘告警 —— 超过 85% 推一次，每天最多推一次，避免刷屏。

USE=$(df / | awk 'NR==2 {print $5}' | tr -d '%')
if [ $USE -gt 85 ]; then
  curl -s "${URL}" -G \
    --data-urlencode "title=磁盘告警" \
    --data-urlencode "content=根分区已用 ${USE}%，请及时清理"
fi

部署完成 —— git pull 之后推一条，确认新代码上去了。

定时任务异常 —— 爬虫或者数据同步脚本跑失败时推。

几个要注意的

一、key 别泄露

拿到 key 的人都能往你微信推消息。写在脚本里的话，注意文件权限：

chmod 600 /root/notify.sh

或者把 key 放在单独的配置文件里。

二、别在循环里推

我一开始在遍历文件的循环里每条都推，结果手机响了一百多次。

正确做法是汇总后推一条，或者加个计数器，超过阈值才推。

三、消息别太长

微信通知栏只显示前几十个字。重要信息放标题，细节放内容。

适合什么人用

合适：

• 个人服务器、小项目，只需要「出事了告诉我」
• 不想装 APP、不想建群
• 脚本里要发通知，但不想接复杂的 SDK

不合适：

• 团队协作，需要多人同时收到 → 用企业微信或钉钉群
• 消息量大，需要保证送达 → 用专业告警平台
• 需要双向交互（点按钮处理） → 息知是单向推送

最后

这类工具的价值不在于技术多复杂，而在于把「配一个通知」的成本从半小时降到两分钟。

我现在的状态是：任何脚本写完后，顺手加两行 curl，跑完就推一条。以前懒得配，出问题了才想起来看日志。

工具的意义就在这——不是让你能做更多，是让你愿意去做。