/* 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 开发文档为准。
网硕互联帮助中心




评论前必须登录!
注册