Freshchat iOS SDK 통합 단계

func application(_ application: UIApplication,
didFinishLaunchingWithOptions 
launchOptions: 
[UIApplicationLaunchOptionsKey: Any]?) -> Bool 
{
    let freshchatConfig:FreshchatConfig = FreshchatConfig.init(appID: "YOUR-APP-ID", andAppKey: "YOUR-APP-KEY")
    config.domain = "YOUR-DOMAIN"
    Freshchat.sharedInstance().initWith(freshchatConfig)
    return true
}

2.1. 구성 옵션 초기화

func application(_ application: UIApplication,
didFinishLaunchingWithOptions launchOptions:
[UIApplicationLaunchOptionsKey: Any]?) -> Bool 
{
    let freshchatConfig:FreshchatConfig = FreshchatConfig.init(appID: "YOUR-APP-ID", andAppKey: "YOUR-APP-KEY")
    config.domain = "YOUR-DOMAIN"
    freshchatConfig.gallerySelectionEnabled = true; 
// set FALSE to disable picture selection for messaging via gallery
    freshchatConfig.cameraCaptureEnabled = true; 
// set FALSE to disable picture selection for messaging via camera
    freshchatConfig.teamMemberInfoVisible = true; 
// set to FALSE to turn off showing a team member avatar. To customize the avatar shown, use the theme file
    freshchatConfig.showNotificationBanner = true; 
// set to FALSE if you don't want to show the in-app notification banner upon receiving a new message while the app is open
    freshchatConfig.responseExpectations = true; 
//set to FALSE if you want to hide the response expectations for the Topics
    Freshchat.sharedInstance().initWith(freshchatConfig)
    return true
}

3. 사용자 정보

3.1 사용자 정보 업데이트

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

/* 

* 다음 세 가지 방법은 사용자를 식별하는 데 사용됩니다.

* 이러한 사용자 속성은 Freshchat 웹 대시보드에서 볼 수 있습니다.

*/

Objective C

// Create a user object
let user = FreshchatUser.sharedInstance();
// To set an identifiable first name for the user
user?.firstName = "John"
// To set an identifiable last name for the user
user?.lastName = "Doe"
//To set user's email id
user?.email = "john.doe.1982@mail.com"
//To set user's phone number
user?.phoneCountryCode="00"
user?.phoneNumber = "9999999999"
Freshchat.sharedInstance().setUser(user)

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

앱의 사용자 및 이벤트에 대한 추가 메타데이터를 캡처하고 전송할 수 있으며, 이는 나중에 메시지를 푸시할 사용자 세그먼트를 만드는 방법이 됩니다.

Objective C

//You can set custom user properties for a particular user
[[Freshchat sharedInstance] setUserPropertyforKey:@"customerType" 
withValue:@"Premium"];
//You can set user demographic information
[[Freshchat sharedInstance] setUserPropertyforKey:@"city" withValue:@"San Bruno"];
//You can segment based on where the user is in their journey of using your app
[[Freshchat sharedInstance] setUserPropertyforKey:@"loggedIn" withValue:@"true"];
//You can capture a state of the user that includes what the user has done in your app
[[Freshchat sharedInstance] setUserPropertyforKey:@"transactionCount" withValue:@"3"];

//You can set custom user properties for a particular user
Freshchat.sharedInstance().setUserPropertyforKey("customerType", withValue: "Premium")
//You can set user demographic information
Freshchat.sharedInstance().setUserPropertyforKey("city", withValue: "San Bruno")
//You can segment based on where the user is in their journey of using your app
Freshchat.sharedInstance().setUserPropertyforKey("loggedIn", withValue: "true")
//You can capture a state of the user that includes what the user has done in your app
Freshchat.sharedInstance().setUserPropertyforKey("transactionCount", withValue: "3")

[[Freshchat sharedInstance] 
trackEvent:"Event_Name" withProperties:PropertiesDictionary];

Freshchat.sharedInstance()?.trackEvent("Event_Name", withProperties: PropertiesDictionary)

[[Freshchat sharedInstance] resetUserWithCompletion:^
{
        //Completion block code here
}];

Freshchat.sharedInstance().resetUser(completion: 
{ 
() in
            //Completion code
})

Freshchat.sharedInstance().identifyUser(withExternalID: "externalId", restoreID: nil)
//To lookup and restore user by external id and restore id:
Freshchat.sharedInstance().identifyUser(withExternalID: "externalId", restoreID: "restoreId")
//To retrieve the restore id:
FreshchatUser.sharedInstance().restoreID
//To listen to restore id generated event:
// Register for local notification
NotificationCenter.default.addObserver(self,selector:
#selector(userRestoreIdReceived),name: NSNotification.Name(rawValue: FRESHCHAT_USER_RESTORE_ID_GENERATED),object: nil)
func userRestoreIdReceived()
{
   print("Your restore id is - " FreshchatUser.sharedInstance().restoreID)
   print("Your query external id is - " FreshchatUser.sharedInstance().externalID)
}
//Unregister local notification
NotificationCenter.default.removeObserver(FRESHCHAT_USER_RESTORE_ID_GENERATED)

func presentConversation(sender: Any) 
{
        Freshchat.sharedInstance().showConversations(self)
}

4.1.2 읽지 않은 메시지 수

Freshchat.sharedInstance().unreadCount 
{ 
(count:Int) -> Void in
          print("Unread count (Async) :\(count)")
 }

앱은 또한 앱이 열려 있을 때 읽지 않은 메시지 수의 변경 사항을 수신 대기할 수 있습니다.

Objective C

[[NSNotificationCenter defaultCenter]addObserverForName:FRESHCHAT_UNREAD_MESSAGE_COUNT_CHANGED 
object:nil queue:nil usingBlock:^(NSNotification *note) 
{
       [[Freshchat sharedInstance]unreadCountWithCompletion:^(NSInteger count) 
{
            NSLog(@"your unread count : %d", (int)count);
       }]; 
}];

// Register for notification
   NotificationCenter.default.addObserver(self, selector:
#selector(self.methodOfReceivedNotification(notification:)), name: 
Notification.Name(FRESHCHAT_UNREAD_MESSAGE_COUNT_CHANGED), object: nil)
//Handling method -
    func methodOfReceivedNotification(notification: Notification)
{
        Freshchat.sharedInstance().unreadCount { (count:Int) -> Void in
          print("Unread count (Async) :\(count)")
        }        
    }

func presentFAQ(sender: Any) 
{
        Freshchat.sharedInstance().showFAQs(self)
}

4.2.1 FAQ 옵션

FAQ 흐름의 사용자 정의는 showFAQs() API에 전달된 FaqOptions 인스턴스에서 관련 옵션을 지정하여 달성할 수 있습니다.

Objective-C :

FAQOptions *options = [FAQOptions new];

options.showFaqCategoriesAsGrid = YES; // Show FAQ in grid formal, NO to list view

options.showContactUsOnFaqScreens = YES; // Show chat option from FAQ section

options.showContactUsOnFaqNotHelpful = YES; // Show contact us in article detail when user select Not Helpful

options.showContactUsOnAppBar = YES; // Show chat option over navigation bar in FAQ category view or article list view

[[Freshchat sharedInstance]showFAQs:self withOptions:options];

Swift :

let options = FAQOptions.init()

options.showFaqCategoriesAsGrid = true // Show FAQ in grid formal, false to list view

options.showContactUsOnFaqScreens = true // Show chat option from FAQ section

options.showContactUsOnFaqNotHelpful = true // Show contact us in article detail when user select Not Helpful

options.showContactUsOnAppBar = true // Show chat option over navigation bar in FAQ category view or article list view

4.2.2 FAQ 필터링

특정 화면에서 또는 로그인한 고객과 방문자와 같은 일부 사용자에게만 특정 용어로 태그된 FAQ만 필터링하여 표시할 수 있습니다. 이러한 태그는 대시보드에서 설정할 수 있습니다. 

예를 들어, 결제 실패와 관련된 FAQ를 해당 페이지에서만 표시하려면 특정 FAQ에 "결제" 및 "청구" 태그를 지정할 수 있습니다. 그런 다음 필터링하여 사용자에게 표시할 수 있습니다.

기사로 FAQ 필터링

Objective C

FAQOptions *options = [FAQOptions new];
[options filterByTags:@[ @"payment", @"billing" ]
withTitle:@"Filtered_View_title" andType: ARTICLE];
[[Freshchat sharedInstance]showFAQs:self withOptions:options];

let options = FAQOptions.init()
let tags: [String] = ["payment","billing"]
options.filter(byTags: tags, withTitle:"Filtered_View_title", andType :ARTICLE)
Freshchat.sharedInstance().showFAQs(self, with: options)

카테고리도 태그로 필터링할 수 있습니다. 이렇게 하면 카테고리(해당 카테고리 아래에 기사가 나열됨)의 필터링된 보기가 표시됩니다. 이는 다른 고객(예: 유료 고객 대 무료 고객)에게 다른 카테고리 세트를 표시하는 데 유용합니다.

Objective C

FAQOptions *options = [FAQOptions new];
[options filterByTags:@[ @"payment", @"billing" ]
withTitle:@"Filtered_View_Title" andType: CATEGORY];
[[Freshchat sharedInstance]showFAQs:self withOptions:options];

let options = FAQOptions.init()
let tags: [String] = ["payment", "billing"]
options.filter(byTags: tags, withTitle:"Filtered_View_Title", andType :CATEGORY)
Freshchat.sharedInstance().showFAQs(self, with: options)