[避坑清单] 明道云工作流发短信最容易踩的8个坑（验证码/营销合规/失败排查全覆盖）

这段时间帮好几个明道云客户对接过短信场景，发现大家踩的坑高度重复。整理了 8 个最常见的问题，每个都配上为什么会踩和怎么解决，供大家自查。 --- ## 坑 1：验证码短信到达率低，客户总说收不到 为什么会踩： - 用了营销类通道发验证码（营销通道会有延迟和过滤） - 没做发送频控，60 秒内重复发多条，被运营商拦截 - 短信签名是新的，还没养好号，信誉分不够 怎么解决： - 验证码必须走专属验证码通道，不要和通知/营销混用 - 前端加 60 秒倒计时，服务端也要校验，防止恶意刷接口 - 新签名上线前先小流量养几天，再全量放开 - 建议加语音验证码作为兜底，用户连续两次没收到短信时自动触发语音 ## 坑 2：工作流触发了，但短信根本没发出去 为什么会踩： - 工作流节点配置没问题，但组织短信信用点余额不足了（明道云自带节点是扣信用点的） - 自定义代码块里调用第三方 API，超时了但没做异常捕获，任务默默失败 - 模板参数填错了，比如少传了变量，运营商直接拒绝 怎么解决： - 用自带节点的，留意信用点余额，设个低余额提醒 - 用代码块对接第三方的，一定要加 try/catch 和失败日志，把返回的错误码写回工作表 - 调试阶段先用少量测试号码跑通，确认每个模板参数都对得上再全量 ## 坑 3：营销短信大量被投诉，通道被封 为什么会踩： - 没有加退订字样（这是运营商硬性要求，营销短信末尾必须加回 TD/退订回 T） - 没做免打扰名单，用户退订过还在发 - 发送时间不对，大清早或者深夜发，投诉率飙升 怎么解决： - 所有营销/推广类短信，末尾必须加回 T 退订或类似提示，不加等于送人头 - 建立自己的退订名单库，退订用户永久不再发营销类（通知类可以发） - 营销短信发送时间控制在工作日 10:00-12:00、14:00-18:00，避开早晚和周末 ## 坑 4：私有部署客户用明道云自带短信节点不方便 为什么会踩： - 私有部署场景数据在客户自己服务器，走平台通道需要外网连通，有些客户内网有限制 - 客户对数据合规要求高，不希望短信内容经过第三方 怎么解决： - 私有部署客户建议直接对接本地短信网关或专属 API - 把短信发送做成一个独立的服务组件，工作流通过 webhook 或代码块调用，部署灵活 - 这块相对复杂，实施时可以找有私有化对接经验的伙伴一起做 ## 坑 5：发送记录查不到，客户来问只能说不知道 为什么会踩： - 只用了发送节点，没有配置回执回写 - 发送成功/失败的状态没存到明道云表里，客服查不到 - 第三方通道有回调，但明道云侧没开接口接收 怎么解决： - 设计一张独立的短信发送记录工作表，记录：手机号、内容、发送时间、状态、错误码、消息 ID - 不管用自带节点还是第三方对接，发送动作结束后都要写一条记录 - 对接第三方的，配好回调地址，让运营商把最终状态（送达/失败/拦截）回推到明道云 ## 坑 6：多个业务共用短信通道，成本算不清 为什么会踩： - 订单通知、回访邀约、验证码、内部提醒都走同一个通道，月底看账单不知道哪个部门花了多少 - 没有做按业务打标签，没法做成本分析 怎么解决： - 在发送记录表里加业务类型发起应用发送人员字段 - 不同业务用不同的模板 ID，月底按模板 ID 统计费用 - 做个简单的仪表盘看板，每个月各业务发了多少、花了多少一目了然 ## 坑 7：以为 0.05 元/条是底价，其实量大能便宜一半以上 为什么会踩： - 很多人第一次用明道云发短信，直接就用自带节点，用了几个月才发现量大时账单吓人 - 不知道市面上正规企业短信通道的价格，其实通知类量大能到 0.02-0.03 元/条 怎么解决： - 月发送量超过 3000 条的，认真算一下账，看值不值得换通道 - 对接第三方通道不算复杂，阿里云、腾讯云、华为云都有标准 API，代码块里调一下就行 - 不想自己对接的，市面上有封装好的服务，一般会包含通道管理、统计报表、失败重试，省事 ## 坑 8：模板审核被拒，反复提交都过不了 为什么会踩： - 模板里带了营销词汇但申请的是通知类 - 签名和企业资质不一致（比如签名叫 XX 商城，营业执照里没有这个品牌名） - 模板变量太多（一般变量不超过 3 个），或者变量位置放了不该放的内容 怎么解决： - 通知类模板严格只写通知内容，不要加任何营销话术和链接 - 签名要和营业执照主体或备案的品牌名一致，个人主体申请签名会比较麻烦 - 模板变量控制在 3 个以内，变量内容不要传完整句子，只传具体的短内容（如订单号、金额） --- ## 最后 短信这个东西看着简单，真用到业务里要踩的坑还挺多，尤其是合规、到达率、成本这三件事，一个没做好要么出事要么亏钱。 我自己做企业短信服务多年，验证码、通知、营销、国际短信这些场景都很熟，也帮不少明道云的伙伴搭过对接。上面这 8 个坑你遇到过哪个，或者你有别的坑想补充，欢迎在下面留言，大家一起讨论。 如果有具体的对接问题，比如代码块怎么写、模板怎么报备、通道怎么选，也可以留言问我，能答的我尽量答。后面考虑再整理一篇明道云代码块对接阿里云短信的完整代码示例，感兴趣的可以催更。