# وضع الاختبار

مفتاح الاختبار (`sk_test_…`) يمنحك الواجهة كاملة مع محاكٍ بدل واتساب. تُفحص الطلبات تمامًا كما في وضع التشغيل، فما ينجح هنا ينجح هناك، لكن لا يُرسل شيء ولا يصل شيء إلى صندوق الوارد ولا يُحتسب شيء في الفوترة.

## ما الذي تتم محاكاته {#simulated}

- **الإرسال.** تُرجع `POST /messages` الحالة `accepted`، ثم تنتقل الرسالة إلى `sent` (~ثانية) ثم `delivered` (~3 ثوانٍ) ثم `read` (~8 ثوانٍ)، مطلقةً أحداث `message.*` نفسها التي تطلقها الرسالة الحقيقية.
- **الويب هوك.** نقاط استقبال وضع الاختبار تستقبل أحداث الاختبار فقط، ولا تراها النقاط الحية أبدًا. كل حدث يحمل `"livemode": false`.
- **الرسائل الواردة.** `POST /test/inbound_messages` تمثّل عميلًا يراسلك: تطلق `message.received` وتفتح نافذة الـ24 ساعة المحاكاة لذلك الرقم.

تُقرأ القوالب والأرقام وبقية الإعدادات من مساحة عملك الحقيقية (قراءة فقط)، فالقالب الذي تجرّبه هو نفسه الذي سترسله.

## الأرقام التجريبية {#magic-numbers}

المستلِم يحدد ما يحدث:

| أرسل إلى | النتيجة |
|---|---|
| `+966500000001` | إرسال ← تسليم ← قراءة |
| `+966500000002` | إرسال ← تسليم (دون قراءة) |
| `+966500000003` | تفشل بالرمز `131026` (غير قابلة للتسليم) |
| `+966500000004` | تُرفض الرسائل الحرة بـ `window_closed` حتى تحاكي رسالة واردة منه |
| `+966500000005` | تبقى عند `sent` |
| أي رقم صالح آخر | إرسال ← تسليم ← قراءة |

## التحكم في المحاكي {#drive}

افرض حالة الآن (مثلًا لتجربة تعاملك مع الفشل):

```bash
curl -X POST https://api.saei.automize.sa/v1/test/messages/msg_test_01j9.../status \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "status": "failed", "error_code": "131026" }'
```

حاكِ ردّ عميل، ثم أجب داخل النافذة:

```bash
curl -X POST https://api.saei.automize.sa/v1/test/inbound_messages \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "from": "+966500000004", "text": { "body": "أين طلبي؟" } }'
```

## ما لا يغطيه وضع الاختبار {#limits}

توضح كل صفحة في المرجع سلوك نقطتها في وضع الاختبار. باختصار:

| مع مفتاح اختبار | النقاط |
|---|---|
| **محاكاة** | إرسال رسائل واتساب بكل أنواعها، وإشعارات القراءة، وأدوات المحاكي |
| **إعداداتك الحقيقية، قراءة فقط** | الأرقام والقوالب والوسوم والحقول المخصصة والتدفقات والأعضاء والاستهلاك |
| **مشتركة مع مفاتيح التشغيل** | مكتبة الوسائط (الرفع ملف وليس إرسالًا)، ونقاط استقبال الاختبار الخاصة بك |
| **`test_mode_unsupported`** | كل ما يعمل على عملاء حقيقيين أو يرسل فعليًا: جهات الاتصال والمحادثات والحملات وتعديل القوالب والوسوم وتشغيل التدفقات وإنستغرام وماسنجر |

لتجربة الصف الأخير بشكل كامل استخدم مساحة عمل منفصلة بمفتاح تشغيل خاص بها.