Android SDK를 채팅에 통합하는 방법

사전 요구 사항

• 채팅 SDK 클라이언트는 Android 4.1 이상을 실행하는 장치가 필요합니다.
• 채팅 SDK는 appcompat-v7 r24.2 이상을 사용하는 Android 버전 7.0을 타겟으로 하는 앱을 지원합니다.

AppId와 AppKey 얻기

계정 소유자/관리자로 채팅 계정에 로그인합니다. 관리자 설정 > 채널 > 채팅 및 메시징 > 모바일 SDK로 이동합니다.

1. 프로젝트에 채팅 SDK 추가

1. i) 루트 build.gradle (project/build.gradle)에 maven URL을 추가합니다.

   
   allprojects {
       repositories {
           jcenter()
           maven { url "https://jitpack.io" }
       }
   }
           

2. ii) 앱 모듈의 build.gradle 파일 (project/app/build.gradle)에 다음 종속성을 추가합니다:

   
   apply plugin: 'com.android.application'
   android {
       // ...
   }
   dependencies {
       // ...
       implementation 'com.github.freshdesk:freshchat-android:{{latest-version}}'
   }
           

   {{latest-version}}을 여기에서 최신 버전의 SDK로 교체합니다. 예: implementation 'com.github.freshdesk:freshchat-android:2.6.1'

3. iii) 앱이 Android 7.0+을 타겟으로 하고 이미지 첨부가 활성화된 경우, FileProvider를 구성해야 합니다. AndroidManifest.xml에 다음과 같이 제공자를 포함합니다.

   
   AndroidManifest.xml
   
       
   
   
   Strings.xml
   com.example.demoapp.provider
           

2. SDK 초기화

채팅 SDK의 다른 기능을 호출/사용하기 전에 Freshchat.init()을 앱 ID와 앱 키로 호출합니다.

앱의 런처/지원 액티비티의 onCreate() 함수에서 init()을 호출하는 것을 강력히 권장합니다. 채팅 SDK는 init() 중에 구성 요소의 존재 여부를 확인하며, 구성 요소가 누락되었거나 매니페스트 항목이 누락된 경우 경고합니다.

다음 코드 스니펫에서 YOUR-APP-ID와 YOUR-APP-KEY를 실제 앱 ID와 앱 키로 교체합니다.

FreshchatConfig config = new FreshchatConfig("YOUR-APP-ID","YOUR-APP-KEY");
Freshchat.getInstance(getApplicationContext()).init(config);

참고: Freshchat 계정이 Freshchat US 서버의 일부가 아닌 경우, 서버 위치에 따라 도메인을 지정해야 합니다. 계정의 서버 위치를 알아보려면 지원 팀에 문의하세요.

다음은 서버 위치에 따른 도메인 매핑 세부 정보입니다.

• US2 - "https://msdk.us2.freshchat.com"
• EU - "https://msdk.eu.freshchat.com"
• AU - "https://msdk.au.freshchat.com"
• IN - "https://msdk.in.freshchat.com"

샘플 코드:

freshchatConfig.setDomain("msdk.in.freshchat.com");

2.1 초기화 구성 옵션

초기화 전에 구성에서 카메라 캡처와 같은 기능을 활성화 또는 비활성화할 수 있습니다.

FreshchatConfig config = new FreshchatConfig("YOUR-APP-ID","YOUR-APP-KEY");
config.setCameraCaptureEnabled(true);
config.setGallerySelectionEnabled(true);
config.setResponseExpectationEnabled(true);
Freshchat.getInstance(getApplicationContext()).init(config);

3. 사용자 정보

3.1 사용자 정보 업데이트

지원 에이전트가 사용자와 메시지를 주고받을 때 사용자에 대한 더 많은 컨텍스트를 제공하기 위해 언제든지 기본 사용자 정보를 보낼 수 있습니다.

// 현재 설치에 대한 사용자 객체 가져오기
FreshchatUser freshchatUser = Freshchat.getInstance(getApplicationContext()).getUser();
freshchatUser.setFirstName("John");
freshchatUser.setLastName("Doe");
freshchatUser.setEmail("john.doe.1982@mail.com");
freshchatUser.setPhone("+91", "9790987495");

// 사용자 정보를 Freshchat 서버와 동기화하기 위해 setUser 호출
Freshchat.getInstance(getApplicationContext()).setUser(freshchatUser);

3.2 사용자 속성(메타 데이터) 업데이트

앱 내 사용자 및 이벤트에 대한 추가 메타데이터를 캡처하고 보낼 수 있으며, 이를 통해 사용자를 세분화하여 나중에 메시지를 푸시할 수 있습니다.

/* 에이전트에게 더 많은 컨텍스트를 제공하고, 마케팅 또는 사전 메시징을 위한 세분화를 위해 사용자 정의 메타데이터 설정 */
Map userMeta = new HashMap();
userMeta.put("userLoginType", "Facebook");
userMeta.put("city", "SpringField");
userMeta.put("age", "22");
userMeta.put("userType", "premium");
userMeta.put("numTransactions", "5");
userMeta.put("usedWishlistFeature", "yes");

// 사용자 속성을 채팅 서버와 동기화하기 위해 setUserProperties 호출
Freshchat.getInstance(getApplicationContext()).setUserProperties(userMeta);

3.3 타임라인에 사용자 이벤트 기록 (버전 3.1.0부터 사용 가능)

사용자 이벤트를 추적하면 애플리케이션 내 사용자에 대한 더 많은 통찰력과 컨텍스트를 제공합니다. 사용자 행동, 실패/오류 사례와 같은 이벤트는 이 API를 사용하여 추적할 수 있습니다. 추적된 이벤트는 에이전트 측의 이벤트 타임라인에 나열됩니다.

String eventName = "Visited Order Details page";

// 아래와 같이 필요한 속성을 설정하여 맵 생성
HashMap