Skip to main content
WaveML هي لغة XML صغيرة تصف ما يحدث في المكالمة: تشغيل رسالة، جمع رقم، التحويل إلى وكيل، التسجيل، أو التسليم لوكيل صوتيّ بالذكاء الاصطناعيّ. إن كنت تعرف TwiML فستجد WaveML مألوفة.
كيف تُؤلَّف المسارات اليوم. WaveML هي ما ينفّذه محرّك Wave الصوتيّ. حاليًّا تُهيَّأ مسارات المكالمة لحسابك (لوحة التحكّم + جهة اتّصالك في Wave) لا عبر API عامّ — وواجهة تأليف المسارات على خارطة الطريق. هذه الصفحة هي مرجع اللغة نفسها لتعرف بدقّة ما يستطيع المسار فعله.

غلاف الاستجابة

حين تحتاج المكالمة إلى تعليمات، يُرسِل المحرّك طلبًا إلى مسارك وينتظر مستند WaveML ردًّا. تُنفَّذ الأوامر من الأعلى للأسفل؛ وتنتهي المكالمة عند <Hangup> أو <Response> فارغ.
في أوّل ردّ للمكالمة، اضبط wave_tenant وحدّ التزامنه wave_tenant_cc على جذر <Response>. يحمل كلّ أمر node_id — وهو مؤشّر يُعيده المحرّك في طلبه التالي ليعرف مسارك أين وصلت المكالمة. راجِع كيف يعمل الصوت للحلقة الكاملة.

Play

تشغيل ملفّ صوتيّ (WAV/MP3 عبر HTTPS).

Say

نطق نصّ عبر تحويل النصّ إلى كلام. العربيّة والإنجليزيّة مدعومتان.
يبدأ صوت <Play> المُسجَّل فورًا؛ أمّا <Say> فيمرّ بتحويل النصّ إلى كلام. للرسائل الثابتة، فضّل <Play>.

Gather

جمع مُدخَل DTMF (لوحة المفاتيح). ضع <Say> أو <Play> بداخله كرسالة؛ وتصل الأرقام التي يضغطها المتّصل في الطلب التالي عبر dtmf.

Dial

تحويل المكالمة إلى رقم آخر أو مستخدم SIP. يرى الطرف المطلوب callerId.

Enqueue

وضع المتّصل في طابور مركز اتّصال. يرنّ الوكلاء المسجَّل دخولهم — تُدار إدارتهم عبر واجهة الطوابير. اسم الطابور هو نصّ العنصر؛ وتُنشَأ الطوابير عند الطلب.

Record

تسجيل المكالمة. بما أنّ <Enqueue>/<Say> لا يملكان خاصّيّة تسجيل مضمّنة، فإنّ <Record background="true"/> المستقلّ يُفعِّل التسجيل لمكالمة تتدفّق بعدها إلى أوامر أخرى.

AIAgent

تسليم المكالمة لوكيل صوتيّ بالذكاء الاصطناعيّ في الزمن الحقيقيّ. يعمل تحويل الكلام إلى نصّ، ونموذج لغويّ، وتحويل النصّ إلى كلام بشكل حيّ، مع إمكان المقاطعة. نصّ العنصر هو موجِّه شخصيّة الوكيل.
<AIAgent> ليس أمرًا نهائيًّا. عند انتهاء المحادثة، يعود المحرّك إلى مسارك بـ node_id هذا الأمر وكلمة نتيجة aiagent_resultcompleted أو transfer أو dnc أو أيّ كلمة يعرّفها موجِّهك — ويقرّر مسارك ما يحدث تاليًا:
عالِج دائمًا أيّ aiagent_result غير معروف بحلّ احتياطيّ آمن — ومعاملته كـ completed وإنهاء المكالمة خيار افتراضيّ جيّد.

Pause

انتظار صامت.

Hangup

إنهاء المكالمة.

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

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

حلقة الطلب/الاستجابة التي يقودها المحرّك.

الطوابير

سجّل دخول الوكلاء وخروجهم من طوابير <Enqueue>.