一、两条路：接口路与界面路

把内容送进公众号，有两条完全不同的路：

二、接口路：四步舞

一次完整的建草稿，是四个动作按顺序做：

① 换票   获取 access_token（拿 AppID + AppSecret 去换一张两小时有效的通行证）
            │
            ▼
② 传封面 上传封面图到【永久素材】，拿到 thumb_media_id
            │
            ▼
③ 传正文图（如果正文里有图）上传到微信图床，把 HTML 里的 src 换成返回的地址
            │
            ▼
④ 建草稿 调 draft/add，把标题/摘要/正文/封面/media_id 一起交上去
            │
            ▼
        拿到草稿 media_id → 去后台【草稿箱】就能看到

四步里有三个容易忽略的点：

1. ① 的票有两小时有效期，要缓存复用。 每次都重新取票，会浪费调用次数，还可能被限流。做法是：取一次存起来，快过期了再取；
2. ② 必须是【永久素材】，不能用【临时素材】。 用错了会报错（见第五节的错误码 40007），而且错误提示很不直观；
3. ③ 正文里的每一张图都要单独上传。 接口不接受外链图，这是 3.4.3 那个【坑三】在接口侧的对应版本。

三、参数硬限制：一张必须背下来的表

接口对字段有硬性的长度与格式限制。超一个字，整个请求失败：

两条实用经验：

• 正文字符数是【转成 HTML 之后】算的。 一段 2000 字的 Markdown 文章，转成带内联样式和图片标签的 HTML 后，字符数可能是原文的两三倍——长文要留意这个上限；
• 标题 64 字是【接口上限】，不是【推荐值】。 公众号的推送卡片宽度有限，标题超过一定长度就会在卡片上被截断，读者看不到后半句。

四、错误码：四个最常遇到的

调用接口失败时，微信返回的是一串错误码。下面四个覆盖了绝大多数情况：

五、⚠️ 2026 现状：发布权限已被收回——而这正是本章想要的

这是本节最重要的一条现状，它把本章的设计从【谨慎】变成了【必然】：

自 2025 年 7 月起，微信官方已回收【个人主体账号】与【未认证企业账号】的 freepublish（提交发布）接口权限。

所以当前的权限格局是这样：

这张表恰好说明了三件事：

1. 本章的流程【机器建草稿、人点发布】，不是保守，而是接口权限本来就这样——约束与现状完全吻合；
2. 对个人号来说，draft/add 就是这条路的终点。这一步之后，发布只能人在后台点；
3. 对认证号来说，接口上是可以继续走的，但请不要走——理由在 3.1：自动发布落在平台打击【AI 托管运营】的范围内，而且 AI 生成内容需要人确认并主动声明。

六、【AI 生成内容声明】放在哪

这是本章唯一一个【法规要求但接口里没有对应字段】的东西。接口的请求体里没有【声明】这一项，所以要分两个落点：

七、密钥安全：三条不能破的规矩

AppSecret 是你公众号的钥匙。泄露的后果是：别人可以以你的名义建草稿、发消息、调用你的接口。 三条规矩：

并且配合两条：

• 后台的 IP 白名单一定要开——它是密钥之外的第二道门；
• 定期更换密钥，尤其是在换电脑、共用过代码、人员变动之后。

八、动手 Demo：建草稿前的安全预检

为什么要有这一步：接口调用的失败是整批失败的——一行数据有问题，整个请求返回错误。所以在真正提交之前，把所有字段按硬限制过一遍，比【提交失败再重试】划算得多。

下面这段代码可以直接跑。它做三件事：① 按硬限制预检；② 干跑（把要提交的请求体组装出来但不发送）；③ 检查流程文件里有没有明文密钥。

# -*- coding: utf-8 -*-
"""3.4.4 Demo：建草稿前的安全预检（dry-run，真发之前先核对）"""
import json
import re

TITLE_MAX, DIGEST_MAX, CONTENT_MAX = 64, 120, 100000
IMG_OK = "mmbiz.qpic.cn"


def precheck(row):
    p = []
    title = row.get("title", "").strip()
    if not title:
        p.append("标题为空")
    elif len(title) > TITLE_MAX:
        p.append("标题 %d 字，超 %d 字上限" % (len(title), TITLE_MAX))

    digest = row.get("digest", "").strip()
    if not digest:
        p.append("摘要为空（平台会截正文开头，效果差）")
    elif len(digest) > DIGEST_MAX:
        p.append("摘要 %d 字，超 %d 字上限" % (len(digest), DIGEST_MAX))

    content = row.get("body_html", "")
    if len(content) > CONTENT_MAX:
        p.append("正文 %d 字符，超 %d 上限" % (len(content), CONTENT_MAX))
    for src in re.findall(r'<img[^>]+src="([^"]+)"', content):
        if IMG_OK not in src:
            p.append("正文图片非微信图床：%s（发布后变裂图）" % src[:36])
            break

    cover = row.get("cover_path", "")
    if not cover.lower().endswith((".jpg", ".jpeg")):
        p.append("封面图必须是 JPG，当前：%s" % (cover or "（空）"))

    if row.get("ai_declare") != "已确认":
        p.append("AI 生成内容声明未确认（法规要求，必须人工确认）")
    return p

实际运行输出（真跑，不是示意）：

==================================================================
建草稿前安全预检（dry-run）
==================================================================
[通过] id=001  → 可以进 draft/add
[阻断] id=002
        - 标题 70 字，超 64 字上限
[阻断] id=003
        - 摘要 140 字，超 120 字上限
[阻断] id=004
        - 正文图片非微信图床：https://cdn.example.com/a.png（发布后变裂图）
[阻断] id=005
        - 封面图必须是 JPG，当前：cover_005.png
[阻断] id=006
        - AI 生成内容声明未确认（法规要求，必须人工确认）
[阻断] id=007
        - 正文 100007 字符，超 100000 上限
------------------------------------------------------------------
通过 1 行，阻断 6 行

==================================================================
干跑：id=001 将要提交的请求体（不含真实 token）
==================================================================
{
  "articles": [
    {
      "title": "玄关收纳：我家最后只留下三件东西",
      "author": "波仔",
      "digest": "把玄关收拾成只剩三件东西的清爽空间，先减后加，量好尺寸再买。",
      "content": "<p style=\"font-size:15px;\">玄关永远堆着鞋和快递盒。</p><img src=\"https://mmbiz.qpic.cn/mmbiz_jpg/xxx/0?wx_fmt=jpeg\">",
      "thumb_media_id": "「上传封面后回填」",
      "show_cover_pic": 1,
      "need_open_comment": 0,
      "only_fans_can_comment": 0
    }
  ]
}
  ...（正文略，共 104 字符）

==================================================================
密钥卫生检查：流程文件里有没有明文 AppSecret
==================================================================
  [X] 发现疑似明文密钥：7f3a9c2e…
  → 必须移到环境变量或凭据管理里，不能写进流程文件

读结果，四个值得注意的地方：

1. 七行数据里六行被拦住——这说明硬限制不是理论上的东西，它是每天都会踩的。而且每一条被拦的原因都不一样（长度、图床、格式、合规、上限），说明预检项要一项不落；
2. id=006 被拦的原因是【AI 声明未确认】而不是任何技术问题——合规项和技术项在同一条流水线上，用同一种方式拦停。这是本章设计的一个特征；
3. 干跑的输出里 thumb_media_id 是占位符——干跑的意义就在这：在真正上传封面之前，先把请求体的骨架打出来核一遍，结构错了不用等接口报错就知道；
4. 密钥检查抓到了明文密钥——注意它不是靠报错发现的，而是主动扫出来的。这一类问题不会让流程失败，只会让流程【悄无声息地危险】。

九、备选方案：界面路怎么做

如果你没有认证公众号（或者暂时不想配 AppID／IP 白名单），可以走界面路：

① RPA 打开公众号后台 → 内容管理 → 草稿箱 → 新的创作 → 图文消息
② 填【标题】输入框
③ 填【作者】
④ 把 3.4.3 转换好的 HTML 放进剪贴板的 HTML 槽位 → 在正文区粘贴
⑤ 上传封面图（后台有上传控件）
⑥ 检查一遍 → 存为草稿

界面路的三个注意点：

1. 正文粘贴必须走【富文本】——把 HTML 当纯文本打进去，你会看到满屏尖括号（3.4.3 第三节讲过）；
2. 图片上传要用后台的控件，不要自己拼 HTML——让后台把图片传到它的图床，这比接口路里的【手动上传正文图】省事；
3. 每一步之后都要【回读校验】——界面的失败是静默的（粘贴没成功、图传了一半），不回读你发现不了。

30 秒实验

假设你手上有一个认证过的服务号（所以 freepublish 权限是有的），问你一个问题：

你会不会把流程做成【自动发布】？

答案：不要。 三个理由：

1. 合规：自动发布落在平台打击【AI 托管运营】的范围内（3.1）；
2. 法规：AI 生成合成内容应当由发布者主动声明——这个动作需要人；
3. 风险：发布是不可撤销的（草稿可以删，发出去的推文只能撤回，且已经被推到订阅者的消息列表里了）。

结论：有权限不等于应该用。 【能做到】和【应该做】之间隔着合规与风险判断——这是本章从头到尾都在强调的一件事。

常见误区

1. 【既然有接口，那就全自动发布】——错。 权限上（个人号已被回收）与合规上（AI 托管运营、AI 内容需人确认声明）都不成立。机器建草稿、人点发布，是本章的定盘星。
2. 【AppSecret 写在流程里方便，反正只有我自己用】——错。 流程文件会备份、会分享、会同步到云端。泄露 AppSecret 等于别人可以以你的名义操作公众号。 放环境变量或凭据管理，并且把 IP 白名单打开作为第二道门。
3. 【封面图随便传一张就行，PNG 更清晰】——错。 封面必须是 JPG／JPEG，且必须上传到永久素材（不是临时素材）。这两条都会导致调用失败，而错误提示未必直观。
4. 【正文里的图片可以用外链】——错。 接口只接受微信图床的地址；外链图在发布后会变成裂图。正文里每张图都要单独上传。
5. 【失败了重试就行，不用预检】——错。 接口调用是整批失败的：一行超长，整批返回错误。预先按硬限制过一遍，比反复重试划算得多——本节的 Demo 就是这件事。

• ☐ 下一节（3.5 本章小结）

相关笔记

• 排版 GPT 创作结果 —— 本节要提交的 HTML 从哪来，以及外链图的另一个版本
• 公众号创作智能助手场景概述 —— 两条红线与定盘星的出处
• RPA上传小红书 —— 上一章的出口（只能走界面），对照看接口路的差别
• 技术融合价值 —— 为什么要把 Agent 与 RPA 接起来
• 🤖 Agent+RPA实战 · 索引 —— 全课路线图