ডকুমেন্টেশন

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 এজেন্ট, মানুষ-অপারেটরের কাছে সরাসরি হস্তান্তর, টাইপিং ও পড়ার অবস্থা, ফাইল সংযুক্তি।
  • খবরের ফিড ("What's new") ও শুরু করার চেকলিস্ট।
  • জরিপ (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 কলে বারবার পাঠানো হয়।

শুরু করুন#

আপনার অ্যাপের সঙ্গে যে প্ল্যাটফর্ম মেলে তার পৃষ্ঠায় যান — 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-এ উন্মুক্ত।