Skip to main content
تتكوّن أيّ مكالمة صوتيّة على Wave من ثلاثة أجزاء:

الأرقام

الرقم (أو مستخدم SIP) هو نقطة الدخول — يتّصل به أحدهم، أو تُجري أنت مكالمة منه.

مسارات المكالمة

يقرّر مسار المكالمة ما تفعله المكالمة، مكتوبًا بلغة WaveML — تشغيل رسالة، جمع رقم، تحويل، تسجيل، أو تسليم المكالمة لوكيل ذكاء اصطناعيّ.

الأحداث

يُرسَل كلّ تغيّر في الحالة (رنين، ردّ، انتهاء، ضغطة زرّ) إلى الـ webhook endpoint الخاصّ بك.

​
دورة حياة المكالمة

1

تبدأ المكالمة

إمّا أن يتّصل أحدهم برقمك (وارد)، أو تُجري أنت مكالمة عبر Callbacks API (صادر). تحصل كلّ مكالمة على مُعرّف ثابت wave_call_id (UUID) يظهر في كلّ أحداثها وفي سجلّات المكالمات.
2

يشغّل المحرّك مسار مكالمتك

يجلب محرّك Wave الصوتيّ مسار مكالمتك وينفّذه أمرًا بأمر. وإن احتاج المسار إلى مُدخَل (رقم من لوحة المفاتيح، أو نتيجة وكيل ذكاء اصطناعيّ) يتوقّف المحرّك، يجمعه، ثمّ يُكمِل — راجِع الحلقة أدناه.
3

تصل الأحداث إلى الـ webhook

مع تقدّم المكالمة، يُرسِل Wave أحداثًا موقّعة إلى نقطتك: call.initiated، call.answered، call.ended، و — عند اختيار المتّصل من قائمة — call.input.
4

تظهر المكالمة في سجلّاتك

عند انتهائها، تظهر المكالمة (مع المدّة والحالة وأيّ مؤشّر تسجيل) في GET /v1/calls.

​
حلقة مسار المكالمة

تعمل مسارات المكالمة عبر حلقة مُجزّأة. حين يحتاج المحرّك إلى تعليمات يُرسِل إلى مسارك طلب JSON؛ فتردّ أنت بمستند WaveML. الحقل node_id على كلّ أمر هو مؤشّر يُعيده المحرّك إليك، فيعرف مسارك دائمًا أين وصلت المكالمة.
تردّ بـ WaveML. عند <Gather> تعود أرقام المتّصل في الطلب التالي عبر dtmf؛ وعند <AIAgent> تعود النتيجة عبر aiagent_result. تفرّع بناءً على node_id والمُدخَل.
أين تُخزّن المسارات اليوم. ينفّذ المحرّك WaveML، لكن مسارات المكالمة تُهيَّأ حاليًّا لحسابك (لوحة التحكّم + جهة اتّصالك في Wave) لا عبر API عامّ — وواجهة تأليف المسارات على خارطة الطريق. أمّا ما عدا ذلك — إجراء المكالمات، واستقبال الأحداث، وقراءة السجلّات، وتخصيص الأرقام، وإدارة الطوابير — فمتاح اليوم.

​
الأحداث التي يمكنك الاشتراك بها

سجّل endpoint في Webhooks واشترك في أحداث الصوت:

​
ما يمكنك بناؤه اليوم

مرجع WaveML

كلّ أمر يمكن لمسار المكالمة استخدامه.

الأرقام الافتراضيّة

امنح كلّ مستخدم من مستخدميك رقمه السعوديّ الخاصّ.

الطوابير

وجّه المتّصلين إلى الوكلاء وأدِر من سجّل دخوله.

Webhooks

استقبِل أحداث المكالمات على نقطتك.