ربط VitalPBX بخدمة IllyVoIP: وصلة PJSIP وتوجيه المكالمات
اضبط وصلة PJSIP في VitalPBX ومسارات المكالمات الواردة والصادرة ورقم المتصل والصوت، ثم تحقّق من كل مرحلة في الاتصال.
يتبع هذا الدليل خطوات PJSIP في VitalPBX 4/4.5 والوثائق الرسمية التي روجعت في 7 أكتوبر 2026. قد تختلف أسماء القوائم بين الإصدارات. نفترض أن السنترال مثبت بالفعل ويستخدم مصادقة IllyVoIP بكلمة مرور. التثبيت والانتقال إلى مصادقة IP ومكالمات الطوارئ تحتاج إلى تخطيط منفصل.
تسجيل الوصلة ينشئ الاتصال بين السنترال وIllyVoIP فقط. تحتاج أيضاً إلى مسار صادر مسموح للامتدادات الداخلية باستخدامه، ومسار وارد لرقم شركتك. افحص المراحل الثلاث كلّاً على حدة، حتى لا يدفعك خلل في التوجيه إلى تغيير كلمة مرور صحيحة.
قبل البدء
تحتاج إلى صلاحيات إدارة السنترال، ونسخة احتياطية محفوظة بشكل خاص، وامتداد داخلي يعمل، وإذن باستخدام حساب IllyVoIP. أبقِ مسار المكتب الحالي متاحاً أثناء إعداد المسار الجديد. راجع الرصيد وتعرفة الوجهة وحدود الخط أو الباقة قبل الاختبار الفعلي؛ فقد تُحتسب تكلفة للمكالمة التجريبية. لا يلزم شراء رقم لمجرد تسجيل الوصلة، لكن استقبال مكالمات من الشبكة العامة يتطلب رقماً نشطاً موجهاً إليها.
1. اجمع بيانات الاتصال من IllyVoIP
افتح SIP Lines في البوابة واختر الخط المقصود. احصل على اسم مستخدم SIP وكلمة مرور SIP واسم الخادم ومنفذ الوجهة وبروتوكول النقل. هذه ليست بيانات البريد الإلكتروني وكلمة مرور الدخول إلى البوابة. إذا كان الخط يستخدم مصادقة IP، فاتبع تعليمات ذلك الاتصال. تفعيل التسجيل أو تغيير نمط المصادقة قد يقطع اتصال الأجهزة التي تستخدم الخط حالياً.
استخدم القيم المقدمة لحسابك. لا تنسخ عنوان خادم أو كلمة مرور أو منفذاً أو ترويسات خاصة بمشغّل آخر من دليل خارجي. احفظ بيانات الدخول في مدير كلمات مرور خاص، ولا تضعها في لقطات الشاشة أو منشورات طلب المساعدة.
2. أنشئ وصلة PJSIP في VitalPBX
في VitalPBX افتح PBX → Calls Routing → Trunks. اختر PJSIP واكتب وصفاً واضحاً في Description مثل IllyVoIP، مع إبقاء الوصلة مفعّلة. اضبط الاتصال البعيد في General والتسجيل في Outbound Registration Settings. يشير PJSIP هنا إلى مشغّل قنوات Asterisk؛ أما اتصال IllyVoIP فما زال يستخدم بروتوكول SIP.
| حقل VitalPBX | القيمة المطلوبة أو ما يجب التحقق منه |
|---|---|
| Description | اسم محلي مثل IllyVoIP، وليس اسم مستخدم المصادقة. |
| Remote Host / Remote Port | خادم SIP ومنفذ الوجهة المقدمان لاتصال IllyVoIP الخاص بك. |
| Remote Username / Remote Secret | اسم مستخدم SIP وكلمة مرور SIP للخط. |
| Require Registration | فعّله لطريقة التسجيل بكلمة مرور الموضحة في هذا الدليل. |
| Transport | طابق بروتوكول نقل SIP المحدد. عند استخدام TLS استخدم اسم الخادم والتحقق الصحيح من الشهادة. |
| Local Username / Local Secret | حقول الهوية أو المصادقة في الطرف المحلي؛ لا تخلطها ببيانات الطرف البعيد. |
| Contacts / Match / From Domain | حقول متقدمة تختلف حسب الاتصال. استخدم المتطلبات المؤكدة، لا عناوين IP متوقعة أو نطاقات مطابقة واسعة أو إعدادات مشغّل آخر. |
اترك الخيارات المتقدمة غير اللازمة كما هي. إذا احتاج الاتصال إلى إعدادات إضافية للهوية أو مصادر الاتصال الوارد، فأكّدها مع دعم IllyVoIP أولاً. راجع القيم ثم نفّذ Save وApply Changes. اسم الوصلة واسم مستخدم المصادقة والرقم المعروض للمستقبِل تؤدي وظائف مختلفة ولا يحل أحدها محل الآخر.
3. تحقّق من التسجيل قبل إعداد المكالمات
راجع Reports → PBX Reports → PJSIP Endpoints → Trunks. استجابة الطرف لاختبار الوصول لا تعني نجاح التسجيل الصادر. يمكن للمسؤول الذي يملك وصولاً مصرحاً إلى CLI مراجعة pjsip show registrations أيضاً. هذا فحص للقراءة فقط، وليس طلباً لتعديل ملفات Asterisk التي تولدها الواجهة. تحقّق من تسجيل الهاتف الداخلي وتسجيل الوصلة بشكل منفصل.
قد يكون طلب المصادقة متبوعاً باستجابة ناجحة أمراً طبيعياً. أما أخطاء المصادقة المتكررة أو رفض التسجيل أو انتهاء المهلة فتحتاج إلى فحص. ابدأ باسم المستخدم وكلمة المرور ونمط المصادقة وDNS والمنفذ والنقل. تجنب المحاولات المتلاحقة وإعادة تعيين كلمة المرور باستمرار. لا توسّع صلاحيات جدار الحماية لمعالجة خطأ في كتابة بيانات الدخول.
4. أنشئ مساراً صادراً بصلاحيات محددة
افتح PBX → Calls Routing → Outbound Routes. أضف وصفاً واضحاً واختر وصلة IllyVoIP. ابدأ بنمط محدود لوجهة تملك التحكم بها، واسمح فقط لامتداد الاختبار باستخدامه عبر Class of Service وصلاحيات التوجيه المناسبة. راجع أولوية المسارات وترتيب الوصلات حتى لا يمر الاختبار عبر مشغّل آخر من دون ملاحظة.
يحدد Pattern الأرقام التي تطابق القاعدة. يحذف Prefix بادئة الخروج من المكتب، بينما يضيف Prepend أرقاماً قبل الإرسال. إذا كان الموظفون يطلبون 9 إضافية للخروج إلى خط خارجي، فاحذفها مرة واحدة؛ فهي ليست جزءاً من رمز البلد. لا تضف رمز البلد مجدداً إذا كان المستخدم قد طلبه بالفعل. افحص الرقم النهائي المرسل إلى IllyVoIP واستخدم التنسيق الدولي المطلوب لاتصالك. تجنب قاعدة عامة غير مقيدة أثناء الإعداد.
5. وجّه رقم IllyVoIP الوارد
في IllyVoIP وجّه الرقم النشط أولاً إلى خط SIP الذي يستخدمه هذا السنترال. ثم افتح PBX → Calls Routing → Inbound Routes في VitalPBX. اختر Default وسمِّ المسار وأدخل الرقم المتوقع الاتصال به في DID Pattern. اختر امتداداً يعمل في Inbound Destination. اترك CID Pattern فارغاً ما لم ترغب عمداً في قصر المسار على متصلين محددين.
DID هو الرقم المطلوب، وCID يعرّف المتصل. طابق DID مع التنسيق المستلَم فعلياً، بما في ذلك علامة الجمع أو أي معرّف آخر. إذا اختلف عن المتوقع، افحص بيانات المكالمة قبل تغيير استخراج الترويسات أو إضافة قاعدة شاملة. ترك الحقلين فارغين ينشئ مسار Any/Any. بعد نجاح رنين امتداد الاختبار، أضف مجموعة الرنين أو الطابور أو IVR أو الجدول الزمني المقصود. لا تسمح للمكالمات العامة غير المطابقة بإجراء اتصالات خارجية بلا قيود.
6. طابق إعدادات رقم المتصل والصوت والشبكة
اختر رقم متصل صادر تسمح به باقة IllyVoIP وخطها. قد يستبدله VitalPBX على مستوى الامتداد أو المسار أو الوصلة؛ تجنب الإعدادات المتعارضة أثناء التجهيز. إدخال رقم في Trunk CID لا يثبت ملكيته ولا يمنح إذن عرضه. كما أن نجاح التسجيل لا يضمن رصيداً كافياً أو صلاحية الاتصال بالوجهة أو سعة متاحة للمكالمات.
طابق نمط الوسائط بين السنترال وخط SIP: Standard RTP غير مشفر، وSDES-SRTP وDTLS-SRTP نمطان مختلفان للتشفير. يحمي TLS إشارات SIP ولا يفعّل تشفير الصوت تلقائياً. اختر ترميزاً صوتياً وطريقة DTMF يدعمهما الطرفان. لا تختَر إعداداً موجهاً للمتصفح لمجرد أن Webphone IllyVoIP يستخدمه.
إذا كان السنترال خلف NAT، فراجع العنوان الخارجي والشبكات المحلية وإعداد RTP الفعلي حسب إصدار VitalPBX المثبت. الصوت باتجاه واحد يحتاج غالباً إلى فحص مسار الوسائط منفصلاً عن التسجيل. أبقِ جدار الحماية مفعّلاً واسمح بالمصادر والمنافذ الضرورية التي تم التحقق منها فقط. عند تغيير عنوان IP العام أو جهاز التوجيه، راجع NAT وقيود IP بدلاً من تغيير بيانات الدخول عشوائياً.
حدّد المرحلة التي يحدث فيها الخلل
| ما تلاحظه | ما تفحصه أولاً |
|---|---|
| الوصلة لا تُسجَّل | بيانات الطرف البعيد ونمط المصادقة وحل اسم الخادم والمنفذ والنقل والاستجابة الدقيقة. |
| التسجيل ناجح لكن المكالمة لا تغادر السنترال | نمط الطلب وصلاحيات الامتداد وأولوية المسارات والوصلة المختارة. |
| IllyVoIP يرفض المكالمة الصادرة | تنسيق الوجهة النهائي ورقم المتصل المسموح والرصيد وصلاحيات الباقة والسعة واستجابة SIP المسجلة. |
| الاتصال بالرقم لا يجعل أي هاتف يرن | ربط الرقم بالخط في IllyVoIP وDID المستلَم والوجهة الواردة والجدول وحالة الامتداد. |
| المكالمة متصلة بلا صوت أو بصوت في اتجاه واحد | إمكانية الوصول عبر RTP وNAT والترميز المتفاوض عليه وتطابق تشفير الوسائط. |
| أزرار الهاتف لا تعمل داخل القائمة الصوتية | طريقة DTMF بين الهاتف والسنترال والوصلة؛ اختبر باستخدام قائمة تتحكم بها. |
فحوص ما قبل إتاحة الوصلة للفريق
أكّد التسجيل، ثم أجرِ مكالمة صادرة مصرحاً بها ومكالمة واردة إلى رقمك. افحص الوصلة المستخدمة فعلياً والصوت في الاتجاهين والرقم المعروض والأزرار وإنهاء المكالمة بصورة سليمة. تأكد من أن امتداداً بلا صلاحية لا يستطيع استخدام المسار الجديد. بعد ذلك فقط وسّع الوصول للمستخدمين والوجهات المطلوبة.
إذا فشل فحص، فغيّر إعداداً واحداً كل مرة واحتفظ بالقيمة السابقة. زوّد الدعم بإصدار السنترال والوقت والمنطقة الزمنية واتجاه المكالمة والخطأ بعد إزالة البيانات الخاصة والمرجع العام للمكالمة من البوابة إن توفر. لا تنشر كلمات مرور SIP أو سجلات الحساب الخام. جرت مطابقة التعليمات مع الوثائق وسلوك البوابة؛ لكنها لا تعني اعتماد VitalPBX باختبارات مكالمات حقيقية. الطوارئ والفاكس والاستخدامات المتخصصة تحتاج إلى تحقق منفصل.