群发统计

群发统计记录了每一次历史群发的具体信息,可以通过对比衡量效果

群发统计数据以列表形式展示,便于查看具体数据:
  1. 任务名称:创建群发时的名称;
  2. 任务类型:包含广播/分组任务;
  3. 时区设置:可选机器人时区/用户时区;
  4. 推送日期&推送时间:群发任务完成的日期和时间;
  5. 推送循环:指一次性任务或以周为周期形成的循环任务;
  6. 预期发送:发送前符合条件的用户数;  如上传群发excel中通过校验无异常符号的所有号码;
  7. 被退回:推送时接口返回无法推送及退回原因;具体见详解;若群发内容里有两个消息卡片,只要有一个卡片退回,则被退回数据+1
  8. 已发送:接口未返回退回;即已发送=预期发送-被退回
  9. 已送达:实际已送达用户数;若群发内容里有两个消息卡片,只要有一个卡片送达,则已送达数据+1;已发送和已送达的差异可能但不限于用户已注册WhatsApp但手机未安装WhatsApp应用/用户未开机等;
  10. 已阅读:接收消息后点击阅读内容的用户;若群发内容里有两个消息卡片,只要有一个卡片被阅读,则已阅读数据+1;  
  11. 营销类消息:用于账号更新/事件更新的标签类消息;

WhatsApp群发退回详解

授权错误

代码描述合理解决方案HTTP 状态代码
0AuthException我们无法验证应用用户。通常,这表示包含的访问口令已过期、失效,或应用用户为防止所有应用访问其数据而更改了设置。我们建议您获取新的访问口令401未授权
3API 方法功能或权限问题。使用访问口令调试器来确认您的应用已获得端点所需权限。请参阅疑难解答500内部服务器错误
10权限遭拒未获得权限或权限已被移除。使用访问口令调试工具来确认您的应用是否已获得端点所需的权限。请参阅疑难解答。请确保已将用于设置企业公钥的电话号码列入白名单。403禁止访问
190访问口令已过期您的访问口令已过期。获取新的访问口令401未授权
200-299API 权限未获得权限或权限已被移除。使用访问口令调试工具来确认您的应用是否已获得端点所需的权限。请参阅疑难解答403禁止访问

节流错误

代码描述合理解决方案实际情况
4API 调用过多此应用已达到 API 调用流量限制。应用面板中加载此应用,然后查看应用流量限制部分,确认此应用是否已达到其流量限制。如果已达到,请稍后再试,或减少此应用进行 API 查询的频次或数量。
80007流量限制问题WhatsApp Business 商业帐号已达到其流量限制。参阅 WhatsApp Business 商业帐号的流量限制。稍后重试;或减少此应用进行 API 查询的频次或数量。
130429达到流量限制已达到云端 API 消息吞吐量。此应用已达到 API 吞吐量限制。请参阅吞吐量。稍后重试;或减少此应用发送消息的频次。
131048达到垃圾信息流量限制此电话号码被限制了可发送的消息数量,因此消息发送失败。这可能是因为之前有太多消息被封锁,或被标记为垃圾信息。在 WhatsApp 管理工具中检查您的质量状态,然后查看基于质量的流量限制文档,以了解详情。
131056达到(商业帐号、消费者帐户)配对流量限制短时间内从发信人电话号码发送到同一收信人电话号码的消息过多。如需发送消息到同一电话号码,等待并重试操作。您仍可发送消息到其他电话号码,而无需等待

诚信错误

代码描述合理解决方案实际情况
368因违反政策被暂时禁用由于违反平台政策,与该应用绑定的 WhatsApp Business 商业帐号已被限制或停用。参阅政策执行文档,了解政策违规内容及其解决方案。
131031帐号已锁定由于违反平台政策,与此应用绑定的 WhatsApp Business 商业帐号已被限制或停用,或者我们无法根据 WhatsApp Business 商业帐号上的数据集来验证请求中包含的数据(例如,请求中包含的两步 PIN 码不正确)。参阅政策执行文档,了解政策违规内容及其解决方案。账号被封需要申诉

其他错误

代码描述合理解决方案实际情况
1未知 API请求无效或可能出现服务器错误。访问 WhatsApp Business 开放平台状态页面,查看 API 状态信息。如果服务器没有中断,则参阅端点参考文档,并确认您的请求格式是否正确且满足所有端点要求。
2API 服务因停机或过载而出现临时问题。访问 WhatsApp Business 开放平台状态页面,查看 API 状态信息,然后重试。
33参数值无效公司电话号码已被删除。确认公司电话号码是否正确。
100无效参数请求中包含一个或多个不受支持或拼写错误的参数。参阅此端点的参考文档,确定哪些参数受支持以及如何拼写。在设置企业公钥时,请确保使用 PEM 格式的有效 2048 位 RSA 公钥。请确保您注册的电话号码编号与之前存储的电话号码编号相符。
130472用户编号涉及试验作为试验的一部分,消息未送出。请参阅营销消息试验
131000出错了出现未知错误,因此消息发送失败。在设置企业公钥时,这通常是因为系统计算签名或调用 GraphQL 端点失败,或者 GraphQL 端点返回错误。请重试。如果错误持续存在,则开立站内支持工单。
131005访问遭拒未获得权限或权限已被移除。使用访问口令调试工具来确认您的应用是否已获得端点所需的权限。请参阅疑难解答
131008必要参数缺失请求中缺少一个必要参数。参阅此端点的参考文档,确定哪些是必要参数。
131009参数值无效一个或多个参数值无效。参阅此端点的参考文档,确定每个参数的哪些值受支持;参阅电话号码,了解如何在 WhatsApp Business 商业帐号中添加电话号码。
131016服务不可使用服务暂时不可使用。访问 WhatsApp Business 开放平台状态页面,查看 API 状态信息,然后重试。
131021收信人不能是发信人发信人和收信人的电话号码相同。将消息发送到与发信人不同的电话号码。
131026消息无法送达无法送达消息。原因可包括:收信人电话号码不是 WhatsApp 电话号码。收信人尚未接受我们的新服务条款和隐私政策。收信人使用了 WhatsApp 的旧版本;必须使用以下 WhatsApp 版本或更高版本:Android:2.21.15.15SMBA:2.21.15.15iOS:2.21.170.4SMBI:2.21.170.4KaiOS:2.2130.10网页:2.2132.6向收信人确认:他们已同意您通过 WhatsApp 与其联系,并且他们使用的是 WhatsApp 最新版本。
131042商家资格支付问题您的支付方式出现了一个或多个错误,因此消息发送失败。参阅 WhatsApp Business 商业帐号的账单简介,确认账单已正确设置。常见问题:WhatsApp Business 商业帐号未绑定支付帐户额度超出上限未设置或启用信用额度(支付帐户)WhatsApp Business 商业帐号已被删除WhatsApp Business 商业帐号暂时受限未设置时区未设置货币以代理身份发出的 MessagingFor 请求待处理或已驳回在无有效支付方式的情况下超出免费对话次数限制
131045证书不正确由于电话号码注册错误,消息发送失败。注册电话号码,然后重试。
131047再互动消息距收信人上次回复发信人号码,时间已超过 24 小时。改用消息模板向收信人发送商家发起的消息。
131051消息类型不受支持消息类型不受支持。参阅消息,了解受支持的消息类型,然后使用受支持的消息类型重试。
131052媒体下载出错无法下载用户发送的媒体。由于一个或多个原因,我们无法下载该媒体,例如不支持的媒体类型。如需详细了解我们无法下载该媒体的原因,请查看 error.error_data.details 值。要求:图片<5M, 音频/视频<16M
131053媒体上传出错无法上传消息中使用的媒体。由于一个或多个原因,我们无法上传该媒体,例如不支持的媒体类型。如需详细了解我们无法上传该媒体的原因,请查看 error.error_data.details 值。为了在发送媒体时获得更可靠的性能,请参阅媒体 HTTP 缓存上传媒体要求:图片<5M, 音频/视频<16M
132000模板参数数量不一致请求中包含的可变参数值数量与模板中定义的可变参数数量不一致。参阅消息模板指南,确保请求中包含模板中定义的所有可变参数值。
132001模板不存在该模板在特定语言中不存在,或尚未通过审核。确保您的模板已通过审核,并且模板的名称和语言设置准确无误。请确保遵循消息模板指南在群发执行过程中由于C端用户投诉导致模板临时/永久性被封,剩余用户无法发送成功,也会返回此报错
132005模板填充文字过长翻译文字过长。查看 WhatsApp 管理工具,确认模板已翻译。请参阅质量评分与模板状态
132007违反模板格式字符政策模板内容违反了 WhatsApp 政策。参阅未通过审核的原因,确定违规的可能原因。
132012模板参数格式不一致可变参数值格式不正确。请求中包含的可变参数值未使用模板中指定的格式。参阅消息模板指南
132015模板已暂停模板因低质量而暂停,因此您无法在模板消息中发送此模板。编辑模板以提高其质量,在模板通过审核后重试。
132016模板已禁用模板已多次因低质量而暂停,现已永久禁用。使用不同内容新建模板。
132068流量被屏蔽流量处于屏蔽状态。纠正流量
132069流量被节流流量处于节流状态,过去一小时内已发送了使用此流量的 10 条消息。纠正流量
131049为保持健康的生态系统,此消息未送达为保持健康的生态系统,此消息未送达如果您收到此错误代码,并且怀疑是由于该限制所致,请勿立即重新发送模板消息。由于此限制可能在不同时期有效,立即重发模板消息只会导致出现另一个错误响应。请改为以不断增加的时间间隔重新尝试发送模板消息,直到消息送达给定用户。
133000注销未完成之前的注销尝试失败。重新注销号码后再注册
133004服务器暂时不可使用服务器暂时不可使用。访问 WhatsApp Business 开放平台状态页面,查看 API 状态信息,检查响应中的 details 值,然后重试。
133005两步验证 PIN 码不一致两步验证 PIN 码不正确。确认请求中包含的两步验证 PIN 码正确。重置两步验证 PIN 码的做法:禁用两步验证。向电话号码端点发送包含新 PIN 码的 POST 请求。
133006需要重新验证电话号码电话号码需要重新验证,才能注册。验证电话号码后再注册。
133008两步验证 PIN 码输入错误次数过多此电话号码的两步验证 PIN 码输入错误次数过多。在 details 响应值指定的时间后重试。
133009两步验证 PIN 码输入过于频繁两步验证 PIN 码输入过于快速。检查 details 响应值,然后重试。
133010电话号码未注册电话号码未在 WhatsApp Business 开放平台上注册。注册电话号码,然后重试。
133015请等待几分钟,再尝试注册此电话号码您当前尝试注册的电话号码近期被删除,但删除尚未完成。请等待 5 分钟,再重新尝试发送请求。
135000一般用户错误您的请求参数出现未知错误,因此消息发送失败。参阅此端点的参考文档,确认您查询端点所使用的语法是否正确。如果您在响应中继续收到此错误代码,请联系客户支持
2024-12-09
0