Mobile SDK

플랫폼#

세 개의 네이티브 SDK는 완전히 동일한 공개 API 표면을 공유합니다. 여러분의 앱에 맞는 것을 고르세요:

각 SDK는 WebView가 아니라 실제 네이티브 채팅을 앱 위의 바텀 시트로 렌더링합니다. 앱은 진입점(버튼, 아이콘, 배지)을 그리고 Respondo.open()으로 채팅을 엽니다.

포함된 기능#

모바일 SDK는 웹 위젯의 기능 세트를 그대로 반영합니다:

• 채팅 코어: AI 에이전트, 사람 상담원으로의 실시간 전환, 입력 및 읽음 상태, 파일 첨부.
• 뉴스 피드(“새 소식”)와 온보딩 체크리스트.
• 설문(NPS, CSAT 등).
• 현재 화면에 연결된 페이지 단위 배너와 능동적 티저. 내비게이션 시 Respondo.setCurrentScreen("screen_name")으로 현재 화면을 보고하세요 — 능동적 티저와 페이지 수준 타기팅이 이 값과 대조합니다.
• 상담원 답장과 캠페인에 대한 푸시 알림, 그리고 올바른 대화로 이어지는 딥 링크.

작동 방식#

모든 SDK는 웹 위젯과 동일한 공개 위젯 계약을 따르는 얇은 클라이언트입니다 — 백엔드는 변경 없이 그대로 재사용됩니다. 메시징은 REST와 WebSocket 위에서 동작하며, 전달은 우아하게 단계적으로 낮아지고(WebSocket, 그다음 SSE, 그다음 REST 폴링) 연결이 회복되는 즉시 다시 위로 올라갑니다.

인증은 계층적으로 이루어집니다:

• visitor_id — SDK가 생성하여 기기에 안전하게 저장하는 안정적인 익명 식별자입니다: Android는 Keystore로 암호화된 환경설정에, iOS는 키체인에, Flutter는 init에 전달하는 storageDirectory의 앱 전용 파일에 저장됩니다.
• userHash — 대화를 실제 인물에 결속하는, 여러분 백엔드가 만든 HMAC 서명입니다(신원 확인).
• session-token — 대화별로 발급되며 REST 및 WebSocket 호출에서 다시 사용됩니다.

시작하기#

여러분의 앱에 맞는 플랫폼 페이지 — Android SDK, iOS SDK 또는 Flutter SDK — 로 이동해 설치와 동작하는 초기화를 확인하세요. 그다음 여러 기기에서 로그인한 사용자를 인식하도록 신원 확인을, 오프라인 전달을 위해 푸시 알림을 연결하세요.