优先级：--to（从注册表读取 url + chatid）> --url/--chatid > 环境变量

Webhook URL 获取

企业微信群 → 右上角「...」→ 群机器人 → 添加 → 复制 Webhook 地址

会话 ID (chatid) 说明

• - 默认行为：不指定 chatid 时，消息发送到创建机器人的群
• 指定会话：通过 --chatid 参数可发送到其他会话
• 获取方式：从群机器人回调事件中提取 chatid

会话注册表

支持通过名称发送消息，注册时绑定 webhook URL、chatid 和会话类型。

注册格式

name -> { url, chatid, chat_type }

• - chat_type: group（群聊，默认）或 single（私聊）

注册会话

bash

注册群聊（发送到 webhook 默认群）

注册群聊（发送到指定会话）

注册私聊（chat_type=single）

查看已注册

bash
bash scripts/list_chats.sh

输出示例：

已注册的会话 (3 个):
========================================
研发群:
类型: group
URL: https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=xxx
ChatID: (默认群)

告警群:
类型: group
URL: https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=yyy
ChatID: wrkSFfCgAAxxxxxx

张三:
类型: single
URL: https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=zzz
ChatID: wokSFfCgAAyyyyyy

删除注册

bash
bash scripts/unregister_chat.sh 研发群

注册表位置

默认：~/.wecom/chat_registry.json

可通过环境变量自定义：
bash
export WECOMREGISTRYFILE=/path/to/registry.json

消息类型对比

Markdown vs Markdown V2

选择建议：

• - 简单消息 → 用 markdown（轻量、兼容性好）
• 需要表格或代码块 → 必须用 markdown_v2

使用方式

所有脚本都支持 --to、--url、--chatid 参数。

文本消息

bash

通过名称发送（推荐）

通过 URL 发送（临时使用）

@ 指定成员（userid）

@ 所有人

Markdown 消息

bash
bash scripts/send_markdown.sh --to 研发群 ## 服务状态\nAPI: 正常\nDB: 正常

bash scripts/send_markdown.sh --to 研发群 $(cat report.md)

支持：# 标题、加粗、斜体、 代码 、链接、> 引用

Markdown V2 消息（表格）

bash
bash scripts/sendmarkdownv2.sh --to 研发群 ## 每日数据

图片消息

bash
bash scripts/send_image.sh --to 研发群 /path/to/screenshot.png

文件消息

bash
bash scripts/send_file.sh --to 研发群 /path/to/report.xlsx

示例：服务每日报告

bash
MSG=$(cat <

服务每日报告（2026-01-02）

整体概况

总请求: 68,019 | 活跃用户: 117 | 错误率: 0.02%

资源消耗 Top 3

1. 1. app-gen-code — 6,137 次，$567
2. app-tools — 635 次，$168
3. zhangsan — 1,066 次，$97

带表格的版本（使用 markdown_v2）：

bash
MSG=$(cat <

服务每日报告（2026-01-02）

典型工作流

bash

1. 首次使用：注册常用会话（绑定 webhook URL）