ACENT

iOS에 Freshservice Support SDK 통합하는 방법

iOS 및 Android 앱용 Freshservice 지원 SDK

이 문서는 iOS 모바일 애플리케이션과 함께 작동하도록 Freshservice 지원 SDK (FSSupportSDK)를 통합하는 방법을 설명합니다.


FSSupportSDK는 모바일 앱에 다음과 같은 Freshservice 지원 기능을 추가할 수 있도록 도와줍니다:

  • 대시보드 보기

  • 내 티켓 보기 

  • 문제 보고

  • 서비스 요청

  • 승인 요청 보기

요구 사항

FSSupportSDK의 요구 사항은 다음과 같습니다:

  • 최소 iOS 대상: 15

  • 최소 Xcode 버전: 14

FSSupportSDK 통합 과정은 다음을 포함합니다:


  • 새로운 애플리케이션 생성

  • FSSupportSDK 추가

  • FSSupportSDK 초기화

  • 애플리케이션에 Freshservice 기능 추가


새로운 애플리케이션 생성

참고: 기존 애플리케이션이 있는 경우, 이 과정을 건너뛰고 FSSupportSDK 추가로 진행할 수 있습니다.


Xcode를 사용하여 모바일 앱을 위한 새로운 애플리케이션을 생성할 수 있습니다.

  1. Xcode에서 파일 > 새로 만들기 > 프로젝트를 선택합니다.

  2. 또는, 새로운 Xcode 프로젝트 생성 on the Xcode 환영합니다 창에서.

  3. 상단 메뉴 바에서 iOS가 선택되어 있는지 확인하세요.  단일 보기 앱을 선택하고 다음을 클릭합니다.

자세한 내용은 Apple 개발자 문서를 참조하세요.

FSSupportSDK 추가하기

다음 방법 중 하나를 사용하여 FSSupportSDK를 추가할 수 있습니다:


  • Cocoapods

  • Swift 패키지 관리자


Cocoapods를 사용하여 FSSupportSDK 추가하기


  • CocoaPods를 사용하여 Xcode 애플리케이션에 FSSupportSDK를 추가하려면,  Podfile.


pod 'FSSupportSDK'


Swift Package Manager를 사용하여 FSSupportSDK 추가하기


  • Xcode 애플리케이션에서 파일 > 패키지 종속성 추가를 선택합니다. 그런 다음, 앱에 FSSupport SDK 패키지를 추가합니다.


자세한 내용은 Apple 개발자 문서를 참조하세요.


FSSupportSDK 초기화하기

FSSupportSDK 기능을 사용하기 전에 애플리케이션에서 SDK를 초기화해야 합니다.

초기화 과정에는 인증 정보 설정, 테마 구성 및 기타 필요한 설정 작업이 포함됩니다.

Note: 다음 링크를 사용하여 인증 흐름을 설정하고 필요한 인증 정보(예: 도메인, 슬러그, userToken)를 얻으세요.

AppDelegate 내 초기화

FSSupportSDK를 초기화하려면 필요한 종속성을 가져오고 애플리케이션의 'AppDelegate' 파일에 다음 코드 스니펫을 추가하세요.

Swift:

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
    FSSupport.initialize(
        domain: "domain.freshservice.com",
        slug: "",
        userToken: "",
        config: nil
    )
    return true
}


구성 옵션

다음 구성을 사용하여 앱을 사용자 정의할 수 있습니다.

  • themeColor: 이 속성을 사용하여 SDK 인터페이스에 애플리케이션의 테마 색상을 적용하세요. 지정하지 않으면 기본값은 Freshservice 테마 색상입니다.

  • enableDarkMode: SDK는 다크 모드를 지원합니다. 이 속성을 사용하여 다크 및 라이트 테마 간 전환을 할 수 있습니다. 기본적으로 SDK는 라이트 테마를 사용합니다.


초기화 및 구성 후, FSSupportSDK는 애플리케이션 내에서 사용할 준비가 됩니다.

비초기화

SDK는 애플리케이션 로그아웃 또는 사용자 전환 시나리오에서 비활성화되어야 합니다.

Swift:

FSSupport.deinitialize()


애플리케이션에 Freshservice 기능 추가

FSSupportSDK는 UIKit 및 SwiftUI 지원과 함께 다양한 지원 관련 기능에 접근할 수 있도록 제공합니다.


아래는 지원 기능과 통합을 위한 해당 메서드입니다. 이러한 메서드를 사용하여 FSSupportSDK는 앱 내에서 필수 Freshservice 지원 기능에 쉽게 접근할 수 있도록 합니다.


대시보드 보기

iOS 모바일 애플리케이션에 FSSupportSDK를 통합한 후, SDK는 모바일 앱에서 표시하고자 하는 특정 지원 기능을 포함한 대시보드를 제공합니다.

대시보드는 다음 지원 기능에 접근할 수 있도록 합니다:

  • 문제: 요청자는 이 옵션을 통해 문제를 제기할 수 있습니다.

  • 서비스 요청: 요청자는 이 옵션을 통해 서비스를 요청할 수 있습니다.

  • 요청 승인: 요청자는 이 옵션을 통해 승인 요청을 볼 수 있습니다.

  • 열린 티켓: 요청자는 이 옵션을 통해 자신의 열린 티켓을 볼 수 있습니다.


대시보드 기능을 통합하려면 다음 방법을 사용하세요.


UIKit:

let parentController = UIViewController()
FSSupport.showDashboard(parentController: parentController, modules: [.tickets]) // List of supported Modules


SwiftUI:

let dashboardView = FSSupport.buildDashboard(modules: [.tickets]) // List of supported Modules
NavigationLink(destination: dashboardView) {
Text("Dashboard")
   }


지원되는 모듈

  • FSSupport.Moudle.tickets: 지원 티켓을 표시합니다.

  • FSSupport.Moudle.reportIssue: 사용자가 문제를 보고할 수 있습니다.

  • FSSupport.Moudle.requestService: 사용자가 서비스를 요청할 수 있습니다.

  • FSSupport.Moudle.approveRequests: 보류 중인 승인 요청을 표시합니다.


내 티켓 보기

FSSupportSDK를 사용하면 요청자/사용자가 제기한 티켓 목록을 표시하는 오픈 티켓 기능을 모바일 앱에 통합할 수 있습니다. 이 통합을 통해 요청자는 대시보드에 접근할 필요 없이 직접 오픈 티켓에 접근할 수 있습니다.


다음 방법을 사용하여 오픈 티켓 기능을 통합하세요.


UIKit:

let parentController = UIViewController()
FSSupport.showTicketList(parentController: parentController)


SwiftUI:

let ticketsView = FSSupport.buildTicketList()
NavigationLink(destination: ticketsView) {
Text("Ticket List")
   }


문제 제기

FSSupportSDK를 사용하면 모바일 앱에 문제 제기 기능을 통합할 수 있으며, 이를 통해 요청자는 새로운 문제를 보고하거나 지원 요청을 제출할 수 있습니다. 이 통합을 통해 요청자는 대시보드에 접근할 필요 없이 직접 문제를 제기할 수 있습니다.


다음 방법을 사용하여 문제 제기 기능을 통합하세요.


UIKit:

let parentController = UIViewController()
FSSupport.reportIssue(parentController: parentController)


SwiftUI:

let reportIssueView = FSSupport.buildReportIssue()
NavigationLink(destination: reportIssueView) {
Text("Report Issue")
   }


서비스 요청

FSSupportSDK를 사용하면 모바일 앱에 서비스 요청 기능을 통합할 수 있으며, 이를 통해 요청자가 서비스 요청을 시작할 수 있습니다. 이 통합은 요청자가 대시보드에 접근할 필요 없이 직접 서비스 요청을 시작할 수 있도록 도와줍니다.


서비스 요청 기능을 통합하려면 다음 방법을 사용하세요.


UIKit:

let parentController = UIViewController()
FSSupport.requestService(parentController: parentController)


SwiftUI:

let requestServiceView = FSSupport.buildRequestService()
NavigationLink(destination: requestServiceView) {
Text("Request Service")
   }


승인 요청 보기

FSSupportSDK를 사용하면 모바일 앱에 승인 요청 보기 기능을 통합할 수 있으며, 이를 통해 사용자가 승인 요청을 보고 관리할 수 있습니다. 이 통합은 사용자가 대시보드에 접근할 필요 없이 직접 승인 요청을 관리할 수 있도록 도와줍니다.


다음 메서드를 사용하여 승인 요청 보기 기능을 통합하세요.


UIKit:

let parentController = UIViewController()
FSSupport.showApprovalRequests(parentController: parentController)


SwiftUI:

let approvalRequestView = FSSupport.buildApprovalRequests()
NavigationLink(destination: approvalRequestView) {
Text("Request Service")
   }

이 문서가 도움이 되었나요?

같은 폴더의 문서

Freshservice 지원 SDK 소개
안드로이드에서 Freshservice Support SDK 통합하는 방법
Freshservice Support SDK 인증을 위한 사용자 정의 JWT 엔드포인트 구성 방법

Freshservice AI 도우미

iOS에 Freshservice Support SDK 통합하는 방법

AI 어시스턴트 초기화 중...