Grandstream UCM

تستطيع أنظمة Grandstream UCM6300 وUCM6300A وUCM6200 وUCM6510 إرسال كل سجل تفاصيل مكالمة (CDR) لحظة انتهاء المكالمة — عبر ميزة CDR Real-Time Output بواسطة HTTPS أو TCP وبصيغة JSON أو XML — وتحتفظ بالسجلات التي تعذّر تسليمها حتى يعود المستقبِل. ويمكن لتيلايزر أيضاً أن يطلب السجلات الجديدة من واجهة CDR البرمجية في UCM، فيجلب معها المكالمات السابقة.

القيم في المربعات المتقطعة خاصة بمؤسستك: تعرضها لوحة طريقة الربط في البوابة معبّأة مع أزرار النسخ.

إخراج CDR الفوري عبر HTTPS — يرسل UCM كل سجل

موصى بها في تيلايزر السحابي.

تيلايزر السحابي

1. سجّل الدخول إلى واجهة UCM وافتح Integrations → API Configuration → CDR Real-Time Output Settings (في البرامج الثابتة الأقدم: Value-added Features → API Configuration → CDR Real-Time Output Settings). وفعّل Enable.
2. Server Address: عنوان الإرسال الخاص بالموصّل — أدخل العنوان كاملاً. وإن ظهر في برنامجك الثابت حقل Port منفصل فأدخل فيه 443.
3. Delivery Method: HTTP/HTTPS. Format: JSON (ويُقرأ XML أيضاً).
4. Username وPassword: اتركهما فارغين — فالجزء السري من العنوان يعرّف الموصّل. احفظ ثم اختر Apply Changes.

خادم تيلايزر

1. سجّل الدخول إلى واجهة UCM وافتح Integrations → API Configuration → CDR Real-Time Output Settings (في البرامج الثابتة الأقدم: Value-added Features → API Configuration → CDR Real-Time Output Settings). وفعّل Enable.
2. Server Address: عنوان الإرسال الخاص بالموصّل — أدخل العنوان كاملاً. وإن ظهر في برنامجك الثابت حقل Port منفصل فأدخل فيه 443.
3. في خادم تيلايزر يكون هذا العنوان عنوان بوابة الخادم نفسه في شبكتك المحلية، ويجب أن يتمكن UCM من الوصول إليه.
4. Delivery Method: HTTP/HTTPS. Format: JSON (ويُقرأ XML أيضاً).
5. Username وPassword: اتركهما فارغين — فالجزء السري من العنوان يعرّف الموصّل. احفظ ثم اختر Apply Changes.

واجهة CDR البرمجية — يطلب تيلايزر السجلات الجديدة من UCM (مع السجل السابق)

موصى بها في خادم تيلايزر.

تيلايزر السحابي

1. UCM6300 / UCM6300A: افتح Integrations → API Configuration → HTTPS API Settings (New) وفعّل Enable، وأضف مستخدماً باسم telyzer بكلمة مرور قوية.
2. وفي الصفحة نفسها أضف العنوان الذي يتصل منه تيلايزر إلى القائمة البيضاء لتسجيل الدخول، حتى لا تحظر محاولات الدخول الفاشلة عنوان تيلايزر.
3. UCM6200 وUCM6510 (الواجهة القديمة): افتح Integrations → API Configuration → HTTPS API Settings (Old) (في البرامج الثابتة الأقدم: Value-added Features → API Configuration) وفعّل Enable، واضبط TLS Bind Address على 0.0.0.0:8443، وUser Name على telyzer مع كلمة مرور، وPermitted IP(s) على العنوان الذي يتصل منه تيلايزر/255.255.255.255، وفعّل CDR API. احفظ ثم Apply Changes.
4. في تيلايزر أدخل عنوان UCM والمنفذ (8089 للواجهة الجديدة و8443 للقديمة) والمستخدم وكلمة المرور وفئة UCM، ثم اختر فحص الاتصال.
5. عند أول اتصال يجمع تيلايزر مكالمات آخر 30 يومًا، ثم يطلب السجلات الجديدة من UCM كل دقيقة.
6. يصل تيلايزر السحابي إلى UCM عبر الإنترنت، لذا يجب أن يكون متاحاً على ذلك المنفذ. وإن لم يكن كذلك فاستخدم الإرسال عبر HTTPS بدلاً منه، أو مرحّل تيلايزر على شبكتك: telyzer-relay add-collector --kind grandstream_api --host <UCM address> --user telyzer --password <password> (أضف --flavor legacy لـ UCM6200/6510) ثم Restart-Service TelyzerRelay.

خادم تيلايزر

1. UCM6300 / UCM6300A: افتح Integrations → API Configuration → HTTPS API Settings (New) وفعّل Enable، وأضف مستخدماً باسم telyzer بكلمة مرور قوية.
2. وفي الصفحة نفسها أضف العنوان الذي يتصل منه تيلايزر إلى القائمة البيضاء لتسجيل الدخول، حتى لا تحظر محاولات الدخول الفاشلة عنوان تيلايزر.
3. UCM6200 وUCM6510 (الواجهة القديمة): افتح Integrations → API Configuration → HTTPS API Settings (Old) (في البرامج الثابتة الأقدم: Value-added Features → API Configuration) وفعّل Enable، واضبط TLS Bind Address على 0.0.0.0:8443، وUser Name على telyzer مع كلمة مرور، وPermitted IP(s) على العنوان الذي يتصل منه تيلايزر/255.255.255.255، وفعّل CDR API. احفظ ثم Apply Changes.
4. في تيلايزر أدخل عنوان UCM والمنفذ (8089 للواجهة الجديدة و8443 للقديمة) والمستخدم وكلمة المرور وفئة UCM، ثم اختر فحص الاتصال.
5. عند أول اتصال يجمع تيلايزر مكالمات آخر 30 يومًا، ثم يطلب السجلات الجديدة من UCM كل دقيقة.

إخراج CDR الفوري عبر TCP — يتصل UCM بتيلايزر

تيلايزر السحابي

1. سجّل الدخول إلى واجهة UCM وافتح Integrations → API Configuration → CDR Real-Time Output Settings (في البرامج الثابتة الأقدم: Value-added Features → API Configuration → CDR Real-Time Output Settings). وفعّل Enable.
2. أدخل في Server Address القيمة عنوان تيلايزر لديك، وفي Port القيمة منفذ الموصّل لديك.
3. Delivery Method: TCP. Format: JSON (ويُقرأ XML أيضاً).
4. Username وPassword: اتركهما فارغين. احفظ ثم اختر Apply Changes.
5. في تيلايزر أضف عنوان IP العام لمكتبك — وهو العنوان الذي تخرج منه حركته من شبكتك — إلى العناوين المسموح بها في الموصّل. وتُرفض السجلات القادمة من أي عنوان آخر.

خادم تيلايزر

1. سجّل الدخول إلى واجهة UCM وافتح Integrations → API Configuration → CDR Real-Time Output Settings (في البرامج الثابتة الأقدم: Value-added Features → API Configuration → CDR Real-Time Output Settings). وفعّل Enable.
2. أدخل في Server Address القيمة عنوان تيلايزر لديك، وفي Port القيمة منفذ الموصّل لديك.
3. Delivery Method: TCP. Format: JSON (ويُقرأ XML أيضاً).
4. Username وPassword: اتركهما فارغين. احفظ ثم اختر Apply Changes.
5. في تيلايزر أدخل عنوان نظام الهاتف في الشبكة المحلية ضمن العناوين المسموح بها في الموصّل (عنوان UCM في الشبكة المحلية، ويظهر في System Status → Network Status). وإن تركته فارغاً يُقبل أي نظام هاتف في شبكتك المحلية.

عبر مرحّل تيلايزر على شبكتك

1. في تيلايزر افتح هذا الموصّل واختر إنشاء رمز تسجيل. تحصل على رمز ورابط تنزيل ترسلهما إلى الشخص المسؤول في الموقع، ويعمل كل منهما مرة واحدة وتنتهي صلاحيته خلال 24 ساعة.
2. على جهاز Windows يعمل دائماً وفي الشبكة نفسها التي فيها نظام الهاتف، افتح الرابط وشغّل TelyzerRelaySetup.exe (يكون الرمز معبّأً). اختر Another phone system ثم Install. يعمل المرحّل كخدمة باسم TelyzerRelay، ولا يخرج من هذا الجهاز إلا اتصال HTTPS صادر.
3. اضبط المرحّل لقراءة المستندات (PowerShell بصلاحية المسؤول على جهاز المرحّل): telyzer-relay set-input --documents ثم Restart-Service TelyzerRelay.
4. سجّل الدخول إلى واجهة UCM وافتح Integrations → API Configuration → CDR Real-Time Output Settings (في البرامج الثابتة الأقدم: Value-added Features → API Configuration → CDR Real-Time Output Settings). وفعّل Enable.
5. Server Address: عنوان جهاز المرحّل في الشبكة المحلية — Port: 33333. Delivery Method: TCP. Format: JSON.
6. Username وPassword: اتركهما فارغين. احفظ ثم اختر Apply Changes.

تحقق من عمل الربط

تيلايزر السحابي

1. أجرِ مكالمة خارجية تجريبية ثم أنهِها. يرسل نظام الهاتف السجل عند انتهاء المكالمة، فيصل بعد ثوانٍ.
2. في تيلايزر يتحول مؤشر بانتظار أول سجل مكالمة إلى الأخضر عند قراءة أول سجل. وإن ظهرت مشكلة بدلاً من ذلك — لا اتصال بعد، أو اتصالات مرفوضة، أو سجلات تعذّرت قراءتها — فإنه يذكر السبب ويعرض السطر المستلم.
3. في UCM تعرض صفحة CDR → CDR المكالمة نفسها. ومع الواجهة البرمجية يحدد فحص الاتصال في تيلايزر بدقة المشكلة: مستخدم أو كلمة مرور خاطئة، أو عنوان مرفوض، أو مشكلة في الشهادة.
4. تظهر الاتصالات التي رفضتها قائمة السماح على شكل اتصالات مرفوضة من …. إن كان هذا عنوان نظام الهاتف لديك (فقد يحوّله جدار الحماية إلى عنوان عام آخر)، اختر إضافة إلى قائمة السماح فيُقبل خلال 30 ثانية.

خادم تيلايزر

1. أجرِ مكالمة خارجية تجريبية ثم أنهِها. يرسل نظام الهاتف السجل عند انتهاء المكالمة، فيصل بعد ثوانٍ.
2. في تيلايزر يتحول مؤشر بانتظار أول سجل مكالمة إلى الأخضر عند قراءة أول سجل. وإن ظهرت مشكلة بدلاً من ذلك — لا اتصال بعد، أو اتصالات مرفوضة، أو سجلات تعذّرت قراءتها — فإنه يذكر السبب ويعرض السطر المستلم.
3. في UCM تعرض صفحة CDR → CDR المكالمة نفسها. ومع الواجهة البرمجية يحدد فحص الاتصال في تيلايزر بدقة المشكلة: مستخدم أو كلمة مرور خاطئة، أو عنوان مرفوض، أو مشكلة في الشهادة.

ملاحظات

• تتطلب ميزة CDR Real-Time Output برنامجاً ثابتاً بالإصدار 1.0.17.16 أو أحدث على UCM6200/6510، و1.0.5.4 أو أحدث على UCM6300A. وعندما يتعذر الوصول إلى تيلايزر يحتفظ UCM بما يصل إلى 10,000 سجل ويرسلها عند عودة الاتصال.
• لدى UCM مخرج CDR Real-Time Output واحد. فإن كان برنامج آخر يستقبله فاختر واجهة CDR البرمجية بدلاً منه، فهي لا تستحوذ عليه.
• إخراج TCP غير مشفّر: عبر الإنترنت فضّل HTTPS، أو قيّد الموصّل بعنوان مكتبك العام.
• تستخدم الواجهة البرمجية عبر HTTPS شهادة واجهة الويب في UCM، ولا تعمل إلا إذا كانت واجهة الويب تعمل عبر HTTPS.

كل أنظمة الهاتف