أول مكالمة لك في أقل من خمس دقائق.

الصوت البرمجي عبر REST وJSON: مكالمات، وأرقام سعودية، وتحكم بالمكالمة، ومسارات مكالمات، وتحقق. مفتاح واحد، وأكثر من 80 نقطة وصول، و22 حدث Webhook موقّعًا، وتوثيق تقرؤه أدواتك الذكية.

بيئة تجربة مجانية، ومكالمات حقيقية إلى رقمك الموثّق، والانتقال للإنتاج بعد مراجعة قصيرة.

أول مكالمة، في أربع خطوات.

كل ما هنا يعمل في بيئة التجربة. البيئة مجانية، والمكالمة ترن على رقمك الموثّق.

  1. 1

    سجّل عبر نفاذ

    تحقق من هويتك مرة واحدة، وهذا كل ما تحتاجه بيئة التجربة.

  2. 2

    انسخ مفتاح التجربة

    تجده في لوحة التحكم. مفاتيح التجربة تبدأ بـ sk_sandbox_ ومفاتيح الإنتاج بـ sk_live_.

  3. 3

    أرسل POST /v1/callback

    مرّر الرقم بصيغة E.164، واختر لغة البرمجة من اللوحة المجاورة.

  4. 4

    يصلك الرد 202

    تكون الحالة "initiated" ويبدأ هاتفك بالرنين.

POST /v1/callback
curl -X POST https://api.wave.sa/v1/callback \
  -H "Authorization: Bearer sk_sandbox_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{ "to": "+966500000000" }'
Response202 Accepted
{ "call_id": "call_abc123", "status": "initiated", "sandbox": true }

رد مختصر. الشكل الكامل موجود في مرجع API.

توثيق تقرؤه أدواتك الذكية.

وجّه مساعدك البرمجي إلى التوثيق، وسيفهم الـAPI كاملًا بصيغ يقرؤها بسهولة: فهارس نصية، وصفحة Markdown لكل موضوع، ومواصفات OpenAPI.

جرّب هذا الطلب مع مساعدك

اقرأ https://docs.wave.sa/llms.txt وأضف زر اتصال من ويڤ إلى صفحة الدفع في متجري.

يقرأ مساعدك الفهرس، ويجد الدليل المناسب، ويكتب لك مسودة التكامل لتراجعها.

تعمل على بيانات المحادثات؟ خادم MCP في Wave Insights يتيح للمساعدات الذكية الاستعلام عن بياناتك مباشرة.

llms.txt

فهرس نصي لكل صفحات التوثيق، وأول ملف يقرؤه مساعدك.

llms-full.txt

التوثيق كاملًا في ملف واحد، للأدوات التي تفضّل تحميل كل شيء دفعة واحدة.

مواصفات OpenAPI

كل نقطة وصول بمعاملاتها وردودها في ملف واحد قابل للقراءة الآلية، تولّد منه الأنواع أو عميل الـAPI.

docs.wave.sa/api-reference/openapi.json
Markdown

كل صفحة توثيق متاحة أيضًا بصيغة Markdown نظيفة، دون تنسيقات تعيق القراءة.

فهارس عربية

105 صفحات توثيق بالعربية بفهارسها الخاصة، لتعمل أنت ومساعدك بالعربية من البداية إلى النهاية.

اختبر الفشل في بيئة التجربة، قبل أن يصل إلى الإنتاج.

الـAPI نفسه والأحداث نفسها، مجانًا. مكالمات حقيقية إلى رقمك، وأرقام اختبار تُطلق أحداث Webhook، وأخطاء عند الطلب.

اختر سيناريو

مكالمات حقيقية، مجانًا

مكالمات التجربة ترن على رقمك الموثّق، فتسمع ما سيسمعه مستخدموك.

أرقام اختبار

اتصل برقم اختبار لتُطلق أحداث Webhook محاكاة دون أن تتصل بأحد.

أخطاء عند الطلب

اضبط الترويسة X-Wave-Simulate على إحدى القيم:

rate_limitinvalid_queuequeue_unavailableserver_errorinvalid_number
محاكي المكالماتanswered
POST /v1/callback
Authorization: Bearer sk_sandbox_xxxxxxxxxxxx
  1. T+0sطلبPOST /v1/callbackto: +966500000000
  2. T+0sرد202 Acceptedcall_id: call_abc123 · status: initiated
  3. T+0sحدثcall.initiatedموقّع بترويسة X-Wave-Signature
  4. T+6sحدثcall.answeredيرد رقمك الموثّق
  5. T+48sحدثcall.endedانتهت المكالمة
  6. T+48sسجلسجل المكالماتسُجّلت المكالمة والرقم مخفي

تسلسل توضيحي، والتوقيتات تقريبية.

جاهز للإنتاج؟ استبدل sk_sandbox_ بـ sk_live_ بعد مراجعة قصيرة.

اطّلع على الأسعار

22 حدثًا موقّعًا، مع إعادة المحاولة والسجل وإعادة الإرسال.

المكالمات وعمليات التحقق والبريد الصوتي والرسائل تُبلغ خادمك بحالتها، بتوقيع HMAC-SHA256 يؤكد أنها من ويڤ.

call.initiatedcall.answeredcall.endedcall.missedcall.transferredcall.inputvoice_auth.completedverify.completedvoicemail.receivedconference.createdmessage.receivedmessage.deliveredو10 أحداث أخرى
التحقق من التوقيع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));
}

قارن بزمن ثابت، وعلى المحتوى الخام، قبل أن تحلّله.

سجل التسليم
بث توضيحي
timeeventstatus

خادمك متوقف؟ ويڤ تواصل المحاولة.

5 محاولات على مدى ساعتين ونصف تقريبًا، وكل محاولة تظهر في سجل التسليم.

أعد الإرسال من لوحة التحكم خلال 72 ساعة

ضمانات تبني عليها بثقة.

التوافر، وصفحة الحالة، وبقاء البيانات داخل المملكة، والقياسات المباشرة: ما تتحقق منه قبل أن تضع الصوت في مسار حرج من منتجك.

اتفاقية مستوى الخدمة للتوافر (SLA)

99.9%

التزام بتوافر Wave API، تدعمه صفحة حالة عامة وسجل معلن للأعطال.

جميع الأنظمة تعمل
status.wave.sa
Wave APIالتوافر خلال 90 يومًا
قبل 90 يومًااليوم

المكالمات

تعمل

Webhooks

تعمل

لوحة التحكم

تعمل

بيانات توضيحية. السجل الفعلي على status.wave.sa.

جودة الصوت، كل 5 ثوانٍ

حزمة الاتصال من المتصفح تقيس MOS والتذبذب وفقد الحزم وزمن الذهاب والإياب (RTT) لكل مكالمة، مباشرة.

MOS

4.3

jitter

6 ms

loss

0.2 %

RTT

48 ms

قراءة توضيحية من مكالمة تجريبية.

بقاء البيانات داخل المملكة

بيانات مكالماتك تبقى في المملكة العربية السعودية.

التسجيلات متاحة 90 يومًا

كل تسجيل متاح لمدة 90 يومًا بعد المكالمة، مع روابط تنزيل موقّعة ومحدودة المدة.

مفاتيح منع التكرار

أرسل Idempotency-Key مع المسارات الأساسية، وأعد المحاولة بعد انتهاء المهلة دون أن تتكرر المكالمة.

حدود الطلبات وحماية الاندفاع

ترويسات الحدود في كل رد، وحماية من اندفاع المكالمات توقف الحلقات الخاطئة. التفاصيل

سجل الطلبات. كل طلب API، قابل للتصفية، ومربوط بنفس request_id الذي يصلك في رسائل الخطأ.

-------------------------------------------------------------
| method | path | status | latency |
-------------------------------------------------------------
| POST | /v1/callback | 202 | 84ms |
| GET | /v1/calls | 200 | 41ms |
| POST | /v1/calls | 202 | 97ms |
| POST | /v1/callback | 429 | 6ms |
| GET | /v1/usage | 200 | 58ms |
| POST | /v1/virtual-numbers | 201 | 112ms |
| POST | /v1/calls | 429 | 5ms |
| GET | /v1/calls/{id}/recording | 200 | 73ms |

أخطاء تبني عليها منطقك. وحدود تقرؤها في كل رد.

صيغة خطأ ثابتة بالعربية والإنجليزية، وضوابط تمنع خطأً برمجيًا في حلقة تكرار من أن يتحول إلى فاتورة اتصالات.

صيغة الخطأبالعربية والإنجليزية
{
  "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"
}

رمز ثابت تبني عليه منطقك، ورسالة بالعربية والإنجليزية تعرضها لمستخدميك، ومعرّف طلب للدعم، ورابط يشرح الحل.

مفاتيح API بصلاحيات محددة

مفاتيح لكل مشروع بصلاحيات تُطبَّق على كل مسار، وتستطيع تدويرها أو إلغاءها متى شئت.

ترويسات حدود الطلبات في كل رد

اعرف موقعك من الحد، وتمهّل في الوقت المناسب.

x-ratelimit-limitx-ratelimit-remainingx-ratelimit-resetretry-after

حماية من اندفاع المكالمات

أي ارتفاع مفاجئ في المكالمات الصادرة يعيد CALL_VELOCITY_EXCEEDED مع ترويسة Retry-After، قبل أن تتصل حلقة خاطئة بآلاف الأشخاص.

حماية هوية المتصل

لا يظهر للطرف الآخر إلا رقم تملكه، وأي رقم آخر يعيد CLI_NOT_OWNED.

استهلاك تستعلم عنه متى شئت

GET /v1/usage يعيد عدد المكالمات والمُجابة والفائتة والدقائق والتكلفة التقديرية بالريال.

وحدات جاهزة، انسخها وابدأ.

اكتشف Wave APIs

صِف المكالمة في بضعة أسطر.

توفر WaveML الأوامر Play وSay وGather وDial وEnqueue وRecord وAIAgent وPause وHangup، مع تحويل النص إلى كلام بالعربية والإنجليزية. هذا الرد الآلي (IVR) يطلب من المتصل اختيار المبيعات أو الدعم، ثم يضعه في قائمة الانتظار بالتناوب.

Play · Say · Gather · Dial · Enqueue · Record · AIAgent · Pause · Hangup

menu.xml
<Response>
  <Gather numDigits="1">
    <Say language="ar">
      للمبيعات اضغط 1، وللدعم اضغط 2
    </Say>
  </Gather>
  <Enqueue strategy="round-robin">support</Enqueue>
</Response>

طرق أخرى للبناء

حزم الاتصال للجوال

اتصال داخل تطبيقك على iOS وAndroid، بالحساب والأرقام والأحداث نفسها التي يستخدمها تطبيق الويب.

ربط خط SIP الخاص بك

اربط مشغّلك الحالي أو مقسمك (PBX) بويڤ، واحتفظ ببنيتك وأنت تضيف التحكم البرمجي بالمكالمات.

الرسائل النصية واسم المرسل

رسائل A2P باسم مرسل أبجدي، لتصل رسائلك باسم علامتك التجارية.

التحقق عبر أي قناة

رموز لمرة واحدة بحد للمحاولات عبر واتساب أو الرسائل النصية أو مكالمة صوتية، ويُختم كل تحقق بحدث verify.completed.

يعمل مع الأدوات التي تستخدمها.

تكاملات جاهزة حيث توفر عليك الوقت، ومواصفات مفتوحة لكل ما عدا ذلك.

تطبيق ويڤ لمتاجر سلة وزد

يضيف تجار سلة وزد خدمة الاتصال من ويڤ إلى متاجرهم عبر التطبيق.

تعرّف على تطبيق المتجر
Wave Insights

HubSpot

أثرِ سجلات العملاء، وأرسل سياق المحادثات إلى HubSpot.

Wave Insights

خادم MCP

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

Wave Insights

Microsoft Entra ID وActive Directory

دخول موحّد (SSO) بهوية شركتك، حتى على الشبكات المغلقة.

Wave APIs

مواصفات OpenAPI

استوردها في أداة اختبار الـAPI لديك، أو ولّد منها الأنواع، أو اربط ويڤ بأدواتك الداخلية.

كل ما تحتاجه، في مكان واحد.

واجهتك مشكلة؟ تحدّث مع فريقنا السعودي.

فريق حقيقي داخل المملكة، من الأحد إلى الخميس، عبر البريد وواتساب، بالعربية أو الإنجليزية.

تواصل مع الدعم

مفتاح التجربة بانتظارك.

ويڤ للمطورين — واجهة الصوت البرمجي في المملكة العربية السعودية