كيفية إعداد تكامل مخصص لواجهة برمجة التطبيقات (API) مع AI Assist
التعليمات التالية مخصصة لأجهزة الكمبيوتر المكتبية والمحمولة فقط.
تتيح ميزة AI Assist من tawk.to ربط الدردشة المباشرة بأنظمتك الخلفية، مما يمنح العملاء وصولًا سريعًا إلى معلومات المنتجات والطلبات في الوقت الفعلي. يساعد ذلك العملاء على تصفح المخزون، إجراء الطلبات وتتبعها، حجز المواعيد، والمزيد بسهولة.
جهّز مخطط OpenAPI الخاص بك
أولاً، ستحتاج إلى مخطط OpenAPI الخاص بك، وهو ملف بصيغة JSON (.json) أو YAML (.yaml) يحدد كيفية التواصل بين واجهة API وميزة AI Assist. يحتوي هذا المخطط على نماذج البيانات، ونقاط النهاية، ومعلمات الطلب، وصيغ الاستجابة الخاصة بواجهة API.
استضف مخطط OpenAPI الخاص بك
بعد ذلك، استضف مخطط OpenAPI على خادم يسمح بالوصول العام. يمكنك استخدام مستودع مثل GitHub، أو تخزين سحابي مثل Amazon S3، أو أي خدمة استضافة ويب.
تكامل مع AI Assist
اتبع الخطوات التالية لإعداد التكامل:
3. انقر على "الإضافات" من القائمة العلوية
4. انقر على "الإعدادات" ضمن AI Assist
5. اختر وكيل الذكاء الاصطناعي الخاص بك
6. انقر على "التكامل/API"
7. انقر على "إضافة أداة" تحت قسم API
8. أدخل عنوان URL الخاص بملف مواصفات OpenAPI في خانة Schema File URL. يمكنك الحصول عليه من المستودع أو خدمة التخزين التي تستضيف الملف. تأكد من أن عنوان URL متاح للعامة ويشير بدقة إلى ملف المواصفات.
9. أدخل عنوان API Base URL، وهو العنوان الجذري لواجهة API. يمكنك الحصول عليه من مزود واجهة API. ستُستخدم هذه الوجهة للوصول إلى نقاط النهاية، والطلبات، والاستجابات المحددة في مواصفات OpenAPI الخاصة بك. تأكد من تطابق نقاط النهاية في المواصفات مع نقاط النهاية الحقيقية للواجهة لتجنب الأخطاء.
10. اختر طريقة المصادقة المناسبة لواجهة API. اختر "بدون مصادقة" إذا لم تكن الواجهة تتطلب مصادقة.
إذا اخترت "أساسي"، أدخل اسم المستخدم وكلمة المرور.
10. تحقق من صحة جميع التفاصيل، ثم انقر على "حفظ".
ساعد AI Assist على فهم تكامل API الخاص بك
تستخدم AI Assist مصادر البيانات الخاصة بك، بما في ذلك تكاملات API، للرد على العملاء.
- تأكد من أن مخطط API يحتوي على أوصاف مفصلة لنقاط النهاية والمعلمات المستخدمة في التكامل.
- قم بتحديث الموجه الأساسي في صفحة الإعدادات لتوجيه AI Assist حول متى يجب إجراء طلب API وما المعلومات التي يجب البحث عنها. على سبيل المثال:
- إذا سأل العميل عن حالة الطلب، نفّذ [نداء API] للحصول على المعلومات المناسبة.
من المهم ذكر نداء API تمامًا كما هو معرف في مخطط API الخاص بك.
أمور يجب تذكرها
- بينما يمكن تغيير عنوان API Base URL، لا يمكن تعديل عنوان Schema File URL. إذا قمت بتحديث ملف مخطط OpenAPI وحصلت على عنوان URL جديد، فستحتاج إلى حذف التكامل وإضافته من جديد باستخدام عنوان URL الجديد.
- عندما تحصل AI Assist على معلومات من خلال طلب API، فإنها تعطي الأولوية لهذه المعلومات على باقي مصادر البيانات وتستخدمها لتكوين رد للعملاء. يمكنك تخصيص رد AI Assist باستخدام تعليمات الموجه الأساسي، مثل تحديد نبرة الحديث أو إضافة أزرار يمكن للعملاء النقر عليها.
- كل طلب API له معرف فريد ويُعتبر نقطة بيانات مستقلة. الطلبات التالية لا ترتبط بطلبات واستجابات سابقة. لذا، في كل مرة تُجري فيها AI Assist طلب API، فهي لا تشير إلى أي طلبات أو استجابات سابقة.
- قد يتم اقتطاع المحادثات الطويلة، وقد لا تتمكن AI Assist من الرجوع إلى المعلومات التي ذُكرت في بداية المحادثة.
- اختبر تكاملك من حيث الدقة، والسرعة، والأمان. اتبع أفضل الممارسات لمصادقة API وتشفير البيانات.
- قم بتحسين التكامل لضمان تجربة دردشة سلسة لعملائك. أنشئ تجربة تركز على العميل تعزز الولاء، وتزيد من المبيعات، وتدفع بنمو أعمالك.
- تأكد من أن تكاملك قادر على التعامل مع حجم الدردشات المتزايد مع نمو عملك.
اطلع على هذه الأدلة للحصول على أمثلة حول دمج AI Assist مع واجهات برمجة التطبيقات الأخرى:
كيفية دمج AI Assist مع Shopify
إذا كان لديك ملاحظات حول هذه المقالة، أو إذا كنت بحاجة إلى مزيد من المساعدة:
- اضغط على أيقونة الدردشة المباشرة الخضراء
- حدد موعدًا للاتصال بنا
- زر مجتمعنا