التوثيق

Mobile SDK

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

المنصات#

تتشارك ثلاث حزم SDK أصلية سطح واجهة برمجية عامة متطابقاً. اختر الحزمة التي تناسب تطبيقك:

SDKالتقنيةالحد الأدنى
AndroidKotlin، Jetpack ComposeminSdk 24، Kotlin 2.x
iOSSwift، SwiftUI (بدون تبعيات)iOS 15+، Swift 5.9+
FlutterDart خالص، بدون جسور أصليةDart 3.4+، Flutter 3.16+

تعرض كل حزمة SDK محادثة أصلية حقيقية على هيئة ورقة سفلية فوق تطبيقك — وليست WebView. يرسم تطبيقك نقطة الدخول (زر أو أيقونة أو شارة) ويفتح المحادثة عبر Respondo.open().

ما المتضمَّن#

تعكس حزم SDK للجوال مجموعة ميزات أداة الويب:

  • نواة المحادثة: وكيل ذكاء اصطناعي، وتحويل مباشر إلى موظفي دعم بشريين، وحالة الكتابة والقراءة، ومرفقات الملفات.
  • موجز الأخبار («ما الجديد») وقوائم مراجعة الإعداد الأولي.
  • الاستبيانات (NPS وCSAT وغيرها).
  • لافتات على مستوى الصفحة وعروض تشويقية استباقية مرتبطة بالشاشة الحالية. أبلغ عن الشاشة الحالية عبر Respondo.setCurrentScreen("screen_name") عند التنقّل — تطابق العروض التشويقية الاستباقية والاستهداف على مستوى الصفحة معها.
  • إشعارات فورية لردود موظفي الدعم والحملات، مع روابط عميقة إلى المحادثة الصحيحة.
جولات المنتج والتلميحات هي أسطح خاصة بالويب فقط ولا تُنقل إلى حزم SDK للجوال.

كيف يعمل#

كل حزمة SDK هي عميل رفيع لنفس عقد الأداة العام الذي تستخدمه أداة الويب — إذ يُعاد استخدام الخلفية دون تغيير. تعمل المراسلة عبر REST إضافة إلى WebSocket، ويتراجع التسليم بسلاسة (WebSocket ثم SSE ثم اقتراع REST) ويعود صعوداً لحظة استعادة الاتصال.

التفويض متعدد الطبقات:

  • visitor_id — معرّف مجهول ثابت تولّده حزمة SDK وتخزّنه بأمان على الجهاز: تفضيلات مشفَّرة بـ Android Keystore، وسلسلة مفاتيح iOS، وعلى Flutter ملف خاص بالتطبيق في storageDirectory الذي تمرّره إلى init.
  • userHash — توقيع HMAC من خلفيتك يربط محادثة بشخص حقيقي (التحقق من الهوية).
  • session-token — يُصدَر لكل محادثة ويُعاد إرساله في نداءات REST وWebSocket.

البدء#

توجّه إلى صفحة المنصة التي تناسب تطبيقك — Android SDK أو iOS SDK أو Flutter SDK — للحصول على التثبيت وتهيئة عاملة. ثم اربط التحقق من الهوية للتعرّف على المستخدمين المسجّلين عبر الأجهزة، والإشعارات الفورية للتسليم دون اتصال.

تُثبَّت كل حزمة SDK من سِجل منصتها: Android من Maven Central (ai.respondo:respondo-sdk)، وiOS عبر Swift Package Manager من github.com/respondo-app/sdk-ios، وFlutter من pub.dev (respondo_sdk). ومصادر Android وiOS متاحة للعموم على GitHub.