登录开始免费试用
easyCoexistence 官方 API

Partner API 限制与规则:Meta 政策、每秒 20 条消息与 14 天规则

通过 easyCoexistence 的 Partner API 连接的 Coexistence 号码,每秒最多发送 20 条消息,这一速率由 Meta 固定。若手机长时间(约 14 天)处于非活跃状态,Meta 会断开该号码。平台代客户连接其账户,即代表客户行事,因此需遵守各网络的规则:在 WhatsApp 上,须在 24 小时客户服务窗口内回复,窗口之外仅可使用已获批准的消息模板,且不得发送垃圾信息,也不得在号码上部署通用型 AI 聊天机器人。

20 mps

Meta 为同时使用 WhatsApp Business 应用和 Cloud API 的号码设定的固定吞吐量。

80 mps

仅使用 Cloud API 的号码的默认吞吐量,可自动提升至 1,000。

About 14 days

手机长时间不活跃后,Meta 会断开号码,原因为 PRIMARY_INACTIVITY。

24 hours

用户消息开启的客户服务窗口;窗口之外,企业只能发送已获批准的模板。

250

新业务组合的消息限额:每滚动 24 小时内,窗口之外可触达的人数。

平台应遵守谁的规则?

平台为其连接的每位客户所遵守的,是各网络的规则。这些账户运行在各网络的官方 API 上,而其规则约束您的软件通过这些 API 发送和发布的内容。在 WhatsApp 上,Meta 的执行措施针对客户的 WhatsApp Business 账户以及号码所连接的应用,因此滥用 Meta 规则将导致平台的 API 密钥失效。

WhatsApp 上适用哪些 Meta 规则?

Meta 的消息规则,由为企业发送消息的软件负责遵守:

  • 仅在用户最后一条消息发出后的 24 小时内可回复自由文本;用户每发来一条新消息,窗口即重新开始。
  • 窗口之外,仅可使用 Meta 已批准的模板。
  • 仅向同意接收企业消息的用户发送消息。
  • 不得发送垃圾信息,号码上也不得部署通用型 AI 聊天机器人。
  • 窗口之外的触达按业务组合计算:新的业务组合每滚动 24 小时可触达 250 人。

Coexistence 号码的发送速度是多少?

为每秒 20 条消息,这是 Meta 设定的固定速率,以便号码与 WhatsApp Business 应用保持兼容。仅使用 Cloud API 的号码起始速率为每秒 80 条,并可自动提升至 1,000,但 Coexistence 号码始终保持在每秒 20 条。业务组合的消息限额同样生效,计入服务窗口之外触达的人数。

什么是 14 天规则?

当运行 WhatsApp Business 应用的手机约 14 天处于非活跃状态时,Meta 会断开 Coexistence 号码,原因为 PRIMARY_INACTIVITY。easyCoexistence 会监控每个号码,并向您的事件 URL 发送 connection.disconnected,同时附上该原因。修复方法是为该客户生成新的连接链接:客户使用同一号码重新运行流程,号码即可恢复连接。

Meta 还报告哪些断开原因?

当 Meta 终止号码的连接时,若已知原因,connection.disconnected 会附带 Meta 的原因代码。除 PRIMARY_INACTIVITY 外,Meta 还列出以下原因:

  • ACCOUNT_DISCONNECTED:Meta 执行措施,或客户删除了其 WhatsApp 账户;由用户或系统发起。
  • CHANGE_NUMBER:客户更换了手机号码。
  • BUSINESS_DOWNGRADE:该号码已注册到面向消费者的 WhatsApp 应用。
  • USER_RE_REGISTERED:客户在新设备上重新注册了 WhatsApp。
  • COMPANION_INACTIVITY:关联设备约 30 天未使用。

什么会使 Partner API 密钥失效?

有三种情况。您可以轮换密钥,这会立即以新密钥替换旧密钥;您可以撤销密钥,此后该账户将没有密钥;或者因为该账户违反 Meta 规则,easyCoexistence 会终止该密钥。密钥没有自身的有效期,一旦失效,之后的每个请求都会返回 401 unauthorized。

连接会话受到哪些限制?

一个账户最多可同时保持 50 个未结束的连接会话,每小时最多创建 100 个。Meta 将每次首次入驻计入整个应用的限额,而所有 easyCoexistence 账户共享该限额,因此上限可防止某个平台的批量导入耗尽限额、影响所有人。触发上限时返回 429,错误码为 cap_reached 或 rate_limited。

各社交网络设有哪些规则?

各网络自身的规则,适用于您的客户所连接的账户,它们在以下几个方面有所不同:

  • 消息窗口:Instagram 和 Facebook 私信通常可在用户最后一条消息发出后的标准窗口内回复,一般为 24 小时。
  • 每个账户的发布上限和 API 配额,因网络而异。
  • 访问令牌有效期:部分网络签发的访问令牌有效期为一小时或一天,easyCoexistence 会为您续期。
  • 同意:账户所有者可随时在网络设置中撤回访问权限,此时会发送 channel.disconnected。
  • 功能:TikTok、YouTube 和 LinkedIn 在此不提供私信功能,且 easyCoexistence 不接收来自 YouTube 或 LinkedIn 的评论事件。

常见错误

  • 从同一个 Coexistence 号码成批突发发送。Meta 将其限制为每秒 20 条消息,因此请按该速率为每个号码排队发送,而不要一次性全部发出。
  • 指望 WhatsApp Business 应用来发送模板。在 Coexistence 中只有 API 能发送模板,因此任何超出 24 小时窗口的消息都必须经由您的后端发送。
  • 保存社交网络的访问令牌以备后用。部分令牌有效期仅为一小时或一天,因此应在每个任务开始时从 easyCoexistence 重新获取凭证。
使用 EasyCoexistence 完成这些操作

easyCoexistence 通过各网络的官方 API 连接您客户的 WhatsApp 号码、Instagram、Facebook、TikTok、YouTube 和 LinkedIn 账户,以及更多渠道。当某个连接断开时,它会通过已签名的事件通知您的平台,并在已知原因时附上原因。每个连接每月 US$ 9 起,随连接数增加而降低,最低降至 US$ 0.75,首 3 天免费。

常见问题

COMPANION_INACTIVITY 是什么意思?

关联设备约 30 天未使用,这是 Meta 断开号码的原因之一。

如果我的平台违反了 Meta 的规则,我的客户会怎样?

Meta 的执行措施会针对其 WhatsApp Business 账户以及号码所连接的应用,easyCoexistence 也会终止违反规则的账户的 API 密钥。

14 天规则适用于社交账户吗?

不适用。这是 Meta 针对 WhatsApp Business 应用与 API 之间共用号码所制定的规则。当网络拒绝其访问令牌或所有者撤回访问权限时,社交账户会断开,并发送 channel.disconnected。

各网络的限制会有所不同吗?

会。各网络设定各自的消息窗口、发布上限、API 配额和访问令牌有效期,这些规则同样适用于您所连接的账户,与适用于您自身账户的规则一样。

继续阅读

两分钟连接您的第一个渠道。

无需等待平台审核。连接 WhatsApp、Instagram、TikTok 或其他渠道,然后让您的 AI 发布、回复或生成报告,看它如何运作。

  • 免费试用 3 天
  • 随时取消
  • 仅使用官方 API
  • 全天候 24/7 监控

验证时间