الانتقال إلى المحتوى الرئيسي
تسمح واجهات برمجة تطبيقات Connect360 للواجهة الخلفية الموثوقة بإنشاء المحادثات وإرسال الرسائل وتحميل المرفقات وتشغيل ردود AI. استخدمها من أجل:
  • أدوات الدردشة على موقع الويب.
  • بوابات دعم العملاء.
  • طلب تجارب الدعم.
  • التطبيقات الخارجية التي تحتاج إلى إنشاء محادثات Connect360 أو تحديثها.

المحادثات

إنشاء محادثات العملاء أو إعادة استخدامها وتنظيم سلاسل الدعم.

رسائل

إرسال الرسائل، وسرد سجل المحادثات، والعمل مع محتوى المحادثة.

المرفقات

تحميل الملفات واستخدام أصول المرفقات في الرسائل.

تيار AI

قم بتشغيل الردود بمساعدة AI لتجارب الدردشة المدعومة.

محادثات الضيوف

اسمح لزوار موقع الويب الخارجيين ببدء المحادثة أو متابعتها بأمان.

المصادقة

أرسل مفاتيح API من واجهة خلفية موثوقة قبل الاتصال بـ Connect360.

​
أنماط API

يستخدم Connect360 كلاً من نقطتي النهاية SDK وREST. استخدم SDK للمحادثات والرسائل: 
plato.v1.connect.getOrCreateConversation.mutate(...)
plato.v1.connect.send.mutate(...)
plato.v1.connect.listMessages.query(...)
استخدم REST لتحميل المرفقات الملائمة للمتصفح وتدفق ردود AI: 
POST /api/v1/connect/attachments
GET  /api/v1/connect/assets/[...key]
POST /api/v1/connect/ai-stream

​
الأذونات المطلوبة

فعلإذن
قراءة المحادثات والرسائلconnect360:conversation:read
قم بإنشاء المحادثات وإرسال الرسائل وتحميل المرفقات وتشغيل AIconnect360:conversation:engage
حذف المحادثاتconnect360:conversation:delete
يجب أن ينتمي المفتاح API إلى أحد أعضاء مساحة العمل.

​
نموذج المحادثة

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

​
هوية العميل

بالنسبة لموقع الويب أو المستخدمين الخارجيين، قم بتمرير كائن customer أو customerId الموجود. لا تقم بإنشاء زوار موقع الويب كأعضاء في مساحة العمل. 
customer: {
  externalId: "website_user_123",
  name: "Jane Customer",
  email: "[email protected]",
  phone: "+971500000000",
}
يمكن لـ Plato مطابقة العملاء عن طريق المعرف الخارجي أو البريد الإلكتروني أو الهاتف.

​
قنوات الموقع

يمكن أن تمر عمليات تكامل مواقع الويب بـ channelIdentifier. 
channelIdentifier: "example.com"
يقوم Plato بتطبيع المعرف وإنشاء قناة موقع ويب أو إعادة استخدامها وإرفاقها بالمحادثة. استخدم مضيف موقع الويب الحالي، مثل example.com أو shop.example.com.