وضع الاختبار

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

ما الذي تتم محاكاته#

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

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

الأرقام التجريبية#

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

التحكم في المحاكي#

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

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" }'

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

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": "أين طلبي؟" } }'

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

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

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