Mobile SDK
همان چت پشتیبانی با عامل هوش مصنوعی و کارشناس انسانی را که در وب دارید، داخل اپلیکیشن‌های بومی Android، iOS و Flutter خود راه بیندازید. یک قرارداد backend، یک رفتار، سه پلتفرم.
پلتفرم‌ها#
هر سه SDK بومی سطح API عمومی کاملاً یکسانی دارند. آن یکی را بردارید که با اپلیکیشن شما جور است:
| SDK | پشتهٔ فناوری | حداقل نسخه |
|---|---|---|
| Android | Kotlin، Jetpack Compose | minSdk 24، Kotlin 2.x |
| iOS | Swift، SwiftUI (بدون هیچ وابستگی) | iOS 15+، Swift 5.9+ |
| Flutter | Dart خالص، بدون پل بومی | Dart 3.4+، Flutter 3.16+ |
هر SDK یک چت بومی واقعی را به شکل bottom sheet روی اپلیکیشن شما نمایش می‌دهد — نه WebView. اپلیکیشن شما نقطهٔ ورود را می‌سازد (یک دکمه، یک آیکون، یک نشان) و چت را با Respondo.open() باز می‌کند.
چه چیزی شامل می‌شود#
SDKهای موبایل همان مجموعهٔ قابلیت‌های ویجت وب را بازتاب می‌دهند:
- هستهٔ چت: عامل هوش مصنوعی، ارجاع زندهٔ گفت‌وگو به کارشناس انسانی، وضعیت تایپ و خوانده‌شدن، پیوست فایل.
- خوراک خبری («تازه‌ها») و چک‌لیست‌های شروع کار.
- نظرسنجی‌ها (NPS، CSAT و موارد دیگر).
- بنرهای سطح صفحه و تیزرهای پیش‌دستانه که به صفحهٔ جاری گره خورده‌اند. صفحهٔ جاری را با
Respondo.setCurrentScreen("screen_name")در هر ناوبری گزارش کنید — تیزرهای پیش‌دستانه و هدف‌گیری سطح صفحه با آن تطبیق داده می‌شوند. - نوتیفیکیشن پوش برای پاسخ کارشناسان و کمپین‌ها، همراه با دیپ‌لینک به همان گفت‌وگوی درست.
چطور کار می‌کند#
هر SDK یک کلاینت سبک روی همان قرارداد عمومی ویجت است که ویجت وب از آن استفاده می‌کند — backend بدون هیچ تغییری بازاستفاده می‌شود. پیام‌رسانی روی REST به‌همراه یک WebSocket کار می‌کند و تحویل پیام به‌نرمی پایین می‌آید (WebSocket، سپس SSE، سپس پولینگ REST) و همان لحظه که اتصال برمی‌گردد، دوباره بالا می‌رود.
مجوزدهی لایه‌لایه است:
- visitor_id — یک شناسهٔ ناشناس پایدار که SDK می‌سازد و امن روی دستگاه نگه می‌دارد: preferences رمزگذاری‌شده با Android Keystore، کی‌چین iOS، و در Flutter فایلی خصوصیِ اپ در
storageDirectoryای که به init می‌دهید. - userHash — امضای HMAC از سمت backend شما که یک گفت‌وگو را به یک شخص واقعی گره می‌زند (تأیید هویت).
- session-token — برای هر گفت‌وگو صادر می‌شود و در فراخوانی‌های REST و WebSocket دوباره فرستاده می‌شود.
از کجا شروع کنیم#
به صفحهٔ پلتفرمی بروید که با اپلیکیشن شما جور است — Android SDK، iOS SDK یا Flutter SDK — تا نصب و یک راه‌اندازی کارآمد را ببینید. بعد تأیید هویت را وصل کنید تا کاربران واردشده را روی دستگاه‌های مختلف بشناسید، و نوتیفیکیشن‌های پوش را برای تحویل در حالت آفلاین.
ai.respondo:respondo-sdk)، iOS از طریق Swift Package Manager از github.com/respondo-app/sdk-ios، و Flutter از pub.dev (respondo_sdk). سورس‌های Android و iOS روی GitHub عمومی هستند.