Freshchat 안드로이드 SDK 통합 단계

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

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

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

앱의 사용자 및 이벤트에 대한 추가 메타데이터를 캡처하고 보낼 수 있으며, 이는 나중에 메시지를 푸시하기 위해 사용자를 세분화하는 방법이 됩니다. 

/* 상담원에게 더 많은 컨텍스트를 제공하고 마케팅 또는 사전 메시지를 위한 세분화를 위해 사용자 정의 메타데이터를 설정합니다. */
Map<String, String> userMeta = new HashMap<String, String>();
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 서버와 동기화합니다.
Freshchat.getInstance(getApplicationContext()).setUserProperties(userMeta);

String eventName = "주문 세부 정보 페이지 방문";

// 아래와 같이 맵을 생성하고 필요한 속성을 설정합니다.  
HashMap<String, Object> properties = new HashMap<>();
properties.put("주문 ID", 3223232332);
properties.put("주문 날짜", "2020년 1월 24일");
properties.put("주문 상태", "배송 중");

// eventName과 속성 맵을 전달하여 trackEvent를 호출합니다.
Freshchat.trackEvent(getContext(), eventName, properties);

Freshchat.resetUser(getApplicationContext());

Freshchat.getInstance(getApplicationContext()).identifyUser(externalId, null);

복원 ID 검색

String restoreId = Freshchat.getInstance(getApplicationContext()).getUser().getRestoreId();
saveRestoreIdForUser(restoreId);

Freshchat.getInstance(getApplicationContext()).identifyUser(externalId, restoreId);

복원 ID 생성 이벤트 수신

복원 ID 생성은 비동기 프로세스입니다. 따라서 복원 ID가 생성될 때 알림을 받기 위해 브로드캐스트 수신기를 등록해야 합니다. 이 수신기는 애플리케이션 클래스의 onCreate에서 등록하고 onTerminate에서 등록 해제할 수 있습니다.

브로드캐스트 수신기 등록

IntentFilter intentFilter = new IntentFilter(Freshchat.FRESHCHAT_USER_RESTORE_ID_GENERATED);
LocalBroadcastManager.getInstance(getApplicationContext()).registerReceiver(broadcastReceiver, intentFilter);

브로드캐스트 수신기 수신

BroadcastReceiver broadcastReceiver = new BroadcastReceiver() {
  @Override
  public void onReceive(Context context, Intent intent) {
     String restoreId = Freshchat.getInstance(getApplicationContext()).getUser().getRestoreId();
  }
};

LocalBroadcastManager.getInstance(getApplicationContext()).unregisterReceiver(broadcastReceiver);

myConversationsButton.setOnClickListener(new OnClickListener() {
    @Override
    public void onClick(View view) {
        Freshchat.showConversations(getApplicationContext());
    }
}); 

4.1.1 대화 주제 필터링

특정 용어로 태그된 주제만 필터링하고 표시하려면 showConversations() API에 전달된 ConversationOptions 인스턴스에서 filterByTags API를 사용합니다.

예: 앱의 주문 페이지에서 특정 주제만 연결하고 표시하려면 해당 주제에 "order_queries"라는 용어로 태그를 지정할 수 있습니다.

List<String> tags = new ArrayList<>();
tags.add("order_queries");
ConversationOptions options = new ConversationOptions()
    .filterByTags(tags, "Order Queries");
Freshchat.showConversations(MainActivity.this, options);

Freshchat.getInstance(getApplicationContext()).getUnreadCountAsync(new UnreadCountCallback() {
        @Override
        public void onResult(FreshchatCallbackStatus freshchatCallbackStatus, int unreadCount) {
            // "badgeTextView"가 카운트를 표시할 텍스트 뷰라고 가정합니다.
            badgeTextView.setText(Integer.toString(unreadCount));
        }
    });

IntentFilter intentFilter = new IntentFilter(Freshchat.FRESHCHAT_UNREAD_MESSAGE_COUNT_CHANGED);
    getLocalBroadcastManager(getApplicationContext()).registerReceiver(unreadCountChangeReceiver, intentFilter);

BroadcastReceiver unreadCountChangeReceiver = new BroadcastReceiver() {
    @Override
    public void onReceive(Context context, Intent intent) {
        Freshchat.getInstance(getApplicationContext()).getUnreadCountAsync(new UnreadCountCallback() {
            @Override
            public void onResult(FreshchatCallbackStatus freshchatCallbackStatus, int unreadCount) {
                // "badgeTextView"가 카운트를 표시할 텍스트 뷰라고 가정합니다.
                badgeTextView.setText(Integer.toString(unreadCount));
            }
        });
    }
}

브로드캐스트 수신기 등록 해제

getLocalBroadcastManager(getApplicationContext()).unregisterReceiver(unreadCountChangeReceiver);

4.1.3 태그로 필터링된 대화에서 읽지 않은 메시지 수

특정 태그로 필터링된 대화에서 사용자의 읽지 않은 메시지 수를 얻으려면 getUnreadCountAsync API를 사용합니다.

List<String> tags = new ArrayList<>();
    tags.add("premium"); // 대화를 필터링할 태그
    Freshchat.getInstance(getApplicationContext()).getUnreadCountAsync(new UnreadCountCallback() {
        @Override
        public void onResult(FreshchatCallbackStatus FreshchatCallbackStatus, int unreadCount) {
            badgeTextView.setText(Integer.toString(unreadCount));
        }
    }, tags);

myFAQButton.setOnClickListener(new OnClickListener() {
    @Override
    public void onClick(View view) {
        Freshchat.showFAQs(getApplicationContext());
    }
});

// 앱 화면의 버튼 클릭으로 FAQ 실행
myFAQButton.setOnClickListener(new OnClickListener() {
    @Override
    public void onClick(View view) {

        FaqOptions faqOptions = new FaqOptions()
            .showFaqCategoriesAsGrid(true)
            .showContactUsOnAppBar(true)
            .showContactUsOnFaqScreens(false)
            .showContactUsOnFaqNotHelpful(false);

        Freshchat.showFAQs(MainActivity.this, faqOptions);
    }
});

List<String> tags = new ArrayList<>();
tags.add("premium");

FaqOptions faqOptions = new FaqOptions()
    .filterByTags(tags, "FAQs", FaqOptions.FilterType.CATEGORY);//태그, 필터링된 화면 제목, 유형

Freshchat.showFAQs(MainActivity.this, faqOptions);

List<String> tags = new ArrayList<>();
tags.add("payment_failure");

FaqOptions faqOptions = new FaqOptions()
    .filterByTags(tags, "payment_failure", FaqOptions.FilterType.ARTICLE);//태그, 필터링된 화면 제목, 유형

Freshchat.showFAQs(MainActivity.this, faqOptions);

List<String> tags = new ArrayList<>();
tags.add("payment_failure");

FaqOptions faqOptions = new FaqOptions()
    .filterContactUsByTags(tags, "Payments"); //태그, 필터링된 화면 제목

Freshchat.showFAQs(MainActivity.this, faqOptions);

String tag = "premium";
String msgText = "사용자가 주문 #1234에 문제가 있습니다.";
FreshchatMessage FreshchatMessage = new FreshchatMessage().setTag(tag).setMessage(msgText);
Freshchat.sendMessage(getContext(), FreshchatMessage);