3CX للمطوّرين والذكاء الاصطناعي · ECOLOR Technologies

وكلاء صوت ذكاء اصطناعي مخصّصون فوق 3CX

تفتح Programmable Extensions وواجهة Call Control API في 3CX الباب أمام تطبيقات خارجية تنضمّ إلى المكالمات وتتحكّم في توجيهها وتتبادل الصوت مع المتصل — وهي الطريق الرسمي لبناء وكيل صوت ذكاء اصطناعي على 3CX. تصمّم ECOLOR Technologies هذه الحلول وتطوّرها وتكاملها وتدعمها من فريق تقني سعودي.

تنبيه دقيق: Programmable Extensions ما زالت ألفا (للتجربة والتقييم)، بينما Call Control API متاحة رسمياً منذ سنوات.

احجز استشارة اتصل بنا9200 33987 واتساب

مزوّد حلول 3CX في الشرق الأوسط
Call Control API — متاحة رسمياً
Programmable Extensions — ألفا
OpenAI · Gemini · Grok · Qwen
فريق تطوير سعودي

01 · التعريف

ما المقصود بـ Programmable Extensions ووكلاء الصوت بالذكاء الاصطناعي على 3CX

Programmable Extensions ميزة رسمية من 3CX تتيح لتطبيق خارجي — يعمل على بنيتك التحتية — أن يتّصل بمنصّة 3CX ويتصرّف مثل تحويلة داخلية (Extension) أصلية: ينضمّ إلى المكالمات، ويستقبلها، ويتبادل الصوت مع المتصل في الاتجاهين (PCM)، ويتحكّم في التوجيه عبر واجهة Call Control API. هذا هو المسار الرسمي لبناء وكيل صوت ذكاء اصطناعي فوق 3CX.

المهم أن نفصل بين طبقتين لا تتطابقان في حالة الإصدار: Programmable Extensions أُطلقت ضمن V20 Update 10 بوصفها ألفا — للتجربة والتقييم فقط وليست للإنتاج. أمّا Call Control API فهي الواجهة الناضجة المتاحة رسمياً منذ الإصدار V18، وهي الأساس المستقرّ الذي تُبنى عليه الميزات الأحدث. سنحافظ على هذا الفصل بوضوح في كل الصفحة.

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

02 · حالة الإصدار

حالة الإصدار بوضوح — Programmable Extensions (ألفا) مقابل Call Control API (متاحة رسمياً)

اعتباراً من أغسطس 2026، أطلقت 3CX ميزة Programmable Extensions ضمن الإصدار V20 Update 10 بوصفه ألفا — أي «للتجربة والتقييم فقط، ولا يُنصح بتركيبه على أنظمة الإنتاج». أحدث إصدار مستقرّ هو V20 Update 9 (النهائي). لذلك نتعامل مع Programmable Extensions اليوم كمسار تقييم وبيئة تجريبية (Pilot)، لا كحلّ إنتاجي جاهز.

في المقابل، واجهة Call Control API متاحة رسمياً (GA) منذ الإصدار V18، مع حزمة تطوير رسمية بلغة TypeScript باسم @3cx/call-control-sdk، وتتطلّب ترخيص Enterprise بسعة 8SC فأعلى مع صلاحية الوصول إلى مصمّم تدفّق المكالمات (CFD). هذه الواجهة يمكن الاعتماد عليها في الإنتاج ضمن حدودها ومتطلّباتها.

خلاصتنا العملية: نستطيع اليوم أن نصمّم ونبني بيئة تقييم لوكيل صوت ذكاء اصطناعي على 3CX، ونجرّبها ونقيسها ونجهّز معماريتها؛ ثم ننقلها إلى الإنتاج حين تصل Programmable Extensions إلى إصدار مستقرّ. لن نقدّم أي ضمانات إنتاجية أو أداء أو توافر لميزة ما زالت في مرحلة ألفا.

Programmable Extensions — ألفا (V20 Update 10): للتجربة والتقييم فقط، ليست للإنتاج.
Call Control API — متاحة رسمياً منذ V18: أساس ناضج، تتطلّب Enterprise 8SC+ وصلاحية CFD.
الإصدار المستقرّ الحالي — V20 Update 9 (النهائي).
الذكاء الاصطناعي (STT · الاستدلال · TTS) — من مزوّد خارجي بمفتاحك، وليس من 3CX.

03 · القدرات

ماذا تتيح هذه الطبقة التطويرية

قدرات موزّعة بدقّة بين ما هو رسمي في 3CX وما تبنيه ECOLOR:

تطبيق يعمل كتحويلة أصلية

عبر Programmable Extensions (ألفا) ينضمّ تطبيق خارجي على بنيتك إلى 3CX ويتصرّف مثل تحويلة داخلية، فيراقب المكالمات ويستقبلها ويتحكّم في مسارها.

صوت ثنائي الاتجاه في الزمن الحقيقي

تدفّق صوت PCM بترميز 8kHz أحادي 16-بت في الاتجاهين بين المتصل والوكيل، وهو ما يجعل محادثة صوتية طبيعية مع الذكاء الاصطناعي ممكنة.

تحكّم كامل في المكالمة

عبر Call Control API (متاحة رسمياً): رد وتوجيه وتحويل وإنهاء ومراقبة، وقراءة بيانات المشاركين وحالة المكالمة عبر WebSocket مع إعادة اتصال تلقائية.

حزمة تطوير رسمية

SDK رسمي بلغة TypeScript ‏@3cx/call-control-sdk يوفّر ربط المكالمات وقراءة/كتابة تدفّق الصوت والتحويل — أساس مستقرّ نبني عليه منطق الوكيل.

مزوّد ذكاء اصطناعي خارجي

يأتي فهم الكلام والاستدلال والتوليد الصوتي من مزوّد خارجي (OpenAI · Gemini · Grok · Qwen) عبر بثّ صوتي واحد في الزمن الحقيقي، بمفتاح واجهتك الخاص.

أدوات وربط بالأنظمة

استدعاء أدوات أثناء المكالمة: تحويل أو إسقاط أو فرز، بحث في دفتر الهاتف عبر خادم 3CX MCP، وربط أنظمة CRM والتقويم عبر خوادم MCP إضافية.

04 · المكوّنات

المصطلحات والمكوّنات التي ستقابلها

لبنات المعمار التقني لوكيل صوت ذكاء اصطناعي على 3CX:

Programmable Extensions (ألفا) — تطبيق خارجي كتحويلة
Call Control API (متاحة رسمياً) — التحكّم في المكالمة
‏@3cx/call-control-sdk — حزمة التطوير الرسمية (TypeScript)
تدفّق صوت PCM 8kHz أحادي 16-بت في الاتجاهين
اتصال WebSocket مع إعادة اتصال تلقائية
Service Principal — معرّف التطبيق والمفتاح السرّي (appId · appSecret)
ترخيص Enterprise بسعة 8SC فأعلى + صلاحية CFD
خادم 3CX MCP — بحث دفتر الهاتف وإدارة جهات الاتصال
خوادم MCP إضافية — ربط CRM والتقويم
مزوّد ذكاء اصطناعي خارجي بمفتاحك (BYO key)
المستودع المرجعي الرسمي agentic-call-control
بديل: AI Call Scripts على خادم 3CX (ألفا كذلك)

05 · سيناريوهات

أين يعمل وكيل صوت الذكاء الاصطناعي المخصّص

◆
وكيل استقبال صوتي يرحّب بالمتصل بالعربية، يفهم نيّته، يجيب عن الأسئلة المتكرّرة، ثم يحوّله إلى القسم المناسب — كبيئة تقييم اليوم، وإنتاج عند نضج الميزة.
◆
خطّ حجوزات أو مواعيد يتحدّث صوتياً مع المتصل، يتحقّق من التوفّر عبر ربط بالتقويم، ويؤكّد الموعد أو يحوّل الحالات المعقّدة لموظف بشري.
◆
فرز مكالمات صادر/وارد يجمع بيانات أولية (رقم الطلب، نوع الاستفسار) قبل تحويل المتصل، فيصل إلى الموظف مصحوباً بسياق جاهز.
◆
وكيل تأهيل عملاء محتملين يتحدّث مع المتصل، يسجّل الطلب في CRM عبر خادم MCP، ثم يوجّه المؤهّلين إلى فريق المبيعات.
◆
خطّ خدمة خارج الدوام يتعامل صوتياً مع الاستفسارات البسيطة ويترك رسائل منظّمة أو ينشئ تذاكر للحالات التي تحتاج متابعة بشرية.
◆
وكيل متعدّد اللغات يخدم المتصلين بالعربية والإنجليزية عبر مزوّد ذكاء اصطناعي يدعم الزمن الحقيقي، مع تحويل سلس بين الوكيل والموظف.
◆
تجربة إثبات مفهوم (PoC) لقياس جودة الصوت وزمن الاستجابة ودقّة الفهم قبل أي قرار توسّع أو انتقال إلى الإنتاج.

06 · المعمار

كيف يتّصل تطبيق الذكاء الاصطناعي الخارجي بـ 3CX

المسار الرسمي الموصى به للوكلاء المخصّصين هو Programmable Extension خارجي: تصل المكالمة إلى منصّة 3CX، ثم تُفتح قناة تحكّم عبر WebSocket إلى منسّق (Orchestrator) يعمل على بنيتك التحتية أنت. يستخدم المنسّق حزمة ‏@3cx/call-control-sdk للانضمام إلى المكالمة وقراءة وكتابة تدفّق الصوت PCM في الاتجاهين. للإعداد، يُنشأ Service Principal من لوحة الإدارة (Admin ← Integrations ← API) يمنحك appId وappSecret وعنوان pbxBase.

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

أثناء المكالمة يستطيع الوكيل استدعاء أدوات محلّية (تحويل · إسقاط · فرز)، والبحث في دفتر الهاتف عبر خادم 3CX MCP، وربط أنظمة إضافية (CRM · تقويم) عبر خوادم MCP أخرى. يوجد أيضاً مسار بديل هو AI Call Scripts الذي يعمل على خادم 3CX نفسه ويتّصل بخدمات الصوت المدعومة من OpenAI وGemini وxAI — وهو كذلك في مرحلة ألفا ضمن Update 10 ويتطلّب AI Edition. ما هو أصلي في 3CX هنا: الاتصالات والتوجيه والتحويلات وخطوط SIP والأرقام وواجهة Call Control API. أمّا منطق الوكيل والذكاء الاصطناعي فمن تطوير خارجي ومن المزوّد.

المتصل ← منصّة 3CX ← قناة تحكّم WebSocket ← منسّق على بنيتك.
المنسّق ← جسر المزوّد (OpenAI · Gemini · Grok · Qwen) بمفتاحك الخاص.
أدوات المكالمة: تحويل · إسقاط · فرز + خادم 3CX MCP (دفتر الهاتف) + خوادم MCP إضافية (CRM · تقويم).
أصلي في 3CX: الاتصالات والتوجيه وSIP والأرقام وCall Control API — لا الذكاء الاصطناعي نفسه.

07 · الأمن والتوسّع والإنتاج

الأمن وقابلية التوسّع واعتبارات الإنتاج — بصدق ودون ضمانات

لأن التطبيق يعمل خارج 3CX على بنيتك، تقع مسؤولية أمنه عليك وعلى شريك التنفيذ: حماية appSecret ومفاتيح المزوّد، وعزل بيئة المنسّق، وتأمين قناة التحكّم، وضبط الصلاحيات على مستوى Service Principal والتحويلات المسموح بها. عند استخدام خادم 3CX MCP لبحث دفتر الهاتف، تُحترم صلاحيات دور مستخدم 3CX المصرّح به وتُطبَّق ضوابط الوصول المبنية على الدور. نصمّم هذه الطبقات ضمن ممارسات تشغيل سليمة — دون ادّعاء أمن أو خصوصية مطلقين.

أمّا الخصوصية وإقامة البيانات فمسألة جوهرية: يمرّ صوت المكالمة عبر مزوّد ذكاء اصطناعي خارجي (بحساب ومفتاح وفوترة وحالة إصدار خاصة به)، وبعض المزوّدين مقيّدون بمناطق جغرافية محدّدة لنقاط الوصول. تُحدَّد هذه الخيارات ومواقعها وتدفّقات البيانات خلال تصميم الحل بحسب سياساتك — ولا نقدّم أي ضمان امتثال؛ نوفّر أدوات وممارسات تدعم جهود الحوكمة لديك.

على صعيد الإنتاج والتوسّع: Programmable Extensions ما زالت ألفا، لذا لا نوصي بها لأحمال إنتاجية حرجة اليوم، ونتعامل معها كبيئة تقييم وإثبات مفهوم مع مراقبة مستمرّة لجودة الصوت وزمن الاستجابة والاستقرار. تعتمد قابلية التوسّع على سعة الترخيص (SC) وموارد المنسّق وحدود مزوّد الذكاء الاصطناعي — وتُقاس وتُؤكَّد خلال التقييم التقني، لا تُفترض مسبقاً. حين تصل الميزة إلى إصدار مستقرّ، ننقل الحل إلى الإنتاج بمعمار مُختبَر.

08 · لماذا ECOLOR

لماذا تبني ECOLOR وتدعم هذه الحلول

بناء وكيل صوت ذكاء اصطناعي على 3CX عمل هندسي — لا إعداد بضغطة زر:

معمار وتطوير حقيقينصمّم المنسّق ونبنيه بحزمة ‏@3cx/call-control-sdk الرسمية، ونربط مزوّد الذكاء الاصطناعي وأدوات المكالمة وخوادم MCP — بخبرة هندسية في 3CX، لا مجرّد إعداد.
تكامل واختبار ومراقبةنكامل الأنظمة (CRM · تقويم)، ونختبر جودة الصوت وزمن الاستجابة والفهم، ونراقب الاستقرار — منهجية إثبات مفهوم قبل أي قرار توسّع.
انضباط في حالة الإصدارنميّز بوضوح بين Programmable Extensions (ألفا) وCall Control API (المتاحة رسمياً)، فلا نعِدك بإنتاج على ميزة ألفا، ونضع خريطة انتقال واقعية.
ربطها بحلول ECOLOR الجاهزةنربط هذه القدرات بوكيل الصوت بالذكاء الاصطناعي من ECOLOR ومنصّة AutoConnect — وكلاهما من تطوير ECOLOR فوق 3CX وليسا ميزة أصلية في 3CX — ونستمرّ في الدعم.

تفكّر في وكيل صوت ذكاء اصطناعي على 3CX؟ لنصمّم بيئة تقييم اليوم ونرسم طريق الإنتاج معاً.

احجز استشارة

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

أسئلة شائعة حول Programmable Extensions ووكلاء الصوت

ما المقصود بـ Programmable Extensions في 3CX وما حالتها؟

هي ميزة رسمية من 3CX تتيح لتطبيق خارجي على بنيتك أن يتصرّف مثل تحويلة داخلية أصلية: ينضمّ للمكالمات ويتبادل الصوت في الاتجاهين ويتحكّم في التوجيه. حالتها ألفا ضمن V20 Update 10 — للتجربة والتقييم فقط وليست للإنتاج.

وما واجهة Call Control API، وهل هي مثلها في مرحلة ألفا؟

لا. Call Control API هي الواجهة التطويرية الناضجة للتحكّم في المكالمات (رد · توجيه · تحويل · إنهاء · مراقبة)، متاحة رسمياً (GA) منذ الإصدار V18 مع حزمة ‏@3cx/call-control-sdk الرسمية. Programmable Extensions (ألفا) تُبنى فوق هذه الواجهة المستقرّة — والفرق بينهما جوهري.

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

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

هل وكيل الصوت المخصّص وكيل أصلي من 3CX؟

لا. الوكيل المخصّص تطوير خارجي فوق 3CX: تقدّم 3CX الاتصالات والتوجيه وواجهة التحكّم، بينما يأتي فهم الكلام والاستدلال والتوليد الصوتي من مزوّد خارجي بمفتاحك. أي وكيل تبنيه ECOLOR بهذه الطريقة ليس ميزة أصلية في 3CX، ولا نمثّله كذلك.

ما الترخيص والمتطلّبات اللازمة؟

تتطلّب واجهة Call Control API ترخيص Enterprise بسعة 8SC فأعلى مع صلاحية الوصول إلى CFD، ويُنشأ Service Principal للحصول على appId وappSecret. مسار وكيل الصوت يحتاج إضافة إلى ذلك حزمة ميزات Update 10 ومفتاح مزوّد ذكاء اصطناعي خارجي. تُؤكَّد التفاصيل خلال التقييم التقني.

هل هذا جاهز للإنتاج اليوم؟

Programmable Extensions ما زالت ألفا، لذا لا نوصي بها لأحمال إنتاجية حرجة الآن. يمكننا بناء بيئة تقييم وإثبات مفهوم اليوم، وقياس الأداء، وتجهيز المعمار، ثم الانتقال إلى الإنتاج حين تصل الميزة إلى إصدار مستقرّ — دون أي ضمانات إنتاجية على مرحلة ألفا.

كيف تساعد ECOLOR تحديداً؟

نصمّم المعمار ونطوّر المنسّق بالحزمة الرسمية، ونربط مزوّد الذكاء الاصطناعي وأدوات المكالمة وخوادم MCP والأنظمة، ونختبر ونراقب جودة الصوت وزمن الاستجابة، ونقدّم الدعم. كما نربطها عند الحاجة بوكيل الصوت من ECOLOR ومنصّة AutoConnect.

ما الفرق بين هذا المسار وبين AI Call Scripts؟

AI Call Scripts مسار بديل يعمل على خادم 3CX نفسه ويتّصل بخدمات الصوت المدعومة (OpenAI · Gemini · xAI)، وهو أيضاً ألفا ضمن Update 10 ويتطلّب AI Edition. أمّا Programmable Extension الخارجي فيعمل على بنيتك ويمنحك تحكّماً أعمق في منطق الوكيل — نساعدك على اختيار الأنسب لحالتك.

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

من إعداد Service Principal وحزمة ‏@3cx/call-control-sdk الرسمية، إلى ربط مزوّد ذكاء اصطناعي خارجي وأدوات المكالمة وخوادم MCP، تصمّم ECOLOR Technologies وتطوّر وتكامل وتختبر وتراقب وتدعم وكلاء الصوت المخصّصين فوق 3CX — مع فصل واضح بين Programmable Extensions (ألفا) وCall Control API (المتاحة رسمياً)، ودون أي ضمانات إنتاجية على ما هو في مرحلة ألفا.