> ## Documentation Index
> Fetch the complete documentation index at: https://gowa-docs.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 发送限制

> GOWA 不限制费率请求。存在什么限制，WhatsApp 如何限制发送者，以及如何加快您的流量。

> [!WARNING]
>
> **GOWA 没有 limiter。** 它没有计入请求，返回`429` 作为请求音量或发送 `X-RateLimit-*` 标题。 您提出的每个请求都会立即传递给WhatsApp 。配对是您的责任。

## 限制GOWA确实执行

| 限制 | 值 | 超出时的结果 |
| - | - | - |
| 请求超时 | 45 秒 | `504 GATEWAY_TIMEOUT` |
| 请求内容 | 100 MB | 请求被拒绝(`413`) |
| 图片 / 文档 / 视频上传 | 20 / 50 / 100 MB | `400` 验证错误 |
| Web 钩子交付 | 每次尝试10秒，5 次尝试 | 事件已删除 |

## 限制 WhatsApp 执行

WhatsApp 没有发布其链接设备的限制，这些限制会改变。 发送太多、 太快、 或发送给从未给他们的人的帐户受到限制或被禁止。 妇女事务办公室无法事先发现或防止这种情况。

GOWA的一个信号表面是\*\*`WA_REACHOUT_TIMELOCK`\*\* (HTTP `429`):

```json theme={null}
{
  "code": "WA_REACHOUT_TIMELOCK",
  "message": "..."
}
```

WhatsApp 返回这个(服务器错误463)，当帐户暂时被阻止启动 **new** 聊天时。 它不能被绕过或重试。直到它被提升为止：

* 只给已经给您发送消息的人发送消息，或在现有聊天中回复。
* 从手机本身发送一条消息有时会更快清除它。
* 停止散装或冷冻外联，减缓。

## 配对准则

这些都是保守的起点，不能保证：

* 按顺序发送每台设备；不要同时发送数百次请求。
* 在消息之间添加延迟(几秒，随机jitter)和批次之间更长时间暂停。
* 喜欢选择或先写入的联系人。未请求的消息会被举报，报告会导致禁令。
* 几天来，新数字变暖慢慢了。
* 个性化内容；与许多收件人相同的文字看起来就像垃圾邮件一样。
* 在 `WA_REACHOUT_TIMELOCK` 上停止并警告人类。

```python theme={null}
import random, time, requests

session = requests.Session()
session.auth = ("admin", "changeme")
session.headers["X-Device-Id"] = "my-device"

for phone, text in recipients:
    r = session.post("http://localhost:3000/send/message",
                     json={"phone": phone, "message": text}, timeout=60)
    body = r.json()
    if body.get("code") == "WA_REACHOUT_TIMELOCK":
        print("Reach-out blocked; stopping")
        break
    r.raise_for_status()
    time.sleep(random.uniform(5, 12))
```

若需在一段时间内分批发送，请使用[定时发送](https://gowa-docs.mintlify.site/zh/examples/scheduled-sends.md)，避免运行长时间循环。

## 保护西澳大利亚州政府本身。

如果 GOWA 可以从互联网连接，请在您的逆向代理上添加请求限制，特别是在基本认证登录失败时，以及通过 MCP OAuth 添加`/oauth/authorize`。 例如, 与 nginx:

```nginx theme={null}
limit_req_zone $binary_remote_addr zone=gowa:10m rate=10r/s;

server {
    location / {
        limit_req zone=gowa burst=20 nodelay;
        proxy_pass http://127.0.0.1:3000;
    }
}
```


## Related topics

- [速率限制](https://gowa-docs.mintlify.site/zh/api-reference/rate-limits.md)
- [正在发送消息](https://gowa-docs.mintlify.site/zh/examples/sending-messages.md)
- [GOWA: WhatsApp REST API](https://gowa-docs.mintlify.site/zh/index.md)
- [错误处理](https://gowa-docs.mintlify.site/zh/advanced/error-handling.md)
- [发送实验性交互消息](https://gowa-docs.mintlify.site/zh/api-reference/send/发送实验性交互消息.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.