مستندات

Mobile SDK

همان چت پشتیبانی با عامل هوش مصنوعی و کارشناس انسانی را که در وب دارید، داخل اپلیکیشن‌های بومی Android، iOS و Flutter خود راه بیندازید. یک قرارداد backend، یک رفتار، سه پلتفرم.

پلتفرم‌ها

هر سه SDK بومی سطح API عمومی کاملاً یکسانی دارند. آن یکی را بردارید که با اپلیکیشن شما جور است:

SDKپشتهٔ فناوریحداقل نسخه
AndroidKotlin، Jetpack ComposeminSdk 24، Kotlin 2.x
iOSSwift، SwiftUI (بدون هیچ وابستگی)iOS 15+، Swift 5.9+
FlutterDart خالص، بدون پل بومیDart 3.4+، Flutter 3.16+

هر SDK یک چت بومی واقعی را به شکل bottom sheet روی اپلیکیشن شما نمایش می‌دهد — نه WebView. اپلیکیشن شما نقطهٔ ورود را می‌سازد (یک دکمه، یک آیکون، یک نشان) و چت را با Respondo.open() باز می‌کند.

چه چیزی شامل می‌شود

SDKهای موبایل همان مجموعهٔ قابلیت‌های ویجت وب را بازتاب می‌دهند:

  • هستهٔ چت: عامل هوش مصنوعی، ارجاع زندهٔ گفت‌وگو به کارشناس انسانی، وضعیت تایپ و خوانده‌شدن، پیوست فایل.
  • خوراک خبری («تازه‌ها») و چک‌لیست‌های شروع کار.
  • نظرسنجی‌ها (NPS، CSAT و موارد دیگر).
  • بنرهای سطح صفحه و تیزرهای پیش‌دستانه که به صفحهٔ جاری گره خورده‌اند. صفحهٔ جاری را با Respondo.setCurrentScreen("screen_name") در هر ناوبری گزارش کنید — تیزرهای پیش‌دستانه و هدف‌گیری سطح صفحه با آن تطبیق داده می‌شوند.
  • نوتیفیکیشن پوش برای پاسخ کارشناسان و کمپین‌ها، همراه با دیپ‌لینک به همان گفت‌وگوی درست.
تورهای محصول و تولتیپ‌ها فقط سطوح وب هستند و به SDKهای موبایل منتقل نمی‌شوند.

چطور کار می‌کند

هر 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 — تا نصب و یک راه‌اندازی کارآمد را ببینید. بعد تأیید هویت را وصل کنید تا کاربران واردشده را روی دستگاه‌های مختلف بشناسید، و نوتیفیکیشن‌های پوش را برای تحویل در حالت آفلاین.

هر 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 عمومی هستند.