통합 만들기

모바일 채팅 SDK

고객용 iOS, Android, React Native 앱에 Sonny 지원 채팅을 추가하세요. 고객은 앱 안에서 바로 팀에 연락하고, 팀은 기존 Sonny 받은편지함에서 응대해요.

고객 지원 팀이 답장할 때 쓰는 앱을 찾으시나요? Sonny 상담원 앱 설치하기.

SDK 선택

앱 연결하기

  1. 모바일이 활성화된 Sonny 환경에서 채널 → 실시간 채팅 → 모바일 앱을 여세요. 소유자나 관리자가 플랫폼과 번들 또는 애플리케이션 ID마다 앱 키를 만들어요.
  2. 저장소 README를 따라 SDK를 설치하세요. 사이트 ID와 해당 빌드 대상의 공개 앱 키로 구성하세요. React Native는 iOS와 Android 앱 키가 각각 필요해요.
  3. 채팅을 전체 화면 대화로 보여 주거나 앱에 삽입하세요. 활성 채팅 화면은 한 번에 하나만 유지하세요.
  4. 로그인한 고객의 경우 서버에서 신원 JWT를 만들어 SDK에 전달하세요. 로그아웃할 때 reset()을 호출해 새 방문자 세션을 시작하세요.

앱 키는 공개 식별자예요. 신원 서명 비밀 키와 알림 제공업체 키는 서버나 Sonny의 보호된 설정에 보관돼요.

푸시 알림

알림 권한과 토큰 발급은 앱이 담당해요. SDK는 iOS에서는 APNs 토큰, Android에서는 FCM 토큰을 받아 Sonny 알림 탭을 처리해요. 전송에는 내 앱의 자격 증명이 필요해요. APNs 서명 키와 Apple 팀/키 ID, 또는 Firebase 프로젝트의 FCM 서비스 계정이에요. Sonny 상담원 앱의 자격 증명은 별도 앱의 것이에요. 이번 프리뷰 기간에는 푸시 전송을 아직 검증 중이에요.

  1. 모바일 앱에서 앱의 제공업체 자격 증명을 업로드하세요. APNs는 빌드에 맞게 sandbox 또는 production 환경을 맞추세요.
  2. 앱을 열고 알림을 허용한 뒤 토큰을 SDK에 전달하세요. 설정의 기기 목록을 새로고침하고 등록 시간으로 테스트 기기를 선택하세요.
  3. 앱을 백그라운드로 보내고 테스트 푸시 보내기를 선택하세요. 기기에서 수신을 확인하세요. 설정 상태에는 제공업체의 수락 여부나 안전한 오류 코드가 표시되며, 수락만으로 도착이 확인되는 건 아니에요.
  4. 대화 테스트는 방문자 연결이 끊긴 상태에서 상담원이나 AI 답장을 보내 확인하세요. 앱이 탭을 handlePush로 전달하면 답장 알림이 해당 대화를 열어요. 일반 테스트 알림은 대화를 열지 않아요.

이슈 신고 또는 기여

사용하는 SDK의 저장소에 이슈를 열어 주세요. 버전이나 커밋, OS와 프레임워크 버전, 간단한 재현 방법을 포함하세요. 각 저장소는 풀 리퀘스트를 받으며 기여 및 보안 신고 안내가 있어요. 고객 데이터, 신원 JWT, 기기 토큰, 비공개 키는 공개 이슈에 올리지 마세요.

관련 문서