كيف تضيف دردشة بالذكاء الاصطناعي إلى تطبيق React Native

ثبّت SDK Sell Whisper AI لـReact Native، وأنشئ عميلاً (client) بمعرّف الأداة، واعرض شاشة الدردشة في تطبيقك على iOS وAndroid.

الخطوات

نفّذها بالترتيب

  1. ثبّت الحزم

    أضف @sellwhisper/chat-client و@sellwhisper/react-native من npm. يدعم SDK الإصدار React Native 0.73 أو أحدث، وExpo SDK 53 أو أحدث، وiOS 15.1 أو أحدث، وAndroid API level 24 أو أحدث.

  2. انسخ معرّف الأداة

    في لوحة التحكم، افتح الوكيل، وانتقل إلى النشر (Deploy) وافتح أداة الدردشة الخاصة بالوكيل. معرّف الأداة (Widget ID) في إعداداتها هو نفسه الذي يستخدمه تضمين الموقع، فيتشارك التطبيق الوكيل نفسه وإعدادات الأداة نفسها.

  3. أنشئ العميل وغلّف تطبيقك

    أنشئ SellWhisperClient بمعرّف الأداة (Widget ID) ومحوّل تخزين مثل AsyncStorage لتبقى المحادثات محفوظة بين مرات التشغيل، ثم غلّف تطبيقك بـSellWhisperProvider.

  4. اعرض شاشة الدردشة

    أضف SellWhisperChatScreen حيث ينبغي أن تظهر الدردشة. تفعّل خصائصه (props) الترويسة وسجل المحادثات والمرفقات والملاحظات الصوتية؛ وتتطلب المرفقات والملاحظات الصوتية تثبيت حزمتَي منتقي الملفات والصوت الاختياريتين.

حزمتان

الحزمةتُستخدم لـ
@sellwhisper/chat-clientالعميل بلا واجهة (headless): المحادثات والرسائل والأحداث، دون اعتماد على React Native
@sellwhisper/react-nativeالمزوّد (provider) والخطافات (hooks) وشاشة الدردشة الجاهزة لـReact Native وExpo

ثبّت الحزمتين للحصول على الشاشة الجاهزة. وثبّت العميل وحده لبناء واجهتك الخاصة.

ما يتشاركه التطبيق مع موقعك

يتصل التطبيق بمعرّف الأداة (Widget ID) نفسه الذي يستخدمه تضمين موقعك. وهذا يعني وكيلًا واحدًا وقاعدة معرفة واحدة ومجموعة واحدة من قواعد التصعيد، وأن أي تغيير في معرفة الوكيل أو تعليماته يصل إلى التطبيق دون إصدار جديد.

الميزات الاختيارية وما تحتاج إليه

الميزةتحتاج إلى
سجل المحادثات بين مرات التشغيلمحوّل تخزين مثل AsyncStorage
المرفقاتحزمة لاختيار الصور أو المستندات
الملاحظات الصوتيةحزمة لتسجيل الصوت
المساعد الصوتيحزمة صوت ونسخة تطوير (development build)؛ ولا يعمل في Expo Go
الإشعارات الفوريةإعداد الإشعارات الفورية في تطبيقك، وتسجيل الجهاز لدى SDK

قبل الإصدار

  1. اختبر على جهاز. شغّل نسختك على جهاز iOS وجهاز Android حقيقيين، لا في المحاكي فقط.
  2. أضف المعرفة أولًا. فائدة الشاشة من فائدة الوكيل الذي يقف خلفها. اطّلع على كيف تدرّب وكيل ذكاء اصطناعي على موقعك.
  3. اضبط التصعيد. الدردشة المباشرة مع فريقك تعمل في التطبيق؛ حدّد متى تبدأ بالاستعانة بدليل كيف تحيل محادثات الذكاء الاصطناعي إلى موظف بشري.

تجد أوامر التثبيت وخصائص المكوّنات (props) ومثالًا كاملًا في React Native SDK.

الأسئلة الشائعة

أسئلة شائعة

هل يعمل SDK مع Expo؟
نعم، بدءاً من Expo SDK 53. يحتاج المساعد الصوتي إلى نسخة تطوير (development build) لا إلى Expo Go.
هل يمكنني بناء واجهة دردشة خاصة بي؟
نعم. @sellwhisper/chat-client عميل بلا واجهة (headless) لا يعتمد على React Native، فيمكنك تشغيل مكوّناتك الخاصة به.
هل يعمل التصعيد إلى شخص في التطبيق؟
نعم. تستمر المحادثة المصعَّدة كدردشة مباشرة مع فريقك على الشاشة نفسها. وللوصول إلى المستخدمين والتطبيق في الخلفية، أعدّ الإشعارات الفورية (push notifications) في تطبيقك وسجّل الجهاز لدى SDK.

توثيق ذو صلة

ابدأ الآن

طبّق هذه الخطوات

ابدأ مجاناً، دون الحاجة إلى بطاقة ائتمان.