BroadNet
期刊产品
产品

WhatsApp还是短信?如何在发送前选择通道,并在WhatsApp失败时进行自动回退

只有当接收者使用WhatsApp、已选择接收您的消息且能够接收时,WhatsApp消息才会送达;否则,Cloud API会报告错误,例如错误代码131026。本指南将向您展示如何根据接收者选择通道、解读Meta的送达错误,并自动回退至短信。

9 分钟阅读
产品 · 期号 43
9 分钟阅读

接收者已在该平台选择接收您的消息且拥有可用的WhatsApp账号时,请通过WhatsApp发送;在其他所有情况下,请通过短信发送,或自动回退至短信。在WhatsApp Cloud API上,向无法接收消息的号码发送消息会触发错误131026,而您只能通过状态Webhook获知此信息,而非通过发送响应。可靠的模式是在用户选择接收(opt-in)时记录每位客户的通道许可,在发送前检查您在法律允许范围内的权限,并利用失败的WhatsApp状态触发短信。BroadNet通过一个带有明确回退规则的全渠道服务API来同时运行这两种通道。

核心要点

  • 错误131026意味着Meta无法送达消息。Meta列出了三个可能的原因:该号码不是WhatsApp号码、接收者尚未接受最新的条款,或者接收者使用的是旧版WhatsApp。
  • 成功的API响应仅意味着请求已被接受。送达情况稍后由状态Webhook报告:已发送、已送达、已阅读或失败,若失败则会附带错误数组。
  • 拥有WhatsApp账号并不意味着获得了向某人发送消息的许可:Meta的政策要求必须拥有该人员的号码及其接收您消息的许可。
  • 在24小时客户服务窗口之外,WhatsApp仅接受模板消息(否则会报错131047)。
  • 线路类型是首要筛选条件:发送到固定电话或免费电话号码的短信通常会失败,且仍需支付短信费用。
  • 在发送平台中,自动回退通常是最佳规则:首先在客户已选择的WhatsApp中进行,若状态为失败或未获得WhatsApp同意,则通过短信发送。

WhatsApp错误131026是什么意思?

在Meta的Cloud API错误参考中,131026表示“无法送达消息”。Meta给出了三个可能的原因:“收件人电话号码不是WhatsApp电话号码”、“收件人‘尚未接受新的服务条款和隐私政策’”,或者收件人“正在使用旧版WhatsApp”。Meta建议的解决方法是,通过“使用非WhatsApp通信方式”询问对方,以确认其能够向您的业务号码发送消息、接受最新条款或更新应用程序。

换句话说,131026是一个路由信号,而非您代码中的错误。对于一次性密码、送达通知或预约提醒,Meta所指的非WhatsApp方式通常是短信,且应当自动发送,而不是在提交支持工单后才发送。

为什么消息ID并不代表消息已送达?

发送是异步的。API接收请求并返回一个消息ID;后续发生的情况将通过您的Webhook通知。Meta的消息状态Webhook会报告以下值:

状态Meta描述操作指南
已发送消息已从Meta服务器成功发送等待送达或失败状态
已送达消息已成功送达WhatsApp用户的设备无需自动回退
已读消息已在用户设备的公开聊天窗口中显示无需自动回退
失败无法向用户设备发送或送达消息已读错误[]。code;对于有时效性的消息,请自动回退至短信

失败状态包含一个错误数组,其中包含数字代码、标题、详情字段以及指向错误参考的链接。请记录该代码及其对应的消息:它会告知您是应该重试、切换通道还是修复模板。同样的逻辑也适用于短信,其中来自运营商的状态报告(DLR)起到了状态Webhook的作用。

仅仅因为对方拥有WhatsApp账号,就可以向其发送消息吗?

不。WhatsApp Business消息政策规定,您“仅在满足以下条件时,方可通过WhatsApp联系人员:(a)他们已向您提供其手机号码或用户名;且(b)您已获得收件人的选择性加入(opt-in)许可,确认其希望接收您后续发送的消息或通话。”此外,您还必须尊重任何在WhatsApp上或WhatsApp之外提出的停止接收请求。

因此,渠道选择始于选择性加入阶段,而非发送阶段。请询问客户他们接受哪些渠道,将该选择连同时间戳一起存储,并且仅通过他们同意的渠道进行发送。当地法律还会在此基础上增加额外的规则:请参阅我们的阿联酋PDPL短信与WhatsApp营销指南以获取示例。

关于24小时窗口期和错误代码131047呢?

自由格式的WhatsApp消息仅允许在客户最后一次向您发送消息后的24小时内发送。超出此时间后,Cloud API会返回131047,“自收件人最后一次回复发送者号码以来已超过24小时”,而Meta的解决方案是“改为向收件人发送模板消息”。请参阅什么是WhatsApp 24小时窗口期。

对于自动回退设计,这意味着两种不同的故障:131047可通过切换至WhatsApp上的已批准模板来解决,而131026则通过切换渠道来解决。在您的重试逻辑中应区别对待它们。

您应该首先使用哪个通道?

每个市场并没有统一的答案;这取决于消息内容以及每位客户所同意的内容。针对每位收件人的规则集涵盖了大多数情况:

场景首选通道自动回退
客户已订阅WhatsApp并曾向您发送过消息WhatsApp(24小时窗口期外的模板)状态为失败时的短信
客户已订阅WhatsApp,尚无历史记录WhatsApp模板状态为失败或在您的时限内未收到状态的短信
未记录WhatsApp同意短信在支持的情况下为OTP提供语音服务
之前的WhatsApp消息发送失败,错误代码131026短信请客户在下次联系时确认其WhatsApp
号码为固定电话或免费电话非短信:通常会失败语音通话,或索取手机号码
客户已选择接收RCS、Telegram或Viber您可以发送消息的通道短信

如需查看分市场视图(以WhatsApp、RCS或短信为主),请阅读我们的 短信vs WhatsApp vs RCS通道指南。

发送前可以检查哪些内容?

首要检查项并非针对应用程序,而是线路类型。向固定电话或免费电话号码发送短信通常会失败,但仍会产生短信费用。MobileValidate 是一个处于私人预览阶段的BroadNet品牌,可返回线路类型、当前运营商,以及针对携号转网号码的原始运营商;BroadNet HLR查询 则增加了实时网络状态,告知您该线路当前是否可达。

对于已选择其他通道的客户,MobileValidate还可以实时检查其号码是否已在Telegram、Viber或Zalo上注册,并在批量任务中检查Signal、iMessage、RCS、LINE或Botim;RCS检查在可用时会报告手持设备平台。其可接受使用政策将此类检查限制在防范欺诈以及为已选择接收消息的联系人进行通道选择的范围内。完整的检查列表请参见 mobilevalidate.com。MobileValidate是一项独立服务,不隶属于、不代表也不赞助其所检查的平台;使用这些名称仅是为了描述检查所涵盖的内容。

对于WhatsApp本身而言,可靠的信号是Meta提供给您的:客户自身的订阅确认、他们的回复,以及您上一条消息的送达或失败状态。请为每位客户存储最后一次WhatsApp的结果,并以此指导下一次发送。

BroadNet如何处理自动回退?

BroadNet是官方Meta业务解决方案提供商,并在一个平台上运行WhatsApp Business API、短信、RCS和语音。通过全渠道服务API,只需一个请求即可在短信、WhatsApp、RCS和语音之间应用明确的自动回退规则,并返回统一的状态报告,因此在您的应用程序中无需额外代码,即可将失败的WhatsApp状态转换为短信。

  • 对于一次性密码,OTP API可通过短信、WhatsApp、语音和闪呼进行自动回退发送;MyOTP.App通过一个账户即可覆盖短信、WhatsApp和Telegram。
  • 为时效性消息设置时间限制:如果既没有收到送达报告也没有收到失败报告,则发送自动回退消息。
  • 为您可能在24小时窗口之外需要的每种消息类型保留已获批的模板。
  • 在收到131026后,在客户再次确认之前,请屏蔽该客户的某个通道,以免为重复的失败支付费用。

如需了解更多模式,请阅读我们的多渠道故障转移策略。

针对每个接收者的通道检查清单是什么样的?

  1. 在用户选择加入(opt-in)时,记录客户接受的渠道、日期以及他们同意的文本内容。
  2. 检查新号码的线路类型;如果识别为固定电话或免付费电话,请要求提供移动号码。
  3. 应根据客户的同意记录和历史记录选择首选渠道,而不仅仅是根据国家默认设置进行选择。
  4. 在24小时窗口期之外,仅发送WhatsApp模板。
  5. 监听状态Webhook和状态报告;将失败和超时视为自动回退的触发条件。
  6. 对于有时效性的消息,自动回退至短信,并随消息记录WhatsApp错误代码。
  7. 每周审查失败情况:如果某个分段中131026错误上升,通常意味着号码失效或缺少用户同意。

常见问题

WhatsApp错误码131026是什么意思?

“无法送达消息。” Meta列出了三个可能的原因:该号码不是WhatsApp号码,收件人尚未接受最新的服务条款和隐私政策,或者收件人使用的是旧版WhatsApp。

对于因131026错误而发送失败的消息,我应该重试吗?

不要立即在WhatsApp上重试。请改用短信发送有时效性的内容,并通过其他渠道要求客户确认其WhatsApp号码。

来自WhatsApp API的200响应是否意味着消息已送达?

不。这仅意味着请求已被接受。送达情况将通过状态Webhook报告为已发送、已送达、已阅读或失败。

如果我知道客户拥有账号,我可以在WhatsApp上向其发送消息吗?

不可以。Meta的政策要求用户必须向您提供其号码,并同意(opt-in)在WhatsApp上接收来自您企业的消息。

错误代码131047是什么意思?

距离客户最后一次回复已超过24小时。请发送已获批的模板消息,而非自由格式消息。

WhatsApp的备用通道应该是哪个渠道?

大多数情况下是短信,因为它能触达任何移动号码。对于一次性密码,在平台支持的情况下,语音是进一步的备用方案。

我可以在发送前检查号码吗?

可以,但须在您的法律依据范围内。请先检查线路类型;对于已选择接收消息的客户,MobileValidate可以通过Telegram、Viber和RCS等应用检查注册情况,且BroadNet HLR Lookup可提供实时网络状态。

BroadNet如何发送短信回退?

Omnichannel API可在单次请求中应用您的回退规则,且OTP API会在短信、WhatsApp、语音和闪呼之间自动回退。

我们于2026年9月27日阅读了以下所有来源。请参阅我们的编辑标准。

来源

这篇文章对您有帮助吗?

我们如何撰写和审核内容

作者:

BroadNet编辑团队

编辑团队负责发布BroadNet博客。文章由BroadNet的监管事务、产品、工程、行业研究及运营商解决方案团队共同撰写,并根据我们的编辑标准进行审核。

通过电子邮件订阅期刊

每月一篇文章。 仅此而已。

订阅后,每当有新的内容(工程、监管或行业动态)发布时,我们都会第一时间发送给您。没有滴灌式营销,没有产品推销,不会与第三方共享。点击一下即可退订。

我们每月发送一封电子邮件。您可以随时退订。查看我们的 隐私政策.

您将获得的内容
  • 深度长文,拒绝标题党
    针对单一主题,提供六至十一分钟的深度阅读体验。
  • 由一线运营团队撰写
    由内部工程师、监管负责人和产品专家亲自执笔。
  • 立足区域
    关于中东及北非地区监管机构、运营商及通道组合的深度见解。
  • 每月一次
    不进行滴灌式营销。仅在有干货分享时发布文章。
停止阅读,开始交付。

我们所写的大部分内容都源于实战经验。

如果这篇文章引起了您的共鸣,我们或许应该聊聊。请带上您的应用场景、业务量和目标市场——我们将为您提供通道方案、价格体系以及可供您致电咨询的参考客户。

$ curl -X POST https://api.broadnet.me/sms/sendSms