Skip to main content
الرقم الافتراضيّ هو رقم سعوديّ (DID) مخصّص لأحد مستخدميك. حين يتّصل به أحدهم، يردّ Wave ويشغّل تعليمات ذلك المستخدم — رمز بوّابة، ملاحظات تسليم، تحيّة — أو يحوّل المكالمة إلى رقمه الحقيقيّ دون كشفه. لا يحتاج مستخدمك لنشر رقمه الشخصيّ أبدًا.
تستخدم الأرقام الافتراضيّة مفتاح production (sk_live_) ونطاقَي virtual_numbers:write / virtual_numbers:read. اطلب من جهة اتّصالك في Wave تفعيل الميزة لحسابك.

تخصيص رقم لمستخدم

POST /v1/virtual-numbers. عرّف المستخدم بـ مُعرّفك أنت (external_user_id) — والطلب idempotent على هذا المُعرّف، فإعادة المحاولة تُعيد الرقم نفسه بدل تخصيص رقم ثانٍ.

الطلب

الاستجابة — 201 Created (أو 200 OK عند إعادة المحاولة)

يبدأ صوت audio_url المُسجَّل فورًا؛ أمّا text فيمرّ بتحويل النصّ إلى كلام. اضبط الاثنين ويفوز الصوت — فتبدأ بالنصّ اليوم وتترقّى لتسجيل لاحقًا دون تغيير في الشيفرة.

تحديث تعليمات مستخدم

PUT /v1/virtual-numbers/:id/instructions — تُحرَّر في مكانها، دون إعادة تخصيص.
cURL

القائمة والبحث

GET /v1/virtual-numbers — رشّح بـ external_user_id، وقسّم الصفحات بـ limit (≤100) وoffset. ويُعيد GET /v1/virtual-numbers/:id عنصرًا واحدًا.

تحرير رقم

DELETE /v1/virtual-numbers/:id يُعيد الرقم إلى المجمّع ويحرّر المستخدم لتخصيص رقم آخر لاحقًا.
التعليمات بيانات شخصيّة لمستخدميك — رمز بوّابة، عنوان، رقم هاتف حقيقيّ. لا يسجّل Wave محتواها أبدًا. تعامَل مع ما تخزّنه من أرقام وتعليمات بالعناية نفسها.

الخطوات التالية

كيف يعمل الصوت

دورة حياة المكالمة خلف الرقم الافتراضيّ.

Webhooks

اطّلع على إشعار عند طلب رقم افتراضيّ.