云计算百科
云计算领域专业知识百科平台

个人微信API消息发送体系:按内容形态的发送接口选用与调度设计

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */
#content_views .toc,
/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */
#content_views.markdown_views > p:empty:has(+ .toc),
#content_views.markdown_views > .toc + p:empty,
/* 富文本旧版目录标记 */
#content_views.htmledit_views #main-toc,
#content_views.htmledit_views #hr-toc,
#content_views.htmledit_views p[id*=\”-toc\”] {
display: none !important;
}
/* 目录去掉后,紧跟的首个标题不再多出一块上边距 */
#content_views.markdown_views > .toc + h1,
#content_views.markdown_views > .toc + h2,
#content_views.markdown_views > .toc + h3,
#content_views.markdown_views > .toc + h4,
#content_views.markdown_views > .toc + p:empty + h1,
#content_views.markdown_views > .toc + p:empty + h2,
#content_views.markdown_views > .toc + p:empty + h3,
#content_views.markdown_views > .toc + p:empty + h4 {
margin-top: 0 !important;
}

发送族是个人微信API里接口最多的能力族:文本、图片、文件、语音、链接各有一个接口,按内容形态硬性分工。本文讲五个接口各自的作用、选用决策与流水设计,核心是一张"内容形态到接口"的决策表。

背景痛点

客服场景里"给客户发资料"是最常见的动作,形态五花八门:一句话、一张截图、一份 PDF、一段语音说明、一个活动页链接。早期我们的发送逻辑是"猜接口"——同一个业务动作在不同分支里调了不同接口,没有统一决策层,改一处漏四处。

原理:按内容形态硬性分工

接口

作用

对应形态

sendText

发送文本消息

纯文字,含文件传输助手

sendImage2

发送图片消息

截图、图片素材

sendFileBase64

base64 编码发送文件消息

文档、压缩包等附件

sendVoice

发送语音消息

语音说明(格式按文档要求)

sendUrl

发送链接消息

活动页、文章页

分工是硬性的:内容形态决定接口,不存在"一个接口通吃"。选用决策要做在业务层,而不是散落在调用点。

核心实现:形态决策的统一收口

# 【仅演示,上线前对照官方文档校验】
def send_dispatch(wid, wc_id, payload):
if payload.kind == "text":
return send_text(wid, wc_id, payload.body) # 参数按文档接入
if payload.kind == "image":
return send_image(wid, wc_id, payload.body)
if payload.kind == "file":
return send_file_b64(wid, wc_id, encode_b64(payload.body))
if payload.kind == "voice":
return send_voice(wid, wc_id, payload.body)
if payload.kind == "link":
return send_url(wid, wc_id, payload.body)
raise ValueError("unsupported kind") # 不给默认值

send_dispatch 把形态到接口的映射收口到一个函数,所有业务调用点只声明"要发什么形态",不直接选接口。图片有 5M 上限、文件走 base64 编码、语音有格式前提——这些约束全部封装在对应分支内部,业务层无感。

踩坑:流水表没有消息类型维度

统一收口之前踩的坑:发送流水表只有"发送成功/失败"维度,没有消息类型字段。月度复盘想看"哪类内容客服最爱用",流水里拆不出来;想核对图片发送量与配额消耗的关系,也拆不出来——五类消息全混在"消息"一个概念里。整改:流水表补 message_type 字段(收口函数顺手写入),统计与配额对账都按类型分列。维度缺失的数据等于没采集,补字段的成本远低于重跑历史。

权衡:统一收口还是直接调用

维度

统一收口函数

业务点直接调用

约束封装

一处维护

各点自行处理

新增形态

改一处

改所有调用点

灵活性

决策集中

点上自由

收口是明显更优解,唯一的代价是收口函数成为单点——它要有自己的单测覆盖五个分支,这个成本一次性且很低。

总结

发送族五接口按内容形态硬性分工,选用决策收口到统一分发函数,约束(5M 上限、base64 编码、语音格式)封装在分支内。流水表必须带消息类型维度,复盘与配额对账都靠它。各接口参数与约束取值以 Eyun 开发文档为准。

赞(0)
未经允许不得转载:网硕互联帮助中心 » 个人微信API消息发送体系:按内容形态的发送接口选用与调度设计
分享到: 更多 (0)

评论 抢沙发

评论前必须登录!