תיעוד

Mobile SDK

הפעילו את אותו צ׳אט תמיכה משולב AI ובני-אדם שאתם מריצים באתר גם בתוך אפליקציות ה-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 לנייד משקפות את מערך הפיצ׳רים של וידג׳ט האתר:

  • ליבת הצ׳אט: סוכן AI, העברה חיה לנציגים אנושיים, מצב הקלדה וקריאה, קבצים מצורפים.
  • פיד חדשות ("מה חדש") ורשימות משימות לקליטה (onboarding).
  • סקרים (NPS, CSAT ועוד).
  • באנרים ברמת העמוד וטיזרים יזומים הקשורים למסך הנוכחי. דווחו על המסך הנוכחי עם Respondo.setCurrentScreen("screen_name") בעת ניווט — טיזרים יזומים ומיקוד ברמת העמוד מתאימים מולו.
  • התראות דחיפה על תשובות נציגים וקמפיינים, עם קישורים עמוקים אל השיחה הנכונה.
סיורי מוצר (product tours) והסברים קופצים (tooltips) הם משטחים ייעודיים לאתר בלבד ואינם מועברים אל ערכות ה-SDK לנייד.

איך זה עובד#

כל SDK הוא לקוח דק לאותו חוזה וידג׳ט ציבורי כמו וידג׳ט האתר — ה-backend נעשה בו שימוש חוזר ללא שינוי. ההודעות רצות מעל REST בתוספת WebSocket, וההעברה נסוגה בהדרגה בחן (WebSocket, אחר כך SSE, ואז REST polling) ומטפסת חזרה למעלה ברגע שהחיבור מתאושש.

ההרשאה בנויה בשכבות:

  • visitor_id — מזהה אנונימי יציב שה-SDK מייצר ושומר באופן מאובטח על המכשיר: העדפות מוצפנות ב-Keystore ב-Android, ה-keychain ב-iOS, וב-Flutter קובץ פרטי לאפליקציה ב- storageDirectory שאתם מעבירים ל-init.
  • userHash — חתימת HMAC מה-backend שלכם שקושרת שיחה לאדם אמיתי (אימות זהות).
  • session-token — מונפק לכל שיחה ומשוחזר בקריאות REST ו-WebSocket.

תחילת עבודה#

עברו לעמוד הפלטפורמה שמתאים לאפליקציה שלכם — Android SDK, iOS SDK או Flutter SDK — להתקנה ולאתחול עובד. לאחר מכן חברו את אימות הזהות כדי לזהות משתמשים מחוברים בין מכשירים, ואת התראות הדחיפה להעברה במצב לא-מקוון.

כל SDK מותקן מהרשם (registry) של הפלטפורמה שלו: 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.