كيفية تضمين Bitcall Webphone في موقعك أو نظام CRM

April 2, 2026

2 دقيقة قراءة

كيفية تضمين Bitcall Webphone في موقعك أو نظام CRM

أضف هاتف SIP/WebRTC متكامل الميزات إلى موقعك أو منصة SaaS أو نظام CRM ببضعة أسطر من الكود.

ما هو

يمكن تضمين Bitcall Webphone كأداة (widget) أو كعنصر مستقل. يتيح ذلك لموظفيك أو مستخدميك:

إجراء المكالمات مباشرةً من لوحة التحكم الخاصة بك.
تفعيل ميزة "Click-to-Call" على أي رقم هاتف في موقعك.
تسجيل المكالمات وحفظها مباشرةً في قاعدة بيانات CRM عبر الأحداث.

ما ستحتاجه

حساب Bitcall نشط.
مفتاح API الخاص بك (تجده في Settings -> API).
موقع ويب يمكنك الوصول إلى <head> أو <body> في كود HTML الخاص به.

التكامل خطوة بخطوة

الخطوة 1: أضف السكربت

أضف سكربت التحميل الخاص بـ Bitcall إلى كود HTML:

<script src="/webphone/loader.js"></script>

الخطوة 2: تهيئة الهاتف

أضف مقتطف JavaScript هذا إلى صفحتك (عادةً قبل وسم الإغلاق </body>):

BitcallWebphone.init({

key: 'YOUR_API_KEY',

sip: {

username: 'agent_name',

domain: 'gateway.bitcall.io'

  },

interceptTelLinks: true,

phoneSelectors: ['.phone-link']

});

حقول الإعداد:

key: مفتاح Bitcall API الفريد الخاص بك.
sip.username: اسم المستخدم الخاص بالموظف (اختياري للتعبئة المسبقة).
interceptTelLinks: يحوّل روابط tel: تلقائيًا إلى مكالمات عبر Bitcall.
phoneSelectors: قائمة بفئات CSS التي يراقبها الهاتف لتفعيل "Click-to-Call".

الأحداث المتاحة للمطورين

يمكنك الاستماع لهذه الأحداث لمزامنة بيانات المكالمات مع نظام CRM:

callStarted: يُطلق عندما يضغط الموظف على زر الاتصال.
callIncoming: يُطلق عند وصول مكالمة جديدة.
callAnswered: يُطلق عند بدء المحادثة.
callEnded: يُطلق عند انتهاء المكالمة (يتضمن مدة المكالمة).
registered: يؤكد أن الهاتف جاهز للاستخدام.

مثال على الكود:

BitcallWebphone.on('callEnded', (data) => {

console.log("Call with " + data.number + " lasted " + data.duration + " seconds.");

// Save this to your CRM via AJAX here

});

الميزات المتقدمة المضمّنة

دعم المكالمات المتعددة: إدارة مكالمتين أو أكثر في الوقت نفسه (تبديل / دمج).
تسجيل المكالمات: إيقاف التسجيل أو بدؤه من الواجهة أو عبر API.
تشغيل الصوت: تشغيل مقاطع مسجلة مسبقًا أثناء المكالمة.
نغمات DTMF: إرسال النغمات للتنقل في قوائم الرد الآلي الخارجية (IVR).
دعم PWA: يتيح للمستخدمين "تثبيت" الهاتف المضمّن كتطبيق مستقل.
وضع النافذة المنفصلة: يتيح للمستخدمين نقل الهاتف إلى نافذة منفصلة حتى لا يُغلق عند التنقل في موقعك.

الأمان وأفضل الممارسات

النطاقات المسموح بها: في لوحة تحكم Bitcall، أضف إلى القائمة البيضاء النطاقات التي يُسمح للهاتف بالعمل عليها.
مفاتيح API: لا تشارك أبدًا مفتاح Admin API الخاص بك. استخدم مفتاح عميل مقيدًا إن توفر.
دعم الهاتف المحمول: يعمل الهاتف المضمّن بشكل أفضل على المتصفحات الحديثة. تأكد من أن موقعك يستخدم HTTPS، لأن المتصفحات تمنع الوصول إلى الكاميرا والميكروفون عبر HTTP.

النتيجة المتوقعة

تظهر أداة هاتف دائمة على موقعك. يؤدي النقر على أي رقم هاتف في نظام CRM إلى بدء مكالمة عبر Bitcall تلقائيًا دون أن يغادر الموظف الصفحة.

المقال السابق

لا يوجد مقال سابق

المقال التالي

كيفية استخدام Bitcall Webphone في متصفحك

في هذه الصفحة

هل تحتاج إلى مزيد من المساعدة؟

لم تجد ما تبحث عنه؟ فريق الدعم لدينا هنا لمساعدتك.

تواصل معنا