وضع الـ Sandbox

الـ Sandbox خاصّية من خصائص المشروع. لكلّ مشروع بيئتان: مفاتيح sandbox (sk_sandbox_) ومفاتيح production (sk_live_). يبدأ كلّ مشروع جديد في الـ sandbox. تُجري الـ sandbox keys مكالمات حقيقيّة، لكن ضمن ضوابط مُصمَّمة للاختبار الآمن.

دقائق الـ sandbox

يُجري الـ sandbox key مكالمات حقيقيّة من رقم Wave مشترك. لكلّ مشروع 15 دقيقة sandbox. تحتسب Wave الثواني المُجاب عنها في مكالمات المشروع المنتهية التي أُجريت بـ sandbox key (دون المكالمات المحاكاة). والحدّ الأقصى 900 ثانية.

مكالمات الـ sandbox لا تُحاسَب أبدًا.
عند استنفاد الدقائق، تُعيد المكالمة الحقيقيّة في الـ sandbox ‏403 مع error_code: SANDBOX_MINUTES_EXCEEDED.
المكالمات المحاكاة (أرقام الاختبار و x-wave-simulate header أدناه) لا تُجري أيّ مكالمة. وتبقى تعمل بعد استنفاد الدقائق.
يمكنك الاتصال بأيّ وجهة صالحة. لا يوجد قفل للوجهة.

كلّ مكالمة حقيقيّة يُجريها sandbox key تستهلك دقائق الـ sandbox. ويشمل ذلك مكالمات المصادقة الصوتيّة ومكالمات اختبار الـ IVR.

Go-Live

ينتقل المشروع إلى الإنتاج عبر Go-Live الخاصّ به. تقدّم الطلب في لوحة التحكّم، ويراجعه مسؤول في Wave، ويُخصّص للمشروع رقم هاتفه الخاصّ، ثمّ تُنشئ Wave مفتاح production للمشروع. وتبقى المشاريع الأخرى في المؤسّسة كما هي. تبقى مفاتيح الـ sandbox فعّالة بعد Go-Live. ولا تستهلك مكالمات الإنتاج دقائق الـ sandbox.

يرى كلّ مفتاح بيئته فقط

يقرأ الـ sandbox key بيانات الـ sandbox فقط ويتصرّف فيها، ويقرأ مفتاح الـ production بيانات الـ production فقط ويتصرّف فيها. ينطبق هذا على كلّ قائمة، وكلّ قراءة بالمعرّف، وكلّ إجراء على مكالمة أو callback أو حملة.

القوائم (GET /v1/calls، وGET /v1/callbacks، وGET /v1/usage، وGET /v1/campaigns) تُعيد صفوف بيئة المفتاح. وتقبل environment: اتركه، أو أرسل قيمة بيئة المفتاح نفسه. أيّ قيمة أخرى تُعيد 400 VALIDATION_ERROR.
القراءة والإجراءات بالمعرّف (callback، وتسجيل مكالمة، والتحكّم أثناء المكالمة، والتحويل، والمؤتمر، وإلغاء الـ callback، وإيقاف الحملة مؤقّتًا واستئنافها وإنهاؤها) تُعيد 404 لصفّ من البيئة الأخرى، كأنّه غير موجود.
الحملات الجديدة تأخذ بيئة المفتاح.

في لوحة التحكّم، لمشروع الـ production مفتاح عرض البيئة (Sandbox / Production). تعرض الصفحات بيانات العرض المحدّد.

إعادة ضبط الـ sandbox

في لوحة التحكّم، يحذف إعادة ضبط الـ sandbox مكالمات الـ sandbox للمشروع المحدّد فقط. يستطيع ذلك مالك المؤسّسة أو مسؤولها، أو مسؤول ذلك المشروع.

أرقام الاختبار والأخطاء المحاكاة

افرض نتائج محدّدة دون الاعتماد على مكالمة حيّة، بطريقتين. ويغلب الـ header إن انطبق الاثنان معًا. رقم اختبار محجوز

الرقم	النتيجة
`+966500000016`	محاكاة انتهاء المهلة: `call.initiated` ثمّ `call.timeout` بعد نحو 15 ثانية
`+966500000017`	محاكاة `server_error`

الـ x-wave-simulate header اضبط x-wave-simulate على POST /v1/callback لفرض متغيّر خطأ (الـ sandbox keys فقط — يتجاهله الإنتاج):

القيمة	المُحاكاة
`rate_limit`	رفض بسبب تجاوز حدّ المعدّل
`invalid_queue`	طابور غير معروف
`queue_unavailable`	الطابور غير متاح مؤقّتًا
`server_error`	عطل في الـ upstream/الشبكة الهاتفيّة
`invalid_number`	وجهة غير صالحة
`timeout`	مكالمة أُزيلت من الطابور قبل الاتصال (لا يرنّ الهاتف): `call.initiated` ثمّ `call.timeout`

curl -X POST https://api.wave.sa/v1/callback \
  -H "Authorization: Bearer sk_sandbox_xxxxxxxxxxxx" \
  -H "X-Wave-Simulate: server_error" \
  -H "Content-Type: application/json" \
  -d '{ "to": "+966500000000" }'

الحدود

تخضع الـ sandbox keys لحدود المعدّل — راجع حدود المعدّل.

البدء

الصوت

Web Callback

واتساب

المرجع

وضع الـ Sandbox

دقائق الـ sandbox

Go-Live

يرى كلّ مفتاح بيئته فقط

إعادة ضبط الـ sandbox

أرقام الاختبار والأخطاء المحاكاة

الحدود

​دقائق الـ sandbox

​Go-Live

​يرى كلّ مفتاح بيئته فقط

​إعادة ضبط الـ sandbox

​أرقام الاختبار والأخطاء المحاكاة

​الحدود

دقائق الـ sandbox

Go-Live

يرى كلّ مفتاح بيئته فقط

إعادة ضبط الـ sandbox

أرقام الاختبار والأخطاء المحاكاة

الحدود