常见问题

更新时间:
复制 MD 格式

本文为您汇总了使用WhatsApp类型通道时的常见问题。

WABA注册界面的注册按钮灰色,不可点击?

为保证用户快速完成注册,Chat App会自动检测与Meta的网络连接。当注册按钮为灰色时,说明用户与Meta之间的网络连接不可用,请登录Meta官网检查是否可打开网页。无法访问 Meta官网时,请检查是否已开启网络加速。

创建WABA时,无法完成Meta企业认证?

Embedded Signup未提供Meta business verification的流程,您需要登录Facebook官网完成企业认证。

WhatsApp消息模板通过审核后还可以编辑吗?

根据WhatsApp的规则,在连续30天内最多可以编辑10次处于已批准状态的模板(或每24小时编辑1次),对处于被拒绝或已暂停状态的消息模板的编辑次数则不受限制。

重要

编辑已经通过审核的模板需要重新提交审核,在模板未审核通过之前该模板无法进行消息发送且模板重新提交审核后会导致正在进行的发送任务失败。

WhatsApp消息模板可以删除吗?

如果您确认不再使用某条消息模板,可以在控制台中进行删除。

重要

根据WhatsApp的规则,删除消息模板的30天内不允许创建与删除的模板同名的模板。

如何在 WhatsApp 添加国际电话号码?

  1. 打开您手机的通讯录。

  2. 在添加联系人的电话号码时,首先输入加号 (+)。

  3. 输入国家/地区代码,接着输入完整的电话号码。

    说明

    国家/地区代码是一种数字前缀,必须在完整的国际电话号码之前输入,才能拨打电话到相应国家/地区。

    例如,如果联系人位于美国(国家代码“1”),区号为“408”且电话号码为“XXX-XXXX”,您应输入+1 408 XXX XXXX。

注意

  • 请务必移除电话号码开头的数字0或特殊呼叫代码。

  • 对于阿根廷(国家代码“54”)的所有电话号码,应在国家代码与区号之间添加“9”。必须移除电话号码前缀“15”,这样最终拨打的电话号码便共有13位数字:+54 9 XXX XXX XXXX

  • 对于墨西哥(国家代码“52”)的电话号码,则需要在“+52”之后添加“1”,即使是 Nextel 电话号码也是如此。

商家使用WhatsApp商业号码发送消息有哪些规则或限制?

商家使用 WhatsApp 商业号码发送消息有以下规则或限制:

  1. 为了避免被用户举报或投诉,请只发送消息给已经订阅您消息的用户。

  2. 请确保您的消息内容符合 WhatsApp 商业服务条款。

  3. 如果商家主动下发消息给用户时需要使用已经通过 WhatsApp 审核的消息模板,在客户服务时间窗口外,商家仅支持发送已过审的消息模板,只有当用户主动联系商家或用户对商家发送的消息模板进行回复后,会开启24小时的客户服务时间窗口,在窗口期内商家可以使用互动消息或自由格式消息进行回复也可以发送已过审的消息模板。

  4. 每个用户在一定时间内可以收到营销消息的数量是一个动态值,取决于用户近期是否对营销消息进行过互动或是否开启了 WhatsApp 应用中的“优惠和公告”并点击了不感兴趣。

  5. Meta 已于 2025 年 4 月 1 日起暂停向使用美国手机号码的 WhatsApp 用户发送营销消息。

阿里云 Chat App 消息服务是否保存 WhatsApp 消息内容?

阿里云 Chat App 消息服务不会保存发送的 WhatsApp 消息正文内容(包括二维码图片或文本)。该服务遵循 WhatsApp 端到端加密原则,消息内容仅在发送方与接收方之间传输,阿里云侧无法读取或存储消息正文。

但服务可能会留存消息模板的元数据(如模板 ID、发送时间等),用于合规审计目的。

说明

生成二维码时请避免包含个人敏感信息,并确保业务符合 GDPR 等适用的数据保护法规要求。

Webhook 支持哪些事件类型?

Webhook 回调当前支持以下事件类型:

  • 新消息(终端用户向 WABA 发送的消息)

  • 消息已读

  • 消息发送失败

  • 号码质量评分下降提醒

暂不支持以下事件:会话关闭、转接、打标签等操作类事件。

为什么收到的客户回复显示"此类消息无法显示"?

当终端用户发送了 Meta 不支持的消息类型(例如动态贴图表情包)时,由于消息格式无法被识别,系统会显示"此类消息无法显示"的提示。

建议联系终端用户,确认其发送的具体消息内容或请用户提供截图,以便判断具体的消息类型并进行进一步排查。

设置为离线状态后,消息已读回执是否会延迟显示?

离线状态不具备延迟显示消息已读回执的功能。离线状态仅控制能否收发消息——账号处于离线状态时无法看到新消息,切换为在线状态后才能正常收发消息和查看消息状态。消息的已读或未读状态完全由 Meta 平台决定,与阿里云 Chat App 侧的在线/离线设置无关。

如何接收和处理客户的引用消息?

WhatsApp 支持接收客户发送的引用消息(即对某条消息的回复)。

  • 接收引用消息:配置 Webhook 推送后,当客户发送引用消息时,Webhook 回调中会包含被引用的原始消息 ID。

  • 发送引用消息:调用 ChatAppInbound 接口时,在请求中附带之前的消息 ID 即可实现引用回复。MessageTypeContent 字段的取值取决于具体要发送的消息类型(如文本、图片等)。

如何获取 WhatsApp 用户的昵称和头像?

  • 用户昵称:当前没有直接获取用户昵称的接口,但可以通过 Webhook 回执间接获取。当用户向 WABA 发送消息时,Webhook 回执中的 Name 字段即为该用户的昵称。

  • 用户头像:当前无法直接获取 WhatsApp 用户的头像。

同一账号下不同 WABA 的状态回执消息队列地址是否相同?

是的,同一阿里云账号下所有 WABA 的状态回执消息队列地址是相同的。这是因为消息队列地址与阿里云账号的 UID 绑定,同一阿里云账号只有一个 UID,因此该账号下所有 WABA 共享同一个消息队列地址。

设置开场白后为什么未收到自动回复或未显示?

开场白(包括欢迎消息和快捷回复按钮)仅在客户第一次与 WABA 发起聊天时显示。如果该客户与 WABA 之间已有聊天记录,开场白不会再次触发。

如需重新触发开场白,客户需要清空与 WABA 的聊天记录后重新发起会话,才能再次看到开场白或收到自动回复。