카테고리
SDK - Android
시작하기
채널톡 안드로이드 SDK(이하 SDK)는 코틀린/자바로 작성된 애플리케이션에 상담을 위한 채팅 모듈과 마케팅 기능을 쉽게 설치할 수 있도록 도와줍니다. 웹뷰 안이나 모바일 웹에 설치하고자 하는 경우는 JavaScript SDK 설치 가이드를 참고합니다. 설치하기 앞서 아래와 같은 조건을 만족했는지 확인합니다: - 채널톡 유료 플랜 - 구독 및 결제 페이지에서 현재 플랜을 확인할 수 있습니다. - 최소 설치 가능 안드로이드 SDK ≥ 15 - 동작에 필요한 안드로이드 API 레벨은 21로, API 레벨이 15~20인 경우 기능을 이용할 수 없습니다. - 권장 Android Gradle Plugin ≥ 8.0.0 - sourceCompatibility, targetCompatibility ≥ 1.8 - SDK가 사용하는 Kotlin 버전은 1.8.22입니다. 이보다 낮은 버전을 사용하고 있을 경우 Gradle dependency resolution과 관련한 이슈가 발생할 수 있습니다.
커스터마이징
채널 버튼 커스터마이징 하기 채널 설정 > 일반 설정 > 버튼 설치 및 설정 > 웹 버튼 설정 섹션의 채널톡 버튼 설정은 JavaScript SDK에서만 적용됩니다. 안드로이드 SDK에서 채널 버튼을 커스터마이징 하려면 BootConfig로 설정하거나 직접 뷰를 만들어야 합니다. 버튼 위치 옮기기 기본적으로 채널톡 버튼은 화면의 오른쪽 하단에 배치됩니다. 앱의 UI상 다른 곳에 배치해야 하는 경우 부트할 때 BootConfig#setChannelButtonOption(ChannelButtonOption)으로 설정할 수 있습니다. 버튼이 오른쪽과 왼쪽 중 어느 쪽에 위치할지 설정하거나 DP 단위로 여백을 설정할 수 있습니다. val config = BootConfig.create(PLUGIN_KEY) .setChannelButtonOption(ChannelButtonOption(ChannelButtonPosition.RIGHT, 16, 16)) // X축/Y축 각각 16dp 떨어짐 커
푸시 알림
채널톡 안드로이드 SDK는 Firebase Cloud Messaging(FCM)을 통해서 고객이 오프라인일 때 상담 답변 알림을 받을 수 있도록 설정할 수 있습니다. SDK 설치하기를 완료한 이후 아래 단계를 따릅니다. Android API level 33(Tiramisu) 이상에서 시스템 푸시 알림을 표시하고자 하는 경우 POST_NOTIFICATIONS 권한이 필요합니다. 채널톡 안드로이드 SDK는 직접 POST_NOTIFICATIONS 권한을 요청하지 않으므로 앱에 해당 권한이 있는지 확인해야 합니다. 자세한 사항은 알림에 관한 안드로이드 공식 문서를 확인합니다. Firebase 연동 설정 Firebase 프로젝트 생성하기 1. Firebase 설치 가이드에 따라 안드로이드 앱 프로젝트를 설정합니다. 2. google-service.json 파일을 다운로드 받아서 앱 모듈 단위의 최상위 디렉토리에 복사합니다. Firebase와 SDK 연동하기 프로젝트에서 Firebase를 처음
API Reference
API Reference4개의 아티클