الصوت البرمجي عبر REST وJSON: مكالمات، وأرقام سعودية، وتحكم بالمكالمة، ومسارات مكالمات، وتحقق. مفتاح واحد، وأكثر من 80 نقطة وصول، و22 حدث Webhook موقّعًا، وتوثيق تقرؤه أدواتك الذكية.
بيئة تجربة مجانية، ومكالمات حقيقية إلى رقمك الموثّق، والانتقال للإنتاج بعد مراجعة قصيرة.
كل ما هنا يعمل في بيئة التجربة. البيئة مجانية، والمكالمة ترن على رقمك الموثّق.
تحقق من هويتك مرة واحدة، وهذا كل ما تحتاجه بيئة التجربة.
تجده في لوحة التحكم. مفاتيح التجربة تبدأ بـ sk_sandbox_ ومفاتيح الإنتاج بـ sk_live_.
POST /v1/callbackمرّر الرقم بصيغة E.164، واختر لغة البرمجة من اللوحة المجاورة.
تكون الحالة "initiated" ويبدأ هاتفك بالرنين.
curl -X POST https://api.wave.sa/v1/callback \
-H "Authorization: Bearer sk_sandbox_xxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{ "to": "+966500000000" }'{ "call_id": "call_abc123", "status": "initiated", "sandbox": true }رد مختصر. الشكل الكامل موجود في مرجع API.
وجّه مساعدك البرمجي إلى التوثيق، وسيفهم الـAPI كاملًا بصيغ يقرؤها بسهولة: فهارس نصية، وصفحة Markdown لكل موضوع، ومواصفات OpenAPI.
جرّب هذا الطلب مع مساعدك
اقرأ https://docs.wave.sa/llms.txt وأضف زر اتصال من ويڤ إلى صفحة الدفع في متجري.
يقرأ مساعدك الفهرس، ويجد الدليل المناسب، ويكتب لك مسودة التكامل لتراجعها.
تعمل على بيانات المحادثات؟ خادم MCP في Wave Insights يتيح للمساعدات الذكية الاستعلام عن بياناتك مباشرة.
فهرس نصي لكل صفحات التوثيق، وأول ملف يقرؤه مساعدك.
التوثيق كاملًا في ملف واحد، للأدوات التي تفضّل تحميل كل شيء دفعة واحدة.
كل نقطة وصول بمعاملاتها وردودها في ملف واحد قابل للقراءة الآلية، تولّد منه الأنواع أو عميل الـAPI.
docs.wave.sa/api-reference/openapi.jsonكل صفحة توثيق متاحة أيضًا بصيغة Markdown نظيفة، دون تنسيقات تعيق القراءة.
105 صفحات توثيق بالعربية بفهارسها الخاصة، لتعمل أنت ومساعدك بالعربية من البداية إلى النهاية.
الـAPI نفسه والأحداث نفسها، مجانًا. مكالمات حقيقية إلى رقمك، وأرقام اختبار تُطلق أحداث Webhook، وأخطاء عند الطلب.
اختر سيناريو
مكالمات حقيقية، مجانًا
مكالمات التجربة ترن على رقمك الموثّق، فتسمع ما سيسمعه مستخدموك.
أرقام اختبار
اتصل برقم اختبار لتُطلق أحداث Webhook محاكاة دون أن تتصل بأحد.
أخطاء عند الطلب
اضبط الترويسة X-Wave-Simulate على إحدى القيم:
تسلسل توضيحي، والتوقيتات تقريبية.
جاهز للإنتاج؟ استبدل sk_sandbox_ بـ sk_live_ بعد مراجعة قصيرة.
المكالمات وعمليات التحقق والبريد الصوتي والرسائل تُبلغ خادمك بحالتها، بتوقيع HMAC-SHA256 يؤكد أنها من ويڤ.
X-Wave-Signature: sha256=<hex>import crypto from "node:crypto";
function verifyWaveSignature(rawBody, header, secret) {
if (!header?.startsWith("sha256=")) return false;
const expected =
"sha256=" + crypto.createHmac("sha256", secret).update(rawBody).digest("hex");
return crypto.timingSafeEqual(Buffer.from(header), Buffer.from(expected));
}قارن بزمن ثابت، وعلى المحتوى الخام، قبل أن تحلّله.
5 محاولات على مدى ساعتين ونصف تقريبًا، وكل محاولة تظهر في سجل التسليم.
التوافر، وصفحة الحالة، وبقاء البيانات داخل المملكة، والقياسات المباشرة: ما تتحقق منه قبل أن تضع الصوت في مسار حرج من منتجك.
اتفاقية مستوى الخدمة للتوافر (SLA)
99.9%
التزام بتوافر Wave API، تدعمه صفحة حالة عامة وسجل معلن للأعطال.
المكالمات
تعمل
Webhooks
تعمل
لوحة التحكم
تعمل
بيانات توضيحية. السجل الفعلي على status.wave.sa.
حزمة الاتصال من المتصفح تقيس MOS والتذبذب وفقد الحزم وزمن الذهاب والإياب (RTT) لكل مكالمة، مباشرة.
MOS
4.3
jitter
6 ms
loss
0.2 %
RTT
48 ms
قراءة توضيحية من مكالمة تجريبية.
بيانات مكالماتك تبقى في المملكة العربية السعودية.
كل تسجيل متاح لمدة 90 يومًا بعد المكالمة، مع روابط تنزيل موقّعة ومحدودة المدة.
أرسل Idempotency-Key مع المسارات الأساسية، وأعد المحاولة بعد انتهاء المهلة دون أن تتكرر المكالمة.
ترويسات الحدود في كل رد، وحماية من اندفاع المكالمات توقف الحلقات الخاطئة. التفاصيل
سجل الطلبات. كل طلب API، قابل للتصفية، ومربوط بنفس request_id الذي يصلك في رسائل الخطأ.
صيغة خطأ ثابتة بالعربية والإنجليزية، وضوابط تمنع خطأً برمجيًا في حلقة تكرار من أن يتحول إلى فاتورة اتصالات.
{
"error_code": "VALIDATION_ERROR",
"message": "to must be a valid KSA phone number",
"message_ar": "خطأ في التحقق من البيانات",
"request_id": "req_abc123",
"docs_url": "https://wave.sa/docs/errors"
}رمز ثابت تبني عليه منطقك، ورسالة بالعربية والإنجليزية تعرضها لمستخدميك، ومعرّف طلب للدعم، ورابط يشرح الحل.
مفاتيح لكل مشروع بصلاحيات تُطبَّق على كل مسار، وتستطيع تدويرها أو إلغاءها متى شئت.
اعرف موقعك من الحد، وتمهّل في الوقت المناسب.
أي ارتفاع مفاجئ في المكالمات الصادرة يعيد CALL_VELOCITY_EXCEEDED مع ترويسة Retry-After، قبل أن تتصل حلقة خاطئة بآلاف الأشخاص.
لا يظهر للطرف الآخر إلا رقم تملكه، وأي رقم آخر يعيد CLI_NOT_OWNED.
GET /v1/usage يعيد عدد المكالمات والمُجابة والفائتة والدقائق والتكلفة التقديرية بالريال.
توفر WaveML الأوامر Play وSay وGather وDial وEnqueue وRecord وAIAgent وPause وHangup، مع تحويل النص إلى كلام بالعربية والإنجليزية. هذا الرد الآلي (IVR) يطلب من المتصل اختيار المبيعات أو الدعم، ثم يضعه في قائمة الانتظار بالتناوب.
Play · Say · Gather · Dial · Enqueue · Record · AIAgent · Pause · Hangup
<Response>
<Gather numDigits="1">
<Say language="ar">
للمبيعات اضغط 1، وللدعم اضغط 2
</Say>
</Gather>
<Enqueue strategy="round-robin">support</Enqueue>
</Response>اتصال داخل تطبيقك على iOS وAndroid، بالحساب والأرقام والأحداث نفسها التي يستخدمها تطبيق الويب.
اربط مشغّلك الحالي أو مقسمك (PBX) بويڤ، واحتفظ ببنيتك وأنت تضيف التحكم البرمجي بالمكالمات.
رسائل A2P باسم مرسل أبجدي، لتصل رسائلك باسم علامتك التجارية.
رموز لمرة واحدة بحد للمحاولات عبر واتساب أو الرسائل النصية أو مكالمة صوتية، ويُختم كل تحقق بحدث verify.completed.
تكاملات جاهزة حيث توفر عليك الوقت، ومواصفات مفتوحة لكل ما عدا ذلك.
يضيف تجار سلة وزد خدمة الاتصال من ويڤ إلى متاجرهم عبر التطبيق.
تعرّف على تطبيق المتجرأثرِ سجلات العملاء، وأرسل سياق المحادثات إلى HubSpot.
دع المساعدات الذكية تستعلم عن بيانات Insights مباشرة، بمفاتيح خاصة بكل جهة.
دخول موحّد (SSO) بهوية شركتك، حتى على الشبكات المغلقة.
استوردها في أداة اختبار الـAPI لديك، أو ولّد منها الأنواع، أو اربط ويڤ بأدواتك الداخلية.
كل نقطة وصول، بالعربية والإنجليزية.
docs.wave.saما الذي تغيّر، ومتى.
docs.wave.sa/changelogكل أمر وخاصية لبناء مسارات المكالمات.
docs.wave.saالأحداث الـ22، والتوقيع، وإعادة المحاولة والإرسال.
docs.wave.saواجهتك مشكلة؟ تحدّث مع فريقنا السعودي.
فريق حقيقي داخل المملكة، من الأحد إلى الخميس، عبر البريد وواتساب، بالعربية أو الإنجليزية.