企业微信客户朋友圈文案自动发布
> 通过企业微信「客户联系」API 实现客户朋友圈文案的自动生成与定时发布。
前置条件
- 企业微信权限：需在管理后台开启「客户联系」权限，且应用具有
客户联系相关权限 - 获取 access_token：本脚本使用企业微信的 corpId + corpSecret 获取 token
- 配置参数：在
scripts/wecom_moments.py中配置CORP_ID和CORP_SECRET
核心 API
所有接口通过 scripts/wecom_moments.py 封装的 Python 脚本调用，底层使用企业微信官方 REST API：
| 功能 | 接口 | 说明 |
|---|---|---|
| 创建群发任务 | /cgi-bin/externalcontact/add_msg_template |
创建客户朋友圈群发（文本+图片/链接/视频） |
| 获取群发结果 | /cgi-bin/externalcontact/get_group_msg_result |
查询发送结果（成功/失败/发送中） |
| 获取群发记录列表 | /cgi-bin/externalcontact/get_group_msg_list_v2 |
按时间范围查询历史群发记录 |
| 获取群发成员任务 | /cgi-bin/externalcontact/get_group_msg_task |
查询每个成员的发送情况 |
三种发布模式
① 客户朋友圈（需企微App确认）
python scripts/wecom_moments.py send --mode moment \
--text "今日推荐！" \
--images /path/to/img.jpg \
--users "LiuHong"
创建任务后，成员需在企微App确认发布，适合精细运营场景。
② 客户个人群发（直发）
python scripts/wecom_moments.py send --mode mass \
--text "【酒小二】今日特价商品已上线，快来看看吧~" \
--link-title "特价专区" --link-url "https://..."
直接下发到客户聊天，适合日常促销通知。
③ 客户群群发（直发）
# 发给指定客户群
python scripts/wecom_moments.py send --mode groupchat \
--text "各位群友，本周福利来啦！" \
--group-chats "wrXXXX,wrYYYY" \
--sender "LiuHong"
# 按客户群标签筛选
python scripts/wecom_moments.py send --mode groupchat \
--text "VIP群专享福利！" \
--tag-ids "etXXX" \
--sender "LiuHong"
# 发给所有有权限的客户群
python scripts/wecom_moments.py send --mode groupchat \
--text "各位群友早上好！" \
--images /path/to/morning.jpg \
--sender "LiuHong"
直接下发到客户群聊天，无需确认。
通用命令
# 📝 预览（不实际发送）
python scripts/wecom_moments.py send --mode groupchat --text "测试" --sender "LiuHong" --dry-run
# 🔍 查询群发结果
python scripts/wecom_moments.py result --msgid "msgXXXXXX"
python scripts/wecom_moments.py result --msgid "msgXXXXXX" --scope groupchat # 客户群结果
# 📋 查看历史记录
python scripts/wecom_moments.py list --scope moment # 朋友圈记录
python scripts/wecom_moments.py list --scope mass # 客户个人群发记录
python scripts/wecom_moments.py list --start "2026-05-01" --end "2026-05-29"
# 👥 查看各成员发送任务
python scripts/wecom_moments.py task-status --msgid "msgXXXXXX"
# 💬 查询朋友圈互动数据
python scripts/wecom_moments.py moment-task --moment-id "momXXXXXX"
AI 驱动的工作流
1. AI 生成文案 → 自动发布
用户说"帮我在朋友圈发一条促销文案"，AI 自动执行：
- 调用前端模型生成适配客户朋友圈的文案
- 询问用户确认文案内容（先确认再执行）
- 调用
send命令创建群发任务 - 反馈发送结果
2. 文案模板库管理
支持通过智能表或 JSON 文件管理文案模板（在 scripts/templates.json 中定义），包括：
- 促销活动类（限时折扣、满减、新品上市）
- 品牌宣传类（企业文化、荣誉资质）
- 日常互动类（节日问候、知识分享）
- 客户回馈类（会员日、积分兑换）
3. 定时自动发布
配合 OpenClaw cron 或系统 crontab，实现定时自动发布：
# crontab 示例：每天上午10点发布早安朋友圈
0 10 * * * cd /path/to/skill && python scripts/wecom_moments.py send --text "早安！今日推荐..." --images /path/to/daily.jpg
# crontab 示例：每周五下午发布周末促销
0 15 * * 5 cd /path/to/skill && python scripts/wecom_moments.py send --text "周末特惠来啦！" --link-title "周末专场" --link-url "https://..."
4. AI+定时组合
AI 根据日期、天气、销售数据等自动生成差异化文案，通过 cron 定时执行：
- AI 预设下周每日文案到发布计划表
- cron 定时触发执行
- 发布后自动查询结果，汇总报告
脚本命令参考
用法: wecom_moments.py <command> [options]
命令:
send 创建客户朋友圈群发任务
result 查询群发任务结果
list 查询历史群发记录
task-status 查询群发成员任务状态
send 选项:
--text TEXT 文案内容（必填，最多2000字）
--images PATH 图片路径（可多次指定，最多9张）
--link-title STR 链接标题
--link-url URL 链接地址
--link-pic URL 链接封面图
--miniprogram-appid 小程序appid
--miniprogram-title 小程序标题
--miniprogram-page 小程序页面路径
--tag-ids LIST 客户标签ID列表（逗号分隔）
--sender STR 发表成员userid（不传则全部成员）
--dry-run 仅预览不实际发送
result 选项:
--msgid STR 群发消息ID（必填）
list 选项:
--start DATE 起始日期（默认7天前）
--end DATE 结束日期（默认今天）
task-status 选项:
--msgid STR 群发消息ID（必填）
--limit INT 返回数量（默认1000）
注意事项
- 访问令牌：脚本会自动刷新 access_token，无需手动管理
- 发送限制：同一企业一个月内最多给同个客户发送4条朋友圈
- 审核机制：朋友圈内容将遵循企业微信内容审核规则
- 仅支持服务商/认证企业：需要企业微信已认证且有相关权限
- 图片要求：支持jpg/png，单张不超过2MB，最多9张
- 文案长度：不超过2000个字符
