دستاویزات

Mobile SDK

جو AI اور انسانی سپورٹ والا چیٹ آپ ویب پر چلاتے ہیں، بالکل وہی اپنی نیٹو Android، iOS اور Flutter ایپس کے اندر بھی دیں۔ ایک ہی backend کنٹریکٹ، ایک ہی طرزِ عمل، تین پلیٹ فارم۔

پلیٹ فارمز#

تینوں نیٹو SDK کی پبلک API سطح بالکل ایک جیسی ہے۔ جو آپ کی ایپ سے میل کھاتا ہو، وہ منتخب کریں:

SDKاسٹیککم از کم
AndroidKotlin، Jetpack ComposeminSdk 24، Kotlin 2.x
iOSSwift، SwiftUI (کوئی ڈیپینڈنسی نہیں)iOS 15+، Swift 5.9+
Flutterخالص Dart، کوئی نیٹو برج نہیںDart 3.4+، Flutter 3.16+

ہر SDK آپ کی ایپ کے اوپر ایک اصل نیٹو چیٹ کو نیچے سے کھلنے والی شیٹ (bottom sheet) کی شکل میں دکھاتا ہے — WebView نہیں۔ داخلے کا مقام (بٹن، آئیکن، بیج) آپ کی ایپ خود بناتی ہے اور چیٹ اس طرح کھولتی ہے: Respondo.open()۔

کیا کیا شامل ہے#

موبائل SDK ویب ویجٹ کی خصوصیات کا وہی سیٹ دہراتے ہیں:

  • چیٹ کا بنیادی حصہ: AI ایجنٹ، انسانی نمائندوں کو براہِ راست منتقلی، ٹائپنگ اور پڑھے جانے کی حالت، فائل منسلکات۔
  • نیوز فیڈ (“کیا نیا ہے”) اور شروعاتی چیک لسٹ۔
  • سروے (NPS، CSAT اور دیگر)۔
  • صفحے کی سطح کے بینر اور موجودہ اسکرین سے جڑے پیش قدمی والے ٹیزر۔ نیویگیشن پر موجودہ اسکرین Respondo.setCurrentScreen("screen_name") سے رپورٹ کریں — پیش قدمی والے ٹیزر اور صفحے کی سطح کی ٹارگٹنگ اسی سے مطابقت کرتی ہے۔
  • نمائندوں کے جوابات اور مہمات کے لیے پش نوٹیفکیشنز، جو ڈیپ لنک کے ذریعے ٹھیک اُسی گفتگو تک لے جاتے ہیں۔
پروڈکٹ ٹور اور ٹول ٹپ صرف ویب کی سطحیں ہیں، اور موبائل SDK میں منتقل نہیں کی جاتیں۔

یہ کیسے کام کرتا ہے#

ہر SDK اُسی پبلک ویجٹ کنٹریکٹ کا ایک ہلکا کلائنٹ ہے جو ویب ویجٹ استعمال کرتا ہے — backend بغیر کسی تبدیلی کے دوبارہ استعمال ہوتا ہے۔ پیغام رسانی REST اور ایک WebSocket پر چلتی ہے، اور ترسیل بتدریج نیچے اترتی ہے (WebSocket، پھر SSE، پھر REST پولنگ) اور کنکشن بحال ہوتے ہی واپس اوپر چڑھ جاتی ہے۔

اجازت کئی تہوں میں دی جاتی ہے:

  • visitor_id — ایک مستقل گمنام شناخت، جو SDK خود بناتا ہے اور ڈیوائس پر محفوظ طریقے سے رکھتا ہے: Android پر Keystore سے انکرپٹ شدہ preferences، iOS پر keychain، اور Flutter پر init کو دی گئی storageDirectory میں ایپ کی نجی فائل۔
  • userHash — آپ کے backend کا بنایا ہوا HMAC دستخط، جو گفتگو کو ایک حقیقی شخص سے جوڑ دیتا ہے (شناخت کی تصدیق)۔
  • session-token — ہر گفتگو کے لیے الگ جاری ہوتا ہے اور REST اور WebSocket کالوں کے ساتھ دوبارہ بھیجا جاتا ہے۔

کہاں سے شروع کریں#

انسٹالیشن اور چلتے ہوئے init کے لیے اُس پلیٹ فارم کے صفحے پر جائیں جو آپ کی ایپ سے میل کھاتا ہے — 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 پر عوامی ہیں۔