前置条件
- 1已开通百度智能云千帆大模型平台，创建应用拿到 API Key 与 Secret Key
- 2有一个企业微信团队（可免费注册），或一枚已认证的公众号
- 3一台能跑 Python 3.9+ 或 Node.js 18+ 的服务器
- 4已安装 curl 或 Postman 用于调试 webhook
读完想动手？新用户首单 8 折上云
服务器 + 大模型 API + 对象存储，新用户首购享 20% 补贴
常见问题
Q个人微信能直接接入文心一言吗？
不能走官方通道。微信个人号没有开放的聊天 API，市面上的「微信机器人」多为逆向协议实现，违反微信软件许可协议，存在限制登录与永久封号风险。请改用企业微信群机器人 webhook 或公众号被动回复，二者均为官方支持路径。
Q千帆的 access_token 和公众号的 access_token 有什么区别？
两者完全不相干，别搞混。千帆 access_token 用于调用文心一言模型，有效期通常 30 天，通过 API Key 与 Secret Key 换取；公众号 access_token 用于调微信接口，有效期 7200 秒（2 小时），通过 AppID 与 AppSecret 换取。建议代码里分别命名为 qianfan_token 和 wx_token，避免复制粘贴时串线。
Q调用 ERNIE 4.5 返回 iam.ACCESS_TOKEN_INVALID 或 401 怎么办？
三种常见原因：一是用了网页端 Cookie 而不是千帆 API Key；二是 access_token 已过期（默认 30 天，很多人写死在配置里一个月后集体崩）；三是请求头格式用错。千帆 OpenAI 兼容模式用 Authorization: Bearer 加 token，原生模式则是把 token 拼在 URL 参数里，两种别混用。
Q企业微信群机器人为什么收不到 markdown 里的表格？
企业微信的 markdown 是受限子集，不支持标准表格语法，也不支持三个反引号的代码围栏，表格会被渲染成一坨竖线文本。解决方式是改用 text 类型发送纯文本表格（用空格对齐），或把表格转成「标题加分点列表」后再发。
Q公众号回复一直提示「该公众号暂时无法提供服务」？
微信服务器要求 5 秒内响应，而文心一言生成完整回答通常 4 到 9 秒，同步返回必然超时且不会重试。正确做法是收到消息后立即返回 success 占住连接，后台异步调模型，再用客服消息接口主动推送结果。
Q加签签名一直校验失败，但代码看起来没问题？
按顺序排查三件事：timestamp 必须是秒级（10 位）而不是毫秒（13 位）；拼接时中间只能有一个 LF 换行符，不能用 CRLF 或空格；base64 之后必须做 urlencode，否则签名里的加号、斜杠和等号会被 URL 解析器吞掉。另外服务器时间误差超过 1 小时会被判定为重放攻击。