> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wave.sa/llms.txt
> Use this file to discover all available pages before exploring further.
# كيف يعمل الصوت
> شكل مكالمة Wave الصوتيّة — الأرقام، ومسارات المكالمة، والأحداث.
تتكوّن أيّ مكالمة صوتيّة على Wave من ثلاثة أجزاء:
الرقم (أو مستخدم SIP) هو نقطة الدخول — يتّصل به أحدهم، أو تُجري أنت مكالمة منه.
يقرّر **مسار المكالمة** ما تفعله المكالمة، مكتوبًا بلغة [WaveML](/ar/voice/waveml) —
تشغيل رسالة، جمع رقم، تحويل، تسجيل، أو تسليم المكالمة لوكيل ذكاء اصطناعيّ.
يُرسَل كلّ تغيّر في الحالة (رنين، ردّ، انتهاء، ضغطة زرّ) إلى
[الـ webhook endpoint](/ar/webhooks) الخاصّ بك.
## دورة حياة المكالمة
إمّا أن يتّصل أحدهم برقمك (**وارد**)، أو تُجري أنت مكالمة عبر
[Callbacks API](/ar/quickstart) (**صادر**). تحصل كلّ مكالمة على مُعرّف ثابت
`wave_call_id` (UUID) يظهر في كلّ أحداثها وفي سجلّات المكالمات.
يجلب محرّك Wave الصوتيّ مسار مكالمتك وينفّذه أمرًا بأمر. وإن احتاج المسار إلى
مُدخَل (رقم من لوحة المفاتيح، أو نتيجة وكيل ذكاء اصطناعيّ) يتوقّف المحرّك، يجمعه،
ثمّ يُكمِل — راجِع الحلقة أدناه.
مع تقدّم المكالمة، يُرسِل Wave أحداثًا موقّعة إلى نقطتك: `call.initiated`،
`call.answered`، `call.ended`، و — عند اختيار المتّصل من قائمة — `call.input`.
عند انتهائها، تظهر المكالمة (مع المدّة والحالة وأيّ مؤشّر تسجيل) في
`GET /v1/calls`.
## حلقة مسار المكالمة
تعمل مسارات المكالمة عبر **حلقة مُجزّأة**. حين يحتاج المحرّك إلى تعليمات يُرسِل إلى
مسارك طلب JSON؛ فتردّ أنت بمستند [WaveML](/ar/voice/waveml). الحقل `node_id` على كلّ
أمر هو مؤشّر يُعيده المحرّك إليك، فيعرف مسارك دائمًا أين وصلت المكالمة.
```json theme={null}
// ما يُرسِله المحرّك إلى مسارك
{
"wave_call_id": "27d6dd39-f9e8-4fed-b378-a830b23bacd3",
"src_number": "0115209300",
"dst_number": "9001",
"direction": "inbound",
"node_id": "", // المؤشّر — فارغ في الطلب الأوّل
"dtmf": "", // الأرقام التي جمعها السابق
"aiagent_result": "" // نتيجة السابق
}
```
تردّ بـ WaveML. عند `` تعود أرقام المتّصل في الطلب التالي عبر `dtmf`؛ وعند
`` تعود النتيجة عبر `aiagent_result`. تفرّع بناءً على `node_id` والمُدخَل.
**أين تُخزّن المسارات اليوم.** ينفّذ المحرّك WaveML، لكن مسارات المكالمة تُهيَّأ
حاليًّا لحسابك (لوحة التحكّم + جهة اتّصالك في Wave) لا عبر API عامّ — وواجهة تأليف
المسارات على خارطة الطريق. أمّا ما عدا ذلك — إجراء المكالمات، واستقبال الأحداث،
وقراءة السجلّات، وتخصيص الأرقام، وإدارة الطوابير — فمتاح اليوم.
## الأحداث التي يمكنك الاشتراك بها
سجّل endpoint في [Webhooks](/ar/webhooks) واشترك في أحداث الصوت:
| الحدث | متى |
| ----------------------------------------------------------------- | ------------------------------------------------------- |
| `call.initiated` | أُجريت المكالمة / وصلت. |
| `call.answered` | ردّ الطرف الآخر. |
| `call.ended` | اكتملت المكالمة. |
| `call.missed` · `call.timeout` · `call.failed` · `call.cancelled` | لم تتّصل المكالمة. |
| `call.input` | ضغط المتّصل زرًّا في `` — يحمل `{ digits, … }`. |
## ما يمكنك بناؤه اليوم
كلّ أمر يمكن لمسار المكالمة استخدامه.
امنح كلّ مستخدم من مستخدميك رقمه السعوديّ الخاصّ.
وجّه المتّصلين إلى الوكلاء وأدِر من سجّل دخوله.
استقبِل أحداث المكالمات على نقطتك.