أداة الدردشة

جميع نقاط النهاية التي تستخدمها أداة الدردشة المُضمَّنة في موقعكم الإلكتروني.

تدمج أداة الدردشة روبوت الدردشة الخاص بكم في موقعكم الإلكتروني. تصف هذه المجموعة جميع نقاط النهاية التي تستخدمها الأداة: فحص الإتاحة، وتهيئة الأداة العامة، وإرسال الرسائل، وسجل المحادثة، واستدعاء الرسائل الجديدة (مثلًا بعد تولّي أحد الموظفين)، والتقييم، وأحداث الاستخدام، إضافةً إلى الإدخال والإخراج الصوتيين.

يمكن الوصول إلى `health` و`config` دون مصادقة، حتى تتمكن الأداة من بدء تشغيلها في المتصفح. أما باقي نقاط النهاية فتتوقع رمز الأداة (`widget_code`) ورمز التضمين (embed token) الخاص بالأداة في الترويسة `X-Widget-Token`. تُنشئ Zentor الأداة عند إعداد حسابكم، وتحفظ النطاقات المعتمدة، وتوفّر لكم رمز التضمين مع رمز الأداة ورمز التضمين. ويرفض الخادم الاستدعاءات من نطاقات غير معتمدة بـ403 `WIDGET_ORIGIN_DENIED`، ويستجيب لأداة مُعطَّلة بـ404 `WIDGET_DISABLED`.

تنطبق بالإضافة إلى ذلك قواعد وصول حسابكم (قواعد IP والدول والنطاقات). `message` ليس idempotent: كل إرسال متكرر يُولِّد رسالة جديدة وردًا جديدًا.

GET/api/public/widget/healthGET/api/public/widget/config/:widget_codePOST/api/public/widget/messageGET/api/public/widget/historyPOST/api/public/widget/pollPOST/api/public/widget/ratingPOST/api/public/widget/trackPOST/api/public/widget/voice-transcribePOST/api/public/widget/voice-speak
← مرجع واجهة برمجة التطبيقات