لاستخدام هاتف Verimor في Mavibot، تحتاج إلى الحصول على مفتاح API من حساب Verimor الخاص بك وإدخاله في إعدادات التكامل.

Verimor هو مزود اتصالات تركي. منتجه Bulut Santralim هو نظام PBX سحابي: يعمل الموظفون مع أرقام داخلية، ويتم توجيه المكالمات من خلال هذه الأرقام.

يمكن للبوت ربط الموظف بالعميل، وتحويل المكالمات وإنهائها، واسترجاع التسجيلات، وإرسال أحداث المكالمات إلى المحادثة.

الحصول على البيانات المطلوبة

  1. قم بتفعيل خدمة Bulut Santralim مع Verimor وأنشئ أرقامًا داخلية لموظفيك.
  2. افتح Online İşlem Merkezi → Bulut Santralim → Santral Ayarlarım وانسخ مفتاح API. يبدو هكذا:
K12345678-1234-5678-4321-123456789012
  1. اكتب الأرقام الداخلية للموظفين. ستحتاج إلى تحديدها في إعدادات الوصول.

مفتاح API مشترك عبر نظام PBX بالكامل ويُستخدم لكل من المكالمات واستقبال الأحداث. إذا قمت بإعادة توليده في لوحة تحكم Verimor، تأكد من حفظ نموذج الاتصال مرة أخرى. وإلا، ستتوقف كل من المكالمات وأحداث المحادثة عن العمل.

الاتصال

في تبويب الهاتف، اختر Verimor وأدخل:

  • مفتاح API — المفتاح من قسم Santral Ayarlarım.
  • الرقم الصادر — الرقم الخارجي الذي سيراه العميل، بالصيغة 908505320000. هذا الحقل اختياري. إذا تُرك فارغًا، سيتم استخدام الرقم المخصص للرقم الداخلي للموظف.

تم الآن ربط التكامل.

لفصل التكامل، امسح حقل مفتاح API واحفظ الإعدادات.

لا تحتاج إلى تكوين عنوان URL للإشعارات يدويًا. يقوم Mavibot بتعيينه تلقائيًا في نظام PBX الخاص بك عند حفظ مفتاح API.

الموظفون

في إعدادات الموظف، املأ الرقم الداخلي (dahili) للموظف — عادةً 3-4 أرقام، على سبيل المثال 1001.

أدخل الرقم الداخلي لنظام PBX، وليس رقم هاتف الموظف المحمول. بدونه، لن يعمل زر الاتصال في بطاقة العميل لهذا الموظف.

الاتصال من بطاقة العميل

سيظهر زر اتصال بجوار رقم هاتف العميل في بطاقة المحادثة.

يقوم نظام PBX أولاً بالاتصال بـ الرقم الداخلي للموظف. فقط بعد أن يرد الموظف، يتصل بالعميل.

هذا الترتيب مقصود: لن يسمع العميل صمتًا على الخط لأن الموظف متصل بالفعل عندما يبدأ هاتف العميل في الرنين.

وظائف الحاسبة

مكالمة من موظف إلى عميل

verimor_employee_call(client_phone, employee_extension, caller_id)

المعلمات:

  • client_phone — رقم هاتف العميل. مطلوب. استخدم الصيغة التركية 908505320000، أو 00493027590915 للمكالمات الدولية.
  • employee_extension — الرقم الداخلي للموظف الذي سيرن هاتفه. مطلوب.
  • caller_id — الرقم الذي سيراه العميل. اختياري. إذا تم حذفه، يتم استخدام الرقم الصادر من إعدادات الاتصال.

تُرجع الدالة call_uuid — معرف المكالمة. يتم حفظه أيضًا في متغير verimor_call_uuid.

تحويل مكالمة

verimor_transfer_call(employee_extension, call_uuid)

يحول المكالمة الحالية إلى رقم داخلي آخر.

المعلمات:

  • employee_extension — الرقم الداخلي الذي سيتم تحويل المكالمة إليه. مطلوب.
  • call_uuid — معرف المكالمة. اختياري. إذا تم حذفه، يتم استخدام أحدث مكالمة للعميل.

إنهاء مكالمة

verimor_hangup_call(call_uuid)

المعلمات:

  • call_uuid — معرف المكالمة. اختياري. إذا تم حذفه، يتم استخدام أحدث مكالمة للعميل.

الحصول على رابط تسجيل المكالمة

verimor_get_record_link(call_uuid)

يطلب رابطًا جديدًا لتسجيل المكالمة.

المعلمات:

  • call_uuid — معرف المكالمة. اختياري. إذا تم حذفه، يتم استخدام أحدث مكالمة للعميل.

الأحداث أثناء المكالمة

أثناء تقدم المكالمة، يتم إرسال أحداث إلى المحادثة بالصيغة التالية:

verimor_call_event answer

الأحداث الممكنة:

الحدث متى يتم تشغيله
ringing المكالمة ترن
answer تم الرد على المكالمة
hangup انتهت المكالمة
user_hangup أنهى الموظف المكالمة

المكالمات بين الموظفين لا تظهر في المحادثة.

سيناريو نموذجي "لا رد → إرسال رسالة في المراسل" يمكن تشغيله بواسطة hangup والتحقق من متغير verimor_call_answered.

متغيرات العميل بعد المكالمة

المتغير القيمة
verimor_call_uuid معرف المكالمة
verimor_call_direction الاتجاه: inbound — العميل يتصل بك، outbound — أنت تتصل بالعميل
verimor_call_extension الرقم الداخلي للموظف الذي تعامل مع المكالمة
verimor_call_duration مدة المكالمة بالثواني
verimor_call_answered 1 — تم الرد على المكالمة، 0 — لم يتم الرد
verimor_hangup_cause رمز يشير إلى سبب انتهاء المكالمة
verimor_has_record 1 — يوجد تسجيل، 0 — لا يوجد تسجيل
verimor_record_link رابط تسجيل المكالمة بعد استدعاء verimor_get_record_link()

رموز سبب الإنهاء

القيم الأكثر شيوعًا لـ verimor_hangup_cause هي:

الرمز المعنى
NORMAL_CLEARING اكتملت المكالمة وانتهت بشكل طبيعي
USER_BUSY مشغول
NO_ANSWER لا رد
ORIGINATOR_CANCEL أغلق المتصل الخط قبل الرد على المكالمة
CALL_REJECTED تم رفض المكالمة
UNALLOCATED_NUMBER رقم غير صالح
NO_USER_RESPONSE المشترك غير متاح
NOT_ALLOWED_BY_IYS لا إذن في İYS، سجل الموافقة التركي للمكالمات التجارية

تسجيلات المكالمات

يجب تفعيل تسجيل المكالمات في إعدادات نظام PBX الخاص بك في Verimor. يتم تخزين التسجيلات في حساب Verimor الخاص بك.

⏳ روابط التسجيل تظل صالحة لمدة 60 دقيقة من لحظة طلبها. بعد ذلك، تتوقف عن العمل. كما يسمح Verimor بما لا يزيد عن خمسة طلبات لروابط التسجيل في الدقيقة لكل مفتاح API.

ماذا يعني هذا:

  • متغير verimor_record_link لا يتم ملؤه تلقائيًا. يجب عليك أولاً استدعاء verimor_get_record_link().
  • في سيناريو يرسل تسجيلًا، استدعِ verimor_get_record_link() في لحظة إرسال التسجيل، وليس مسبقًا.
  • تحقق من verimor_has_record أولاً حتى لا تهدر حد الطلبات على مكالمات لا تحتوي على تسجيل.
  • إذا كنت بحاجة إلى الاحتفاظ بالتسجيل بشكل دائم، احفظ الملف في وحدة التخزين الخاصة بك مباشرة بعد المكالمة.
  • يظل أرشيف التسجيلات متاحًا في لوحة تحكم Verimor، حيث يمكن تشغيل التسجيلات وتنزيلها لاحقًا.

تسجيل المكالمات منظم بالقانون. في تركيا، يخضع لمتطلبات KVKK: يجب إبلاغ العميل بالتسجيل، ويجب أن يكون تخزين البيانات الشخصية له أساس قانوني. مالك حساب Verimor مسؤول عن الامتثال للمتطلبات المعمول بها.

استكشاف الأخطاء وإصلاحها

الخطأ السبب / الحل
Gecersiz anahtar مفتاح API غير صالح. احصل على المفتاح الحالي من قسم Santral Ayarlarım.
extension 1005 not found الرقم الداخلي غير موجود في نظام PBX الخاص بك. تأكد من أن إعدادات الموظف تحتوي على dahili موجود.
"Verimor internal extension is not specified" إعدادات الموظف فارغة أو تحتوي على رقم هاتف محمول بدلاً من رقم داخلي.
المكالمات تعمل، لكن لا تظهر أحداث في المحادثة لم يتم تكوين عنوان URL للإشعارات. احفظ نموذج الاتصال مرة أخرى.
توقفت المكالمات عن العمل بعد تغيير مفتاح API تم إعادة توليد المفتاح في لوحة تحكم Verimor. أدخل المفتاح الجديد في نموذج الاتصال واحفظه.
رابط التسجيل لا يفتح انتهت صلاحية الرابط. اطلب رابطًا جديدًا باستخدام verimor_get_record_link() أو افتح التسجيل في لوحة تحكم Verimor.
لا يتم إرجاع رابط التسجيل تم الوصول إلى حد خمسة طلبات في الدقيقة، أو لا يوجد تسجيل للمكالمة. تحقق من verimor_has_record.