दस्तावेज़

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 आपके ऐप के ऊपर एक असली नेटिव चैट को बॉटम शीट के रूप में रेंडर करता है — WebView नहीं। आपका ऐप एंट्री पॉइंट (एक बटन, एक आइकन, एक बैज) बनाता है और चैट खोलता है Respondo.open() से।

इसमें क्या शामिल है#

मोबाइल SDK वेब विजेट के फ़ीचर सेट को दोहराते हैं:

  • चैट कोर: AI एजेंट, इंसानी ऑपरेटरों को लाइव हैंडऑफ़, टाइपिंग और रीड स्टेट, फ़ाइल अटैचमेंट।
  • न्यूज़ फ़ीड ("What's new") और ऑनबोर्डिंग चेकलिस्ट।
  • सर्वे (NPS, CSAT, और अन्य)।
  • पेज-स्तरीय बैनर और मौजूदा स्क्रीन से जुड़े प्रोऐक्टिव टीज़र। नेविगेशन पर मौजूदा स्क्रीन Respondo.setCurrentScreen("screen_name") से रिपोर्ट करें — प्रोऐक्टिव टीज़र और पेज-स्तरीय टारगेटिंग उससे मैच करते हैं।
  • ऑपरेटर के जवाबों और कैम्पेन के लिए पुश नोटिफ़िकेशन, सही बातचीत में सीधे ले जाने वाले डीप लिंक के साथ।
प्रोडक्ट टूर और टूलटिप केवल वेब की सतहें हैं और इन्हें मोबाइल SDK में नहीं लाया गया है।

यह कैसे काम करता है#

हर SDK उसी पब्लिक विजेट कॉन्ट्रैक्ट के लिए एक थिन क्लाइंट है जो वेब विजेट के पास है — backend को बिना बदले दोबारा इस्तेमाल किया जाता है। मैसेजिंग REST और एक WebSocket पर चलती है, और डिलीवरी सहजता से फ़ॉलबैक करती है (WebSocket, फिर SSE, फिर REST पोलिंग) और कनेक्शन बहाल होते ही वापस ऊपर चढ़ जाती है।

ऑथराइज़ेशन परतों में है:

  • visitor_id — एक स्थिर एनॉनिमस id जिसे SDK जनरेट करता है और डिवाइस पर सुरक्षित रूप से सहेजता है: Android Keystore-एन्क्रिप्टेड preferences, iOS keychain, और Flutter पर init में पास की गई storageDirectory की एक ऐप-निजी फ़ाइल।
  • userHash — आपके backend से एक HMAC सिग्नेचर जो किसी बातचीत को असली व्यक्ति से बाँधता है (पहचान सत्यापन)।
  • session-token — हर बातचीत के लिए जारी किया जाता है और REST तथा WebSocket कॉल पर दोबारा भेजा जाता है।

शुरू करें#

अपने ऐप से मेल खाने वाले प्लेटफ़ॉर्म पेज पर जाएँ — Android SDK, iOS SDK, या Flutter SDK — इंस्टॉल और चलने वाले init के लिए। फिर डिवाइसों में साइन-इन किए हुए यूज़र्स को पहचानने के लिए पहचान सत्यापन जोड़ें, और ऑफ़लाइन डिलीवरी के लिए पुश नोटिफ़िकेशन।

हर 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 पर पब्लिक हैं।