Client APIs

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

إنشاء واجهات باستخدام برمجة تطبيقات العملاء

ملاحظة: لا تزال واجهات برمجة التطبيقات هذه في إصدار ألفا، وقد تكون هناك تغييرات في التنفيذ في المستقبل.

واجهات برمجة تطبيقات العميل المتاحة لقناة API ستساعدك على بناء واجهات لعملاء بيفاتيل

تعد واجهات برمجة التطبيقات هذه مفيدة للحالات المشابهة لتلك الموضحة أدناه.

1. استخدم واجهة دردشة مخصصة بدلا من أداة الدردشة من بيفاتيل

2. إنشاء واجهات محادثة في تطبيقات الأجهزة المحمولة الخاصة بك

3. أضف بيفاتيل إلى منصات أخرى لا تمتلك بيفاتيل لها مجموعة SDK رسمية

إنشاء عناصر العملاء​

يمكنك إنشاء عناصر بيانات العملاء واستردادها باستخدام inbox_identifier و customer_identifier.

معرف البريد الوارد​

يمكنك الحصول على inbox_identifier من قناة API الخاصة بك -إعدادات > -تكوين >

معرف العميل​

يمكن الحصول على customer_identifier أو source_id عند إنشاء واجهة العميل باستخدام إنشاء واجهة برمجة التطبيقات.

ستحتاج إلى تخزين هذا المعرف من جانب العميل الخاص بك لتقديم طلبات أخرى نيابة عن العميل.

يمكن القيام بذلك في ملفات تعريف الارتباط والتخزين المحلي وما إلى ذلك.

واجهات برمجة التطبيقات المتاحة

بعض الأشياء التي يمكنك القيام بها عبر واجهات برمجة التطبيقات هي:-

إنشاء جهة اتصال وعرضها وتحديثها

إنشاء المحادثات وإدراجها

إنشاء الرسائل وإدراجها وتحديثها

مصادقة HMAC

تدعم واجهات برمجة تطبيقات العميل أيضا مصادقة HMAC.

يمكن الحصول على رمز HMAC للقناة عن طريق تشغيل ما يلي على وحدة التحكم.

# replace api_inbox_id with your inbox id
Inbox.find(api_inbox_id).channel.hmac_token

الاتصال بـ WebSockets من بيفاتيل

لتلقي تحديثات في الوقت الفعلي من لوحة تحكم الموظف، يمكنك الاتصال ب WebSockets من بيفاتيل.

يمكن إجراء اتصال WebSockets من بيفاتيل على الرابط التالي

<your installation url>/cable

التحقق من اتصال WebSocket الخاص بك

ستبدأ في تلقي الأحداث الموجهة إلى العميل الخاص بك بعد الاشتراك باستخدام pubsub_token العميل.

يتم توفير pubsub_token أثناء استدعاء واجهة برمجة التطبيقات التي أنشأها العميل.

Example​

const connection = new WebSocket('ws://localhost:3000/cable');
connection.send(JSON.stringify({ command:"subscribe", identifier: "{\"channel\":\"RoomChannel\",\"pubsub_token\":\""+ customer_pubsub_token+"\"}" }));