لاستخدام هاتف VoIPstudio في Mavibot، تحتاج إلى إنشاء مفتاح API في حساب VoIPstudio الخاص بك، وإدخاله في إعدادات التكامل، وتكوين تسليم الأحداث إلى الرابط الذي يعرضه Mavibot بعد ربط التكامل.
VoIPstudio هو نظام PBX سحابي مع أرقام هواتف متاحة في أكثر من 70 دولة. على عكس مشغلي الاتصالات التقليديين، يدعم المستخدمين الداخليين، ومجموعات الرنين، والطوابير، وقوائم IVR، بينما يعمل البوت فوق نظام PBX هذا.
يمكن للبوت إجراء مكالمات للعملاء نيابة عن الموظفين، وتحويل المكالمات وإنهائها، وحفظ التسجيلات، وإرسال أحداث المكالمات إلى المحادثة.
الحصول على المعلومات المطلوبة
- سجّل في voipstudio.com واشترِ رقم هاتف في البلد المطلوب.
- أنشئ مستخدمين في نظام PBX — مستخدم واحد لكل موظف سيستقبل المكالمات. يتم تسليم المكالمات إلى جميع الأجهزة المسجلة للمستخدم، لذلك لا تحتاج إلى تحديد رقم هاتف منفصل لكل موظف.
- انتقل إلى الإعدادات ← API، وأنشئ مفتاح API، وانسخه.
ربط التكامل
في إعدادات الهاتف، اختر VoIPstudio وأدخل:
- مفتاح API — المفتاح من حساب VoIPstudio الخاص بك.
تم الآن ربط التكامل. لفصله، امسح حقل مفتاح API واحفظ الإعدادات.
بعد الحفظ، سيظهر رابط الإشعار على الصفحة. انسخه:
https://chatter.mavibot.ai/voipstudio_webhook/
لا تنشر هذا الرابط أو تشاركه مع أي شخص. إذا قمت بفصل التكامل وإعادة ربطه، يبقى المفتاح كما هو، لذلك لن تحتاج إلى تكوين الإشعارات مرة أخرى.
ثم، في حساب VoIPstudio الخاص بك، انتقل إلى التكاملات ← Webhooks ← تمكين ← إضافة Webhook، والصق الرابط المنسوخ، وحدد الأحداث التالية:
- تغيير حالة المكالمة — أو حدد رنين المكالمة، واتصال المكالمة، وانتهاء المكالمة، والمكالمة الفائتة بشكل فردي؛
- تسجيل المكالمة جاهز — إذا كنت بحاجة إلى تسجيلات المكالمات.
بدون هذا التكوين، ستظل المكالمات الصادرة تعمل، لكن لن تظهر أحداث المكالمات في المحادثة.
الموظفون
في إعدادات الموظف، املأ حقل معرف مستخدم VoIPstudio — المعرّف الرقمي للمستخدم في نظام PBX الخاص بك، على سبيل المثال 10002.
أدخل معرف مستخدم PBX، وليس رقم هاتف. يمكنك العثور على المعرف في قائمة المستخدمين في حساب VoIPstudio الخاص بك. بدونه، لن يعمل زر الاتصال في بطاقة العميل لهذا الموظف.
الاتصال من بطاقة العميل
سيظهر زر اتصال بجوار رقم هاتف العميل في بطاقة المحادثة.
يتصل VoIPstudio أولاً بـ الموظف على جميع أجهزته المسجلة في وقت واحد. بمجرد أن يرد الموظف، يتصل VoIPstudio بـ العميل ويربط الطرفين.
إذا لم يرد الموظف، فلن يتم الاتصال بالعميل.
وظائف الحاسبة
مكالمة من موظف إلى عميل
voipstudio_employee_call(client_phone, employee_user_id, caller_id)
المعلمات:
- client_phone — رقم هاتف العميل. مطلوب.
- employee_user_id — معرف مستخدم VoIPstudio للموظف الذي يجب أن يستقبل المكالمة الأولى. مطلوب.
-
caller_id — رقم الهاتف الذي يظهر للعميل. اختياري. يمكنك تمرير
anonymousلإخفاء معرف المتصل.
تحويل مكالمة
voipstudio_transfer_call(phone, call_id)
يحول مكالمة نشطة إلى رقم هاتف آخر.
المعلمات:
- phone — رقم الهاتف الذي يجب تحويل المكالمة إليه. مطلوب ويجب أن يكون المعلمة الأولى.
-
call_id — معرف المكالمة. اختياري. إذا تم حذفه، يتم أخذ مكالمة العميل الحالية من متغير
voipstudio_call_id.
إنهاء مكالمة
voipstudio_hangup_call(call_id)
ينهي مكالمة نشطة.
المعلمات:
- call_id — معرف المكالمة. اختياري. إذا تم حذفه، يتم استخدام مكالمة العميل الحالية.
الحصول على رابط تسجيل المكالمة
voipstudio_get_record_link(call_id)
يعيد رابطًا لتسجيل المكالمة. عادةً ما يتم حفظ الرابط تلقائيًا عند استلام حدث جاهزية التسجيل. هذه الوظيفة مفيدة إذا لم يتم استلام هذا الحدث.
المعلمات:
- call_id — معرف المكالمة. اختياري. إذا تم حذفه، يتم استخدام مكالمة العميل الحالية.
تبحث الوظيفة في أحدث 100 تسجيل في الحساب. بالنسبة لمكالمة أقدم على نظام PBX عالي الحجم، قد لا تجد التسجيل. في هذه الحالة، استرجع التسجيل مباشرة من حساب VoIPstudio الخاص بك.
الاستدعاءات أثناء المكالمة
مع تقدم المكالمة، يتم إرسال الاستدعاءات إلى المحادثة بالتنسيق التالي:
voipstudio_call_event call.hangup
يتم تمرير اسم الحدث تمامًا كما تم استلامه من VoIPstudio، على سبيل المثال call.ringing، call.connected، call.hangup، وغيرها. تعتمد الأحداث المتاحة على الأحداث التي حددتها عند تكوين الإشعارات.
إذا لم يتم توفير اسم حدث، يتم استخدام حالة المكالمة بدلاً من ذلك:
INITIAL، RINGING، CONNECTED، ON_HOLD، HANGUP.
يتم إرسال استدعاء منفصل عندما يكون التسجيل جاهزًا:
voipstudio_call_event recording
انتظر استدعاء
recordingقبل استخدام رابط التسجيل. تتم معالجة التسجيل بعد انتهاء المكالمة، لذلك يظل متغيرvoipstudio_record_linkفارغًا عند استلامcall.hangup.
إذا كان موظفان داخل نظام PBX الخاص بك يتحدثان مع بعضهما البعض، فلن يتم إرسال الاستدعاءات إلى المحادثة ولن يتم إنشاء بطاقة عميل.
متغيرات العميل بعد المكالمة
| المتغير | القيمة |
|---|---|
| voipstudio_call_id | معرف المكالمة في VoIPstudio |
| voipstudio_call_state | حالة المكالمة: INITIAL، RINGING، CONNECTED، ON_HOLD، HANGUP
|
| voipstudio_call_duration | مدة المكالمة بالثواني |
| voipstudio_call_cause | سبب انتهاء المكالمة |
| voipstudio_terminated_by | من أنهى المكالمة: caller أو callee
|
| voipstudio_record_link | رابط تسجيل المكالمة |
| voipstudio_record_id | معرف التسجيل في VoIPstudio |
تسجيلات المكالمات
يتم تمكين تسجيل المكالمات في إعدادات VoIPstudio ويتم إدارته بواسطة نظام PBX نفسه. إذا كنت بحاجة إلى تسجيلات، فقم بتمكين تسجيل المكالمات في حساب VoIPstudio الخاص بك وحدد حدث تسجيل المكالمة جاهز عند تكوين الإشعارات.
رابط
voipstudio_record_linkمحمي بمفتاح وصول. لا يمكن فتحه مباشرة في متصفح أو مشاركته مع عميل. يمكنك تنزيل التسجيل من حساب VoIPstudio الخاص بك في قسم سجل المكالمات.
يخضع تسجيل المكالمات للقوانين المعمول بها. في ألمانيا وفرنسا وإسبانيا ومعظم الولايات الأمريكية، قد تكون موافقة الطرفين مطلوبة، وفي بعض الولايات القضائية قد يكون إشعار شفهي في بداية المكالمة ضروريًا أيضًا. مالك حساب VoIPstudio مسؤول عن الامتثال لهذه المتطلبات.
استكشاف الأخطاء وإصلاحها
| الخطأ | السبب |
|---|---|
| خطأ في التفويض عند إنشاء مكالمة |
مفتاح API غير صحيح أو منتهي الصلاحية. تأكد من إنشاء المفتاح تحت الإعدادات ← API بدلاً من الحصول عليه عبر طلب login. |
| المكالمات تعمل، لكن لا تظهر استدعاءات في المحادثة | لم يتم إنشاء webhook في VoIPstudio، أو أن مفتاح تمكين مغلق، أو تم إدخال رابط خاطئ. انسخ الرابط بالكامل من صفحة التكامل، بما في ذلك المفتاح في النهاية. |
| لا يمكن إنشاء المكالمة أو لا ترن أجهزة الموظف | تم إدخال رقم هاتف بدلاً من معرف مستخدم VoIPstudio، أو لا يمتلك المستخدم أجهزة مسجلة. |
لا يتم استلام استدعاء recording
|
تسجيل المكالمات غير ممكّن في VoIPstudio، أو لم يتم تحديد حدث تسجيل المكالمة جاهز. |
يتم فوترة VoIPstudio مباشرة من قبل VoIPstudio: هناك رسوم اشتراك لكل مستخدم PBX، بالإضافة إلى رسوم المكالمات. يختلف هذا عن المشغلين الذين يفرضون رسومًا بالدقيقة دون اشتراك متكرر. عند تقدير التكاليف، ضع في الاعتبار عدد المستخدمين المكوّنين، وليس فقط حجم المكالمات.