مقدمة
يُدمج الدردشة المباشرة لـ Buzzbip عبر مقتطف ودجة مستضاف موثق في إعدادات حسابك. توجد واجهات جلسة برمجية تحت /api/chat لتكاملات الشات بوت، لكن لا يوجد SDK JavaScript عام للودجة. استخدم هذا الدليل لتضمين المتجر وصفحة Chat API للتحكم في الجلسة من الخادم.
الخطوات
اتبع هذه الخطوات لإكمال التكامل.
- أنشئ مفتاح API للشات بوت في إعدادات Buzzbip.
- اجلب إعداد الودجة عبر GET /api/chat/config/{key}.
- ضمّن مقتطف السكربت المقدم في صفحات متجرك.
- ابدأ الجلسات بـ POST /api/chat/start مع Bearer buz-cb-{uuid} من /integration.
- وجّه ردود الوكلاء عبر inbox Buzzbip — لا يوجد API JS عام للودجة.
التفاصيل
تُدمج الدردشة المباشرة عبر مقتطف ودجة مستضاف موثق في إعدادات حسابك. توجد واجهات جلسة تحت /api/chat لكن لا يوجد SDK JavaScript عام للودجة.
اختبر في بيئة التجربة قبل الإنتاج.
ملاحظات التكامل
عند دمج نقطة نهاية Buzzbip هذه، استخدم https://app.buzzbip.com كمضيف إنتاج. احصل على JWT من POST /api/login_check وأرسل Authorization: Bearer في كل طلب. تأكد من تفعيل User.hasApiAccess في إدارة Buzzbip. حلّل استجابات JSend (status وmessage وdata). لإضافات التجارة الإلكترونية، أرسل أيضاً x-api-key وx-platform-type وx-base-uri. احترم الشرطة المائلة النهائية في POST /api/contacts/ وPOST /api/whatsapp/. نفّذ إعادة المحاولة مع backoff عند حدود المعدل. خزّن بيانات الاعتماد على الخادم وأعد المصادقة قبل انتهاء JWT (3600 ثانية).
الأمان
أفضل الممارسات: بيانات الاعتماد على الخادم فقط، TLS إلزامي، مراقبة فشل المصادقة. افصل حسابات التجربة والإنتاج. وثّق القوالب والأتمتة. احذف الأرقام والمحتوى من السجلات المشتركة.
ما التالي؟
تابع التعلم: api/chat api/contacts getting-started/introduction