企业微信客户朋友圈文案自动发布

> 通过企业微信「客户联系」API 实现客户朋友圈文案的自动生成与定时发布。

前置条件

1. 企业微信权限：需在管理后台开启「客户联系」权限，且应用具有 客户联系 相关权限
2. 获取 access_token：本脚本使用企业微信的 corpId + corpSecret 获取 token
3. 配置参数：在 scripts/wecom_moments.py 中配置 CORP_ID 和 CORP_SECRET

核心 API

所有接口通过 scripts/wecom_moments.py 封装的 Python 脚本调用，底层使用企业微信官方 REST API：

三种发布模式

① 客户朋友圈（需企微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 自动执行：

1. 调用前端模型生成适配客户朋友圈的文案
2. 询问用户确认文案内容（先确认再执行）
3. 调用 send 命令创建群发任务
4. 反馈发送结果

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 定时执行：

1. AI 预设下周每日文案到发布计划表
2. cron 定时触发执行
3. 发布后自动查询结果，汇总报告

脚本命令参考

用法: 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个字符