WhatsApp API 模板状态显示"Approved"且接口已返回消息 ID，但客户仍未收到消息。
对此，许多用户存在误区：认为模板审核通过即代表发送成功。
事实上，模板审核通过与消息成功送达是两个独立的环节。
审核通过仅表明 Meta 允许企业使用该模板。在实际发送过程中，WhatsApp 还会校验客户号码有效性、模板实时状态、用户近期互动情况、营销频率及接口参数等。
任一环节异常，均可能导致消息延迟或发送失败。
模板审核通过，为何消息仍发送失败？
WhatsApp 模板审核主要关注内容合规性，包括：
-
模板分类准确性； -
变量与按钮格式规范性； -
内容是否违反平台政策； -
模板语言与实际内容的一致性。
模板状态为"Approved"仅代表其具备发送资格，并不保证对每位客户都能成功送达。
例如，同一营销模板发送给 100 名客户，可能 80 人正常接收，而另外 20 人因号码无效、近期接收营销过多或已拒绝接收而导致失败。
此类情况下，问题通常出在客户号码属性或具体发送环境，而非模板本身。
因此，排查时需结合单条消息的最终状态进行分析，而非仅关注模板审核结果。
API 返回消息 ID 是否代表发送成功？
不一定。
调用 WhatsApp Cloud API 后返回的 wamid，仅表示请求已被 WhatsApp 接收，消息可能仍在处理队列中，尚未到达客户终端。
最终状态需通过 Webhook 确认：
接口返回 HTTP 200 或消息 ID 仅代表请求提交成功。唯有收到"delivered"状态，方可确认消息真正送达。
若状态显示为"failed"，需进一步查看 Webhook 返回的错误代码。相比后台笼统的提示，错误代码能更精准地定位故障原因。
WhatsApp 模板已批准但发送失败的常见原因
客户号码无法正常接收
若 Webhook 返回错误码 131026，通常意味着消息无法投递至该号码。
常见原因包括：
出于隐私保护，若客户屏蔽企业，WhatsApp 通常不会明确告知，错误码131026仅提示无法送达。
建议优先检查号码国际格式（如中国大陆手机号应为8613812345678）。使用 Cloud API 发送时，号码应仅保留数字，去除"+"、空格、括号及国内拨号前缀。
若多数客户接收正常仅少数失败，问题多源于特定客户的号码或账号状态。
触发营销消息发送限制
发送 Marketing 类模板若返回 131049，表明 WhatsApp 暂时限制向该客户投递营销信息。
即便模板已过审且客户曾授权，仍可能出现此情况。WhatsApp 不仅考量当前企业的发送量，还会综合评估客户近期接收的整体营销频次及其互动行为（阅读、回复或忽略）。
其他企业发送给该客户的营销内容，亦可能影响本企业消息的送达。
由于 Meta 未公开具体的阈值算法，难以通过固定规则完全规避。
遇到 131049时，切勿频繁重发。建议至少等待 24 小时，并依据客户近期的咨询、点击或购买行为判断是否继续触达。
若大量非活跃客户出现此错误，应调整目标人群与发送频率，而非重新提交模板。
用户主动停止接收营销消息
返回 131050表示客户已主动选择拒收该企业营销消息。
其与 131049的区别在于：
-
131049：系统暂时性限制投递； -
131050：客户主动退订。
出现 131050后，企业应立即停止向该客户发送营销模板，并在系统中记录退订状态。
即便此前获得过授权，也不得继续使用。若客户未来重新订阅，需重新记录有效授权信息。
新模板处于质量观察期
新建或修改后的营销模板可能不会立即全量发送。WhatsApp 会先对小部分客户进行试投，监测阅读、回复、屏蔽或举报情况，以此决定是否扩大发送范围（即 Template Pacing 机制）。
若首批表现良好，后续将正常发送；若遭遇大量屏蔽或举报，模板可能被暂停，剩余消息发送失败。
因此，新模板上线初期不宜直接全量群发。
建议先筛选近期有互动的客户进行测试，观察各项指标后再逐步扩大范围。
若返回 132015，通常意味着模板已被暂停。此时继续调用无效，需优先检查模板质量与状态。
模板通过后被暂停或禁用
模板审核通过并非永久有效。WhatsApp 会根据后续用户反馈持续评估质量，已通过的模板也可能被暂停或禁用。
部分第三方平台显示"Active"仅代表当前可用，但在 Meta API 中标准状态为"Approved"。
大型营销活动前，务必复核模板的实时可用性。
若某模板突然大面积失败而其他正常，应优先排查该模板的状态变更。
模板参数与审核版本不一致
部分发送失败源于请求参数与审核版本不匹配，尽管后台显示正常。
常见问题包括：
-
模板名称错误； -
语言代码不一致； -
变量数量或顺序错误； -
Header 媒体文件无法访问； -
按钮参数结构不符； -
使用了错误的 WABA 或模板版本。
例如，审核版本为 en_US，请求却填写 en，系统将无法匹配。
若模板含两个变量，请求必须提供两个对应参数且顺序一致。审核通过不会自动修正 API 请求错误。
此类问题通常返回 132000、132001或 132012等错误码，可通过 Webhook 详情定位。
模板被重新归类为 Marketing
WhatsApp 模板分为 Marketing、Utility 和 Authentication 三类。
订单、物流、付款提醒属 Utility；优惠、新品推广属 Marketing。
若在 Utility 模板中加入折扣、推荐等促销内容，Meta 可能将其重分类为 Marketing，导致受限、收费变化或送达率下降。
若原用于通知的模板频繁出现 131049，请检查：
-
模板分类是否变更； -
正文是否包含促销信息； -
按钮是否跳转至营销页面； -
是否混入无关商品推荐。
建议将通知类与营销类模板分开制作，避免内容混用。
WhatsApp 模板消息常见错误代码
以下为常见错误码速查汇总，建议保存以便快速排查。
注：错误代码可能随 API 版本及政策调整而变化，实际排查请以 Webhook 完整信息及 Meta 官方文档为准。
模板消息发送失败排查思路
发现发送失败时，应先分析失败分布，而非盲目重提模板。
仅少数客户发送失败
若大部分正常仅少数失败，优先检查号码格式、账号状态及是否出现 131026、131049或 131050。此类情况通常与企业账号或模板整体无关。
仅单一模板发送失败
若其他模板正常，仅某一模板失败，重点排查：
-
模板状态是否仍为 Approved； -
是否被暂停或禁用； -
模板分类是否变更； -
名称与语言代码是否正确； -
变量、按钮及媒体参数是否匹配审核版本； -
是否处于 Template Pacing 观察期。
单模板问题通常无需修改账号、Token 或 Phone Number ID。
所有模板大面积失败
若多模板同时失败，需检查上层配置：
-
WhatsApp Business Account 是否受限； -
Access Token 是否过期或权限异常； -
Phone Number ID 是否错误； -
WABA 或号码配置是否变更； -
BSP 或第三方平台服务是否异常； -
Meta 平台是否故障。
建议按以下顺序排查：
-
确认模板可用性； -
核对名称、语言及变量参数； -
保存接口返回的 wamid； -
在 Webhook 中定位对应消息； -
查看最终状态及详细错误信息； -
对比失败客户、模板及时间维度； -
判定问题来源（客户、模板、账号或接口）。
如何降低模板消息发送失败率？
发送前清洗无效号码
号码未注册、区号错误或格式不规范均会导致失败。若频繁出现 131026，应先检测号码质量。
建议使用专业工具的号码检测功能，批量验证联系人注册状态，提前清理无效数据，减少无效发送成本。
优先触达活跃客户
营销不应盲目追求数量。建议结合客户近期咨询、点击、回复或购买行为筛选名单，优先联系高意向客户，减少对静默用户的打扰。
利用标签功能（如客户来源、市场区域、购买记录等）精细分组，既能提升触达精准度，也能提高转化概率。
新模板小范围测试
新模板过审后，建议先小批次试投，监控送达率与互动数据。
若遇 131049，暂停至少 24 小时再评估；若遇 131050，则立即停止并记录退订。
分离管理通知与营销模板
Utility 模板（如订单、物流）应严格限定于交易相关内容。混入促销信息可能导致被重分类为 Marketing，影响计费与送达。
建议集中管理模板，将 Utility 与 Marketing 分类明确，避免因内容混用引发问题。
基于数据持续优化
消息发出后，除关注接口返回外，更需追踪实际送达情况及失败原因。
通过分析发送计划的成功率、失败明细及客户反馈，动态调整发送对象、时机与内容，将资源集中于高潜力群体，减少无效触达。
总结
模板过审却无法送达，不仅削弱营销效果，更可能导致商机流失。
相比盲目重试，更应前置检查号码质量、筛选活跃用户、规范模板管理，并依据数据反馈灵活调整策略。唯有将合适的内容精准推送给有需要的客户，方能最大化 WhatsApp 消息的转化价值。
