Yeastar P-Series وS-Series وCloud PBX

تُبلغ مقاسم Yeastar عن كل مكالمة منتهية بحدث في الواجهة البرمجية يحمل سجل تفاصيلها (CDR). ويستطيع P-Series (الجهاز والإصدار البرمجي وCloud Edition) إرساله إلى عنوان Webhook، أو يُبقي تيلايزر اتصال WebSocket مفتوحاً مع المقسم، أو يطلب السجلات من واجهة CDR البرمجية. أما S-Series وCloud PBX الأقدم فيرسلان الحدث إلى تيلايزر بعد أن يسجّل تيلايزر الدخول إلى واجهتهما البرمجية.

أنظمة الهاتف التي يشملها هذا الدليل

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

Webhook — يرسل المقسم كل مكالمة منتهية إلى تيلايزر (HTTPS)

موصى بها في تيلايزر السحابي. تنطبق على: P-Series PBX System، P-Series Cloud Edition.

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

1. سجّل الدخول إلى بوابة الويب في المقسم وافتح Integrations → API، وفعّل الواجهة البرمجية إن كانت معطّلة. ثم فعّل Webhook Event Push واختر Add.
2. أدخل في Webhook URL القيمة عنوان الإرسال الخاص بالموصّل، واختر في Request Method القيمة POST.
3. Event: فعّل Call End Details Notification (الحدث 30012) فقط.
4. انسخ Secret الذي أنشأه المقسم والصقه في حقل سر Webhook في تيلايزر، ليُتحقق من توقيع كل إرسال.
5. اضبط Timeout(s) على 10 وRetry Count على أعلى قيمة متاحة، ثم Save. ويرسل زر الاختبار في Operations رسالة تجريبية يقبلها تيلايزر.

خادم تيلايزر

1. سجّل الدخول إلى بوابة الويب في المقسم وافتح Integrations → API، وفعّل الواجهة البرمجية إن كانت معطّلة. ثم فعّل Webhook Event Push واختر Add.
2. أدخل في Webhook URL القيمة عنوان الإرسال الخاص بالموصّل، واختر في Request Method القيمة POST.
3. Event: فعّل Call End Details Notification (الحدث 30012) فقط.
4. انسخ Secret الذي أنشأه المقسم والصقه في حقل سر Webhook في تيلايزر، ليُتحقق من توقيع كل إرسال.
5. اضبط Timeout(s) على 10 وRetry Count على أعلى قيمة متاحة، ثم Save. ويرسل زر الاختبار في Operations رسالة تجريبية يقبلها تيلايزر.
6. في خادم تيلايزر يكون هذا العنوان عنوان بوابة الخادم نفسه في شبكتك المحلية، ويجب أن يتمكن المقسم من الوصول إليه.

أحداث WebSocket — يبقى تيلايزر متصلاً بالمقسم (مع السجل السابق)

موصى بها في خادم تيلايزر. تنطبق على: P-Series PBX System، P-Series Cloud Edition.

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

1. سجّل الدخول إلى بوابة الويب في المقسم وافتح Integrations → API. فعّل الواجهة البرمجية ودوّن Client ID وClient Secret الظاهرين.
2. في IP Restriction اسمح بالعنوان العنوان الذي يتصل منه تيلايزر فقط، حتى لا يستخدم أحد غيره بيانات الدخول هذه.
3. في تيلايزر أدخل عنوان المقسم (في Cloud Edition: نطاقه)، والمنفذ (8088؛ وفي Cloud Edition ‏443)، وClient ID اسمَ مستخدم وClient Secret كلمةَ مرور، والفئة، ثم اختر فحص الاتصال.
4. يشترك تيلايزر في أحداث انتهاء المكالمات ويُبقي الاتصال قائماً. وبعد أي انقطاع يستدرك ما فاته عبر واجهة CDR البرمجية، وعند أول اتصال يجمع مكالمات آخر 30 يومًا.
5. لكي يصل تيلايزر السحابي إلى مقسم P-Series محلي يجب أن يكون متاحاً من الإنترنت على منفذ الواجهة البرمجية. وإن لم يكن كذلك فاستخدم Webhook بدلاً منه، أو مرحّل تيلايزر على شبكتك: telyzer-relay add-collector --kind yeastar_p_ws --host <PBX address> --user <Client ID> --password <Client Secret> ثم Restart-Service TelyzerRelay.

خادم تيلايزر

1. سجّل الدخول إلى بوابة الويب في المقسم وافتح Integrations → API. فعّل الواجهة البرمجية ودوّن Client ID وClient Secret الظاهرين.
2. في IP Restriction اسمح بالعنوان العنوان الذي يتصل منه تيلايزر فقط، حتى لا يستخدم أحد غيره بيانات الدخول هذه.
3. في تيلايزر أدخل عنوان المقسم (في Cloud Edition: نطاقه)، والمنفذ (8088؛ وفي Cloud Edition ‏443)، وClient ID اسمَ مستخدم وClient Secret كلمةَ مرور، والفئة، ثم اختر فحص الاتصال.
4. يشترك تيلايزر في أحداث انتهاء المكالمات ويُبقي الاتصال قائماً. وبعد أي انقطاع يستدرك ما فاته عبر واجهة CDR البرمجية، وعند أول اتصال يجمع مكالمات آخر 30 يومًا.

واجهة CDR البرمجية — يطلب تيلايزر السجلات الجديدة كل دقيقة

تنطبق على: P-Series PBX System، P-Series Cloud Edition.

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

1. سجّل الدخول إلى بوابة الويب في المقسم وافتح Integrations → API. فعّل الواجهة البرمجية ودوّن Client ID وClient Secret الظاهرين.
2. في IP Restriction اسمح بالعنوان العنوان الذي يتصل منه تيلايزر فقط، حتى لا يستخدم أحد غيره بيانات الدخول هذه.
3. في تيلايزر أدخل عنوان المقسم (في Cloud Edition: نطاقه)، والمنفذ (8088؛ وفي Cloud Edition ‏443)، وClient ID اسمَ مستخدم وClient Secret كلمةَ مرور، والفئة، ثم اختر فحص الاتصال.
4. يطلب تيلايزر السجلات الجديدة من واجهة CDR البرمجية في المقسم كل دقيقة، وعند أول اتصال يجمع مكالمات آخر 30 يومًا.
5. لكي يصل تيلايزر السحابي إلى مقسم P-Series محلي يجب أن يكون متاحاً من الإنترنت على منفذ الواجهة البرمجية. وإن لم يكن كذلك فاستخدم Webhook بدلاً منه، أو مرحّل تيلايزر على شبكتك: telyzer-relay add-collector --kind yeastar_p_api --host <PBX address> --user <Client ID> --password <Client Secret> ثم Restart-Service TelyzerRelay.

خادم تيلايزر

1. سجّل الدخول إلى بوابة الويب في المقسم وافتح Integrations → API. فعّل الواجهة البرمجية ودوّن Client ID وClient Secret الظاهرين.
2. في IP Restriction اسمح بالعنوان العنوان الذي يتصل منه تيلايزر فقط، حتى لا يستخدم أحد غيره بيانات الدخول هذه.
3. في تيلايزر أدخل عنوان المقسم (في Cloud Edition: نطاقه)، والمنفذ (8088؛ وفي Cloud Edition ‏443)، وClient ID اسمَ مستخدم وClient Secret كلمةَ مرور، والفئة، ثم اختر فحص الاتصال.
4. يطلب تيلايزر السجلات الجديدة من واجهة CDR البرمجية في المقسم كل دقيقة، وعند أول اتصال يجمع مكالمات آخر 30 يومًا.

أحداث الواجهة البرمجية — يسجّل تيلايزر الدخول ويرسل المقسم كل سجل

موصى بها في تيلايزر السحابي وخادم تيلايزر. تنطبق على: S-Series VoIP PBX. واجهة S-Series البرمجية غير متاحة على S20 وS412 وS412 Lite.

1. تحقق من الطراز والبرنامج الثابت: تتطلب الواجهة البرمجية الإصدار 30.13.0.30 أو أحدث، ولا تتوفر على S20 وS412 وS412 Lite.
2. سجّل الدخول إلى واجهة الويب في المقسم وافتح Settings → PBX → General → API. فعّل Enabled، واضبط Report Method على HTTP إن ظهر، وحدّد Username وPassword خاصين بالواجهة البرمجية (لا حساب المسؤول). ثم احفظ وطبّق.
3. في تيلايزر أدخل عنوان المقسم والمنفذ 8088 وUsername وPassword الخاصين بالواجهة البرمجية، ثم اختر فحص الاتصال.
4. يسجّل تيلايزر الدخول ويطلب من المقسم إرسال كل سجل مكالمة إلى عنوان تيلايزر لديك على المنفذ منفذ الموصّل لديك؛ ولا شيء آخر يُضبط في المقسم.

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

تنطبق على: S-Series VoIP PBX.

1. سجّل الدخول إلى واجهة الويب في المقسم وافتح Settings → PBX → General → API. فعّل Enabled، واضبط Report Method على HTTP إن ظهر، وحدّد Username وPassword خاصين بالواجهة البرمجية (لا حساب المسؤول). ثم احفظ وطبّق.
2. في تيلايزر افتح هذا الموصّل واختر إنشاء رمز تسجيل. تحصل على رمز ورابط تنزيل ترسلهما إلى الشخص المسؤول في الموقع، ويعمل كل منهما مرة واحدة وتنتهي صلاحيته خلال 24 ساعة.
3. على جهاز Windows يعمل دائماً وفي الشبكة نفسها التي فيها نظام الهاتف، افتح الرابط وشغّل TelyzerRelaySetup.exe (يكون الرمز معبّأً). اختر Another phone system ثم Install. يعمل المرحّل كخدمة باسم TelyzerRelay، ولا يخرج من هذا الجهاز إلا اتصال HTTPS صادر.
4. على جهاز المرحّل (PowerShell بصلاحية المسؤول): telyzer-relay add-collector --kind yeastar_s_events --host <PBX address> --user <API username> --password <API password> ثم Restart-Service TelyzerRelay. يسجّل المرحّل الدخول، ويرسل المقسم كل سجل إلى جهاز المرحّل على المنفذ 33333.
5. تحقق منه على جهاز المرحّل: telyzer-relay check-collector <PBX address>.

أحداث الواجهة البرمجية — يسجّل تيلايزر الدخول ويرسل المقسم كل سجل

موصى بها في تيلايزر السحابي وخادم تيلايزر. تنطبق على: Cloud PBX.

1. سجّل الدخول إلى واجهة الويب في المقسم وافتح Settings → PBX → General → API. فعّل Enabled، واضبط Report Method على HTTP إن ظهر، وحدّد Username وPassword خاصين بالواجهة البرمجية (لا حساب المسؤول). ثم احفظ وطبّق.
2. في تيلايزر أدخل عنوان Cloud PBX (نطاقه) والمنفذ 443 وUsername وPassword الخاصين بالواجهة البرمجية، ثم اختر فحص الاتصال.
3. يسجّل تيلايزر الدخول ويطلب من Cloud PBX إرسال كل سجل مكالمة إلى عنوان تيلايزر لديك على المنفذ منفذ الموصّل لديك.

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

1. أجرِ مكالمة خارجية تجريبية ثم أنهِها. يرسل نظام الهاتف السجل عند انتهاء المكالمة، فيصل بعد ثوانٍ.
2. في تيلايزر يتحول مؤشر بانتظار أول سجل مكالمة إلى الأخضر عند قراءة أول سجل. وإن ظهرت مشكلة بدلاً من ذلك — لا اتصال بعد، أو اتصالات مرفوضة، أو سجلات تعذّرت قراءتها — فإنه يذكر السبب ويعرض السطر المستلم.
3. تظهر المكالمة نفسها في قائمة CDR في المقسم. وتظهر أي مشكلة في تسجيل الدخول في تيلايزر خطأً محدداً (بيانات دخول خاطئة، أو عنوان مرفوض، أو مقسم يتعذر الوصول إليه).
4. S-Series وCloud PBX: خمس محاولات دخول فاشلة تحظر عنوان تيلايزر لمدة 10 دقائق. ولرفع الحظر فوراً احذفه من PBX → System → Security → IP Auto Defense → Blocked IP Address (في Cloud PBX: Settings → System → Security → Access Control → Blocked IP Address).

ملاحظات

• يتطلب Webhook برنامجاً ثابتاً بالإصدار 37.20.0.21 أو أحدث في P-Series، أو 84.20.0.21 أو أحدث في Cloud Edition. ويقبل المقسم حتى خمسة عناوين Webhook، فيمكن أن يشارك تيلايزر غيره من التطبيقات.
• لا ينقل Webhook إلا المكالمات التي تنتهي بعد إضافته، أما طريقتا WebSocket وواجهة CDR البرمجية فتجلبان أيضاً مكالمات آخر 30 يومًا.
• يستخدم تيلايزر الواجهة البرمجية لاستقبال سجلات المكالمات فقط، ولا يتحكم في المكالمات ولا يغيّر التحويلات أو المسارات.

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