> ## 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 بطلبات الحد من المعدلات. ما هي الحدود الموجودة، وكيف يقيد واتساب المرسلين، وكيف يعدل حركة المرور الخاصة بك.

> [!WARNING]
>
> **لا يتضمن GOWA محدِّدًا لمعدل الطلبات.** فهو لا يحصي الطلبات، ولا يعيد `429` بسبب حجم الطلبات، ولا يرسل ترويسات `X-RateLimit-*`. يُمرَّر كل طلب ترسله إلى WhatsApp فورًا. تقع مسؤولية تنظيم وتيرة الطلبات عليك.

## القيود التي تفرضها GOWA

| الحد | القيمة | النتيجة عند تجاوزها |
| - | - | - |
| مهلة الطلب | 45 ثانية | `504 GATEWAY_TIMEOUT` |
| طلب الجسم | 100 ميغابايت | رُفض الطلب (`413`) |
| صورة / مستند / رفع فيديو | 20 / 50 / 100 ميغابايت | خطأ في التحقق من صحة `400` |
| توصيل Webhook | 10 ث في كل محاولة، 5 محاولات | تم إسقاط الحدث |

## حدود تطبيق WhatsApp

لا ينشر WhatsApp حدوده للأجهزة المرتبطة، وهي تتغير. والحسابات التي ترسل كثيرا جدا وسريعة جدا أو إلى أشخاص لم يكتبوا لهم أبدا مقيدة أو محظورة. ولا تستطيع GOWA الكشف عن ذلك أو منعه مسبقا.

الإشارة الوحيدة التي يعرضها GOWA هي **`WA_REACHOUT_TIMELOCK`** (HTTP `429`):

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

WhatsApp يرجع هذا (خطأ الخادم 463) عندما يتم حظر الحساب مؤقتاً من بدء دردشة **جديدة**. لا يمكن تجاوزه أو إعادة تجربته. حتى يرفع:

* فقط أرسل رسالة للأشخاص الذين قاموا برسائلك أولا، أو الرد في المحادثات.
* إرسال رسالة واحدة من الهاتف نفسه يمسحها في بعض الأحيان في وقت أسرع.
* وقف الاتصال بالجملة أو البرد والبطء.

## المبادئ التوجيهية للصق

وهذه نقاط انطلاق محافظة وليست ضمانات:

* إرسال متسلسل لكل جهاز؛ لا تطلق المئات من الطلبات المتزامنة.
* إضافة تأخير بين الرسائل (عدة ثواني، مع نظام عشوائي) وإيقاف أطول بين الدفعات.
* تفضّل جهات الاتصال التي اختارت أو كتبت أولاً. يتم الإبلاغ عن الرسائل غير المطلوبة، والتقارير تؤدي إلى حظر.
* ارتفاع أعداد جديدة ببطء على مر الأيام.
* تخصيص المحتوى؛ النص المتطابق لكثير من المستلمين يبدو مثل البريد المزعج.
* توقف عن `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/ar/examples/scheduled-sends.md) بدلاً من حلقة تشغيل طويلة.

## حماية GOWA نفسها

إذا كان من الممكن الوصول إلى 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/ar/advanced/error-handling.md)
- [إرسال الرسائل](https://gowa-docs.mintlify.site/ar/examples/sending-messages.md)
- [إرسال رسالة تفاعلية تجريبية](https://gowa-docs.mintlify.site/ar/api-reference/send/إرسال-رسالة-تفاعلية-تجريبية.md)
- [إرسال مجدول](https://gowa-docs.mintlify.site/ar/examples/scheduled-sends.md)
- [إرسال ملصق](https://gowa-docs.mintlify.site/ar/api-reference/send/إرسال-ملصق.md)


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