بناء وكلاء صوت ذكاء اصطناعي مخصّصين على 3CX: Programmable Extensions وواجهة Call Control API

وكيل الصوت الذكي المخصّص على 3CX هو تطبيق مُستضاف خارجيًا يتصل بمقسمك، وينقل صوت المتصل في الاتجاهين، ويتحكم في توجيه المكالمة — عبر دمج واجهتَي تطوير من 3CX مع مزوّد ذكاء اصطناعي خارجي. وهاتان الواجهتان لهما حالتا إصدار مختلفتان تمامًا، والتمييز بينهما هو جوهر هذا المقال. فميزة Programmable Extensions — وهي الطريقة المعتمدة رسميًا لتشغيل تطبيق خارجي كـ extension على 3CX لأغراض الصوت الذكي — صدرت ضمن V20 Update 10 بحالة ALPHA (أُعلن عنها في 2026-07-30)، لأغراض الاختبار والتقييم فقط وليست للإنتاج. أما واجهة Call Control API التي تبني عليها فهي مُتاحة عامًا (GA) منذ V18 وجاهزة للإنتاج اليوم. يشرح هذا المقال كيفية تكامل المكوّنات، وما هو المستقر مقابل ما هو قيد المعاينة، وكيف يمكن لـ ECOLOR تصميم وبناء وتكامل واختبار ومراقبة ودعم وكيل صوتي لك.

المكوّنان الأساسيان — ولماذا تختلف حالتهما

يرتكز كل وكيل صوت ذكي مخصّص على 3CX على قدرتَي تطوير أصليتين إضافةً إلى «عقل» خارجي. احتفظ بحالة الإصدار لكلٍّ منهما منفصلة، ولا تدع أي مورّد يمزج ميزة Alpha في وعدٍ إنتاجي.

Programmable Extensions — ALPHA (V20 Update 10 Alpha، أُعلن عنها في 2026-07-30). تطبيق مُستضاف خارجيًا يتصل بالمقسم ويعمل كأنه extension أصلي: يمكنه الانضمام إلى المكالمات، واستقبال الصوت، ونقل الصوت في الاتجاهين، وقيادة التوجيه عبر Call Control API. هذه هي البنية الموثّقة رسميًا لوكلاء الصوت الذكي على 3CX — لكنها حتى أغسطس 2026 لأغراض الاختبار والتقييم فقط، ويجب عدم تثبيتها على أنظمة الإنتاج. ولتجربتها يجب أن يكون المقسم على V20 Update 9 أولًا، ثم اختيار Update 10 Alpha.
Call Control API — GA منذ V18 (إنتاجية). الواجهة الناضجة للتحكم البرمجي في المكالمات: إجراء المكالمات والرد عليها وتوجيهها وتحويلها وإنهاؤها ومراقبتها، واسترجاع معلومات المشاركين. تُتاح كواجهة Call Control Web API مع SDK رسمي بلغة TypeScript هو @3cx/call-control-sdk. وتتطلب ترخيص Enterprise بسعة 8SC فأكثر وصلاحية Call Flow Designer (CFD). وهي الأساس المستقر الذي تُبنى عليه ميزات الصوت في مرحلة Alpha.
مزوّد ذكاء اصطناعي خارجي (بمفتاحك الخاص). لا يقوم 3CX نفسه بتحويل الكلام إلى نص، ولا بالاستدلال، ولا بتحويل النص إلى كلام في مسار الوكيل المخصّص. فهذه القدرة تأتي دائمًا من مزوّد صوت خارجي في الوقت الحقيقي تربطه أنت وتتحمّل تكلفته مباشرة.

باختصار: «السباكة» التي تنقل الصوت وتتحكم في المكالمة (Call Control API) جاهزة للإنتاج؛ بينما مسار Programmable Extensions الذي يُغلّف تطبيقًا خارجيًا كـ extension لا يزال في مرحلة Alpha. نحن نبني ونتحقق مقابل كليهما، لكننا نُموضِع عمليات الإطلاق الإنتاجي بصدق وفق ما وصل إلى إصدار مستقر.

مزوّدو الذكاء الاصطناعي الأربعة الذين يوثّقهم 3CX رسميًا

يوثّق 3CX ويعرض رسميًا أربعة مزوّدي صوت في الوقت الحقيقي عبر مستودعه الرسمي على GitHub باسم agentic-call-control. كلٌّ منهم نمط تطوير بمفتاحك الخاص — فأنت توفّر حساب المزوّد ومفتاح الـ API، ويتولّى المزوّد التعرّف على الكلام والاستدلال وتوليد الكلام في تدفّق واحد ثنائي الاتجاه في الوقت الحقيقي:

OpenAI Realtime API
Google Gemini Live API
xAI Grok Voice Agent API
Alibaba Cloud Qwen Omni Realtime (DashScope)

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

البنية المرجعية: كيف يُجمَّع وكيل صوت ذكي مخصّص

النمط الموصى به رسميًا للوكيل المخصّص هو Programmable Extension خارجي يعمل بالكامل على بنيتك التحتية — دون الحاجة إلى شيفرة مصدرية أو تعديلات على 3CX. ينتقل الصوت بصيغة PCM بتردد 8 kHz و16-bit أحادي القناة (mono)، ويتصل المنسّق (orchestrator) بـ 3CX عبر WebSocket مع إعادة اتصال تلقائية. ويبدو البناء النموذجي كالتالي:

سجّل Service Principal في 3CX. من الـ Web Client، انتقل إلى Admin → Integrations → API، وأضِف service principal، وحدّد Client ID، وفعّل وصول Call Control API للتطبيق، وعيّن DID اختياريًا واختر الـ extensions التي يجوز له التحكم بها، ثم التقط الـ Client Secret (يُعرض مرة واحدة).
شغّل تطبيق المنسّق. باستخدام @3cx/call-control-sdk، يتصل التطبيق الخارجي بـ app ID وapp secret وعنوان PBX الأساسي، ثم ينضم إلى المكالمات كـ Programmable Extension.
اربط الصوت بمزوّد الذكاء الاصطناعي. ينقل المنسّق صوت المتصل بصيغة PCM إلى أحد المزوّدين الأربعة الموثّقين، ويعيد بثّ الصوت المُولّد من المزوّد داخل المكالمة — في الاتجاهين وفي الوقت الحقيقي.
امنح الوكيل أدواته. اربط إجراءات التحكم المحلية في المكالمة (تحويل، بريد صوتي، إنهاء، فرز)، واختياريًا عمليات بحث مثل دليل الهاتف، إضافةً إلى أدوات مخصّصة لسير عمل CRM أو التقويم.
وجّه بذكاء. استخدم Call Control API للتصعيد إلى طابور بشري، أو التحويل إلى القسم المناسب، أو العودة إلى IVR عندما تتطلّب المحادثة ذلك.

والأهم أن هذا تطوير مخصّص من ECOLOR، وليس وكيل ذكاء اصطناعي أصليًا من 3CX. فـ 3CX يوفّر الاتصالات والتوجيه والـ extensions وخطوط SIP وأرقام DID؛ ويوفّر المزوّد الخارجي الذكاء؛ بينما تُهندَس منطق التنسيق والتوجيهات والأدوات وقواعد العمل لكل مشروع على حدة. ولا نصف أبدًا وكيلًا بناه ECOLOR أو يعمل بمفتاحك الخاص بأنه ميزة أصلية في 3CX.

الأمن والتحكم في البيانات واعتبارات الإنتاج

لأن الوكيل يعمل على بنيتك التحتية ويستدعي مزوّد ذكاء اصطناعي خارجيًا، فإن الأمن وحوكمة البيانات قرارات تصميمية لا افتراضات جاهزة. نخطّط لبيانات اعتماد Service Principal مصادَق عليها بصلاحيات أقل ما يلزم على مستوى الـ extensions، ونقلٍ مُشفّر لقنوات الصوت والتحكم، وتعاملٍ دقيق مع صوت المكالمات ونصوصها، وحدودٍ واضحة لما يحتفظ به مزوّد الذكاء الاصطناعي. وتُؤكَّد خيارات موقع الاستضافة وإقامة البيانات أثناء تصميم الحل؛ وتُبنى البنية لدعم جهودك في الحوكمة والامتثال، لكن لا يمكن لأي إعداد بمفرده أن يجعل مؤسسة ممتثلة لأي لائحة محدّدة.

ولأغراض قابلية التوسّع والجاهزية الإنتاجية، نراعي التزامن مقابل ترخيص المكالمات المتزامنة (SC)، والتوسّع التلقائي للمنسّق وسلوك إعادة الاتصال، وميزانيات الكمون عبر جسر الصوت، والتسليم السلس إلى موظف بشري، والمراقبة، وحدود معدّل المزوّد وآليات الاحتياط. ونُبقي خط حالة الإصدار واضحًا: فما دامت Programmable Extensions في مرحلة Alpha، نُسلّم بيئات تقييم وتجريب اليوم، ونجدول الإطلاق الإنتاجي لحين وصول الميزة إلى إصدار مستقر من 3CX. ولا توجد ضمانات لوقت التشغيل أو الكمون أو التوفير — بل تُتحقَّق الأهداف مقابل بيئتك تحديدًا.

كيف يُسلّم ECOLOR وكيلك الصوتي الذكي

بصفتنا MENA 3CX Solution Provider، تقدّم ECOLOR Technologies تسليمًا متكاملًا: تصميم الحل، والتطوير، وتكامل المزوّد، والاختبار الدقيق، والمراقبة، والدعم المستمر — مع فريق تقني مقرّه السعودية يقدّم الدعم بالعربية والإنجليزية. نتولّى إعداد Service Principal، والمنسّق، وجسر المزوّد، ومنطق التوجيه، والمراقبة، ليحصل فريقك على وكيل يعمل بدلًا من مجموعة SDKs.

وإلى جانب قدرات 3CX الأصلية، يقدّم ECOLOR أيضًا منتجه الخاص AI Voice Agent — وكيل صوت محادثة طوّره ECOLOR بتكامل عميق — وAutoConnect، منصة أتمتة الاتصالات المملوكة لـ ECOLOR (AutoDialer، AutoDistributor / Ready Distributor، Evaluation، Smart Routing، لوحات المعلومات وسير عمل API/webhook). وكلاهما يوسّع 3CX ويتكامل معه؛ وليس أيٌّ منهما ميزة أصلية في 3CX. وهذا يتيح لنا مطابقة الأسلوب الأنسب لمتطلباتك — مسار أصلي، أو وكيل Programmable Extension مخصّص، أو AI Voice Agent الخاص بـ ECOLOR، أو أتمتة AutoConnect — بدلًا من فرض نموذج واحد على كل حالة استخدام. اطّلع على صفحة 3CX Programmable Extensions ووكلاء الصوت الذكي، ومركز وكلاء 3CX الذكيين، وAI Voice Agent من ECOLOR، ومنصة AutoConnect، وميزة 3CX AI Customer Service Agent في مرحلة Alpha، وكيف يستقر كل ذلك على نظام هاتف 3CX في السعودية.

الأسئلة الشائعة

هل وكيل الصوت الذكي المخصّص على 3CX جاهز للإنتاج اليوم؟

واجهة Call Control API التي يعتمد عليها مُتاحة عامًا وجاهزة للإنتاج (منذ V18). أما مسار Programmable Extensions الذي يُغلّف تطبيق ذكاء اصطناعي خارجيًا كـ extension في 3CX فهو Alpha ضمن V20 Update 10 (أُعلن عنه في 2026-07-30) — لأغراض الاختبار والتقييم فقط وليس للإنتاج. يستطيع ECOLOR بناء بيئات تقييم وتجريب اليوم وجدولة الإطلاق الإنتاجي لحين وصول Programmable Extensions إلى إصدار مستقر.

ما مزوّدو الذكاء الاصطناعي الذين يدعمهم 3CX رسميًا لوكلاء الصوت؟

يوثّق 3CX رسميًا أربعة مزوّدي صوت في الوقت الحقيقي عبر مستودع agentic-call-control: OpenAI Realtime، وGoogle Gemini Live، وxAI Grok، وAlibaba Qwen Omni. وجميعها بأنماط «مفتاحك الخاص» — أنت توفّر حساب المزوّد وتموّله. ولا نقدّم أي مزوّد آخر على أنه مدعوم رسميًا.

ما ترخيص 3CX الذي أحتاجه؟

تتطلب Call Control API ترخيص Enterprise بسعة 8SC فأكثر وصلاحية Call Flow Designer (CFD). ويتطلب مسار Programmable Extensions / وكيل الصوت الذكي إضافةً إلى ذلك مجموعة ميزات V20 Update 10، ويتطلب كل مزوّد ذكاء اصطناعي خارجي حسابه ومفتاح الـ API الخاص به. ويُؤكَّد الترخيص الدقيق لكل مشروع.

هل يقوم 3CX بنفسه بالتعرّف على الكلام والاستدلال بالذكاء الاصطناعي؟

لا. في مسار الوكيل المخصّص، يوفّر 3CX الاتصالات والتوجيه والـ extensions وخطوط SIP وأرقام DID فقط. أما تحويل الكلام إلى نص، والاستدلال، وتحويل النص إلى كلام فيتولاها دائمًا مزوّد الذكاء الاصطناعي الخارجي الذي تربطه، عبر تدفّق صوت PCM ثنائي الاتجاه في الوقت الحقيقي.

هل AI Voice Agent من ECOLOR هو نفسه وكلاء 3CX الأصليون؟

لا. AI Voice Agent وAutoConnect منتجان طوّرهما ECOLOR ويوسّعان 3CX ويتكاملان معه؛ وليسا ميزتين أصليتين في 3CX. أما وكلاء 3CX الأصليون فهم قدرة منفصلة يوفّرها 3CX. ونُبقي هذا التمييز واضحًا دائمًا.

احجز استشارة

هل أنت مستعد لاستكشاف وكيل صوت ذكي مخصّص على 3CX — تجربة تقييمية الآن، وخطة إنتاجية عند جاهزية المنصة؟ ستتولّى ECOLOR Technologies تصميمه وبناءه وتكامله واختباره ومراقبته ودعمه لك. احجز استشارة أو اتصل برقمنا الموحّد 920033987 للتحدث مع فريقنا في السعودية.