SDK バージョン2.0

はじめに

• カスタマーサポートチームへの問い合わせ（問い合わせの送信、サポート担当者とのチャット）
  
• ナレッジベース（ヘルプ記事へのアクセス）
  
• ユーザーコミュニティ（アプリを通じた他の顧客とやりとり）
  

どこでもサポートSDKの機能を試す場合は、iPhoneまたはiPadにこの デモアプリ をインストールしてください。

現在バージョン1.1.12以前のどこでもサポートSDKを利用している場合、バージョン2.0を利用するには既存のコードを移行する必要があります。コードの移行手順については、この記事の 「バージョン1.xから2.0への移行」 セクションをご参照ください。

Zoho DeskでのSDKの設定

1. Zoho Deskで、 ［設定］ → ［チャネル］ → ［どこでもサポート］ の順に移動します。
   
2. 左側の 設定 メニューの どこでもサポート にて、 モバイル の隣にある［+］ボタンをクリックします。 モバイルアドオンの作成 画面が表示されます。
   
   
   
   

   
   
3. ［アドオンの詳細］ で、以下の内容を設定します：
   
   1. 名前： どこでもサポートのアドオンの名前です。この名前は参照用です。アプリの操作画面上には表示されません。
      
   2. 有効： どこでもサポートのアドオンを有効にする部門を選択します。
      
   3. バンドルID： iOS の項目に、iOSアプリのバンドルIDを入力します。（対象のアプリの設定内にある 一般 タブでバンドルIDを確認できます。）
      
      メモ ：チャット機能を有効にしたり、プッシュ通知を送信したりするには、バンドルIDが必須です。
      
   4. チャット： 切り替えボタンを操作することで、チャット機能を有効または無効にできます。
      
      メモ ：チャットタブには、ポータルのチャットチャネルにて設定された内容が反映されます。そのため、設定を変更するには、Zoho Deskの設定画面で行う必要があります。
      
   5. Zia： Zoho DeskのZia（ZohoのAIアシスタント）機能を有効にすると、顧客がモバイルアプリからZiaの案内に従って必要な情報を得ることができます。たとえば、質問を送信すると、対応するヘルプやよくある質問の記事（ナレッジベース）の内容が自動で表示されます。Zia機能を有効にするには、切り替えボタンをクリックします。
      
      
   6. 自動ガイドボット ：自動ガイドボットは、顧客が、担当者からのサポートを受けずに、自力で問題を解決するのに役立つ機能です。自動応答によるやりとりを通じて、顧客の求めている内容を絞り込みながら、適切な解決策や手続きを提示できます。提供には、チャットのフローの事前設定が必要です。切り替えボタンをクリックすると、自動ガイドボット機能の状態（有効／無効）を切り替えることができます。有効にしたら、使用したい自動ガイドボットのフローを選択する必要があります。 詳細はこちら

      

      メモ ：Ziaと自動ガイドボットの機能は、両方を有効にすることも可能です。
   7. バンドルID： iOS の項目にiOSアプリのバンドルIDを入力します（対象のアプリの設定内にある ［一般］ タブでバンドルIDを確認できます）。
      
      メモ ：チャット機能を有効にしたり、プッシュ通知を送信したりするには、バンドルIDが必須です。
      
   8. プッシュ通知： 切り替えボタンを操作することで、プッシュ通知を有効/無効にできます。詳細については、このドキュメントの「通知の有効化」セクションをご参照ください。
      
      メモ ：通知を有効にするには、JWT方式でのユーザー認証が必須となります。匿名ユーザーに対して、問い合わせに関するプッシュ通知を送信することはできません。
      
   9. 認証方法： このアドオンにおけるユーザーの認証方法を設定します。
      
   10. 匿名： この方法では、エンドユーザーはゲストユーザーとみなされます。ゲストユーザーが行える操作は、問い合わせの送信、ユーザーコミュニティでの投稿内容の表示、サポート担当者とのチャット、に限定されます。自分が送信した問い合わせを表示したり、ユーザーコミュニティに参加したりすることはできません。
       
   11. JWT： この方法では、エンドユーザーは認証済みユーザーとみなされます。ゲストユーザーが行える操作に加えて、認証済みユーザーは、自分が送信した問い合わせのステータスを表示したり、問い合わせに返信やコメントしたり、ユーザーコミュニティに参加したりすることもできます。コミュニティでは、トピックのフォロー、トピックの追加、既存の投稿へのコメントの追加など、さまざまな操作を行うことができます。
       
4. ［保存］ をクリックします。
   

SDKとアプリとの連携

1. ターミナルで、プロジェクトの最上位のフォルダーに移動します（ xcodeproj ファイルが含まれるフォルダーです）。
   
2. コマンド「$ pod init」を実行します。
   
3. 次に、コマンド「 open -a Xcode Podfile 」を実行して、XcodeのPodfileを開きます。ファイルの内容が以下のように表示されます：
   

               
                  
                     # Uncomment this line to define a global platform for your project 
                     # platform :ios, '9.0' 
                     # Uncomment this line if you're using Swift 
                     # use_frameworks! t
                     arget 'My Sample App' do 
                     end
                  
               
               
   
            

4. Swiftを利用する場合は、「use_frameworks!」の行に何も入力しないでください。
   

1. はじめに、該当のSDKをPodfileに追加します。
   
   • どこでもサポート Core SDK（問い合わせ、ナレッジベース、コミュニティ） を連携するには、以下のコードをPodfileのdoブロックに追加します。
     

                       
                          
                             target 'My Sample App' do 
                             pod 'ZohoDeskPortalCore' 
                             end
                          
                       
                       
     
                    

   • どこでもサポート Services SDK（問い合わせ、ナレッジベース、コミュニティ、チャット） を連携するには、以下のコードをPodfileのdoブロックに追加します。
     

                       
                          
                             target 'My Sample App' do 
                             pod 'ZohoDeskPortalServices' 
                             end
                          
                       
                       
     
                    

2. Podfileを保存します。
   
3. ターミナルで、コマンド「 $ pod install 」を実行します。
   

1. はじめに、該当のSDKをダウンロードします。
   
   • どこでもサポート Core SDK（問い合わせ、ナレッジベース、コミュニティ） の場合は、 こちらのリンク を使用します。
     
   • どこでもサポート Services SDK（問い合わせ、ナレッジベース、コミュニティ、チャット） の場合は、 こちらのリンク を使用します。
     
2. ダウンロードしたファイルを解凍します。次に、拡張子「 .XCFramework」を持つ対象のフレームワークファイルを、 Xcodeのプロジェクトの Frameworks 、 Libraries and Embedded Content セクションにドラッグ＆ドロップします。
   

メモ：  どこでもサポート Core SDKを連携する場合は、アプリの「info.plist」ファイルに NSPhotoLibraryUsageDescription 、 NSCameraUsageDescription 、 NSMicrophoneUsageDescription キーを追加してください。

アプリ内のSDKの初期設定

• 組織ID（Org ID）
  
• アプリID（App ID）
  
• データセンター（Datacenter）
  

1. Zoho DeskポータルのSDKフレームワークを、プロジェクトの AppDelegate ファイル内にインポートします。
   
   Swift
   

                  
                     
                        import ZohoDeskPortalAPIKit
                     
                  
                  
   
               

   Objective-C
   

                  
                     
                        @import ZohoDeskPortalAPIKit;
                     
                  
                  
   
               

2. 以下の初期化コードを、引数「 didFinishLaunchingWithOptions 」を持つアプリケーションのメソッド内に貼り付けます。
   
   Swift
   

               
                  
                     func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?)-> Bool {
                     　　　 ZohoDeskPortalSDK.initialize(orgID:<#String#>, appID:<#String#>, dataCenter: <#ZDPDataCenter#>)
                     　　　 return true 
                     }
                  
               
               
   
            

   Objective-C
   

               
                  
                     - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
                     　　　 [ZohoDeskPortalSDK initializeWithOrgID:<#NSString#>appID:<#NSString#>dataCenter:<#ZDPDataCenter#>];
                     　　　　return YES; 
                     }
                  
               
               
   
            

メモ：

配置の種類の応じたデータセンターの値は、以下のとおりです：

CN：ZDPDataCenter.CN

EU：ZDPDataCenter.EU

US：ZDPDataCenter.US

IN：ZDPDataCenter.IN

AU：ZDPDataCenter.AU

ヘルプタブの表示

メモ ：どこでもサポート Services SDKでチャットタブを表示する場合は、Zoho DeskのWebポータルにてチャットタブを有効にする必要があります。

      
         
            import ZohoDeskPortalCore 
            ...
            ZDPortalHome.show()
         
      
      

   

      
         
            @import ZohoDeskPortalCore; 
            ...
            [ZDPortalHome showWithConfiguration:nil andTitle:nil];
         
      
      

   

メモ

• 特定のヘルプタブをアドオン内に表示するには、はじめにZoho DeskのWebポータルで対象のタブを有効にする必要があります。
  
• ダッシュボードでタブを表示せずに、アプリ内の別の場所から起動させることもできます。
  
• アプリ内にSDKダッシュボードを表示せずに、それぞれのヘルプタブにアクセスできるようにするオプションも用意されています。
  

      
         
            let config = ZDPHomeConfiguration() 
            config.enableHelpCenter = true // disable/enable the Help center (Knowledge Base). 
            config.enableCommunity = false // disable/enable the Community. 
            config.enableCreateTicket = true // disable/enable the CreateTicket. 
            config.enableMyTicket = true // disable/enable My Tickets.
            ZDPortalHome.show(withConfiguration: config)
         
      
      

   

      
         
            ZDPHomeConfiguration * config = [[ZDPHomeConfiguration alloc]init]; 
            config.enableHelpCenter = YES; // disable/enable the Help center (Knowledge Base). 
            config.enableCommunity = NO; // disable/enable the Community. 
            config.enableCreateTicket = YES; // disable/enable the CreateTicket. 
            config.enableMyTicket = YES; // disable/enable My Tickets.
            [ZDPortalHome showWithConfiguration:config andTitle:<#(NSString * _Nullable)#>];
         
      
      

   

      
         
            import ZohoDeskPortalChat 
            ...
            ZDPortalChat.show()
         
      
      

   

      
         
            @import ZohoDeskPortalChat; 
            ...
            [ZDPortalChat show];
         
      
      

   

      
         
            import ZohoDeskPortalKB
         
      
      

   

      
         
            @import ZohoDeskPortalKB;
         
      
      

   

      
         
            ZDPortakKB.show()
         
      
      

   

      
         
            [ZDPortalKB showKnowledgeBaseWithTitle:<#NSString#>];
         
      
      

   

      
         
            ZDPortalKB.showCategory(withPermalink: <#String#>)
         
      
      

   

      
         
            [ZDPortalKB showCategoryWithPermalink:<#NSString#>withTitle:<#NSString#>];
         
      
      

   

      
         
            ZDPortalKB.showArticle(withPermalink : <#String#>)
         
      
      

   

      
         
            ZDPortalKB showArticleWithPermalink:<#NSString#>withTitle:<#NSString#>];
         
      
      

   

      
         
            import ZohoDeskPortalTicket
         
      
      

   

      
         
            @import ZohoDeskPortalTicket;
         
      
      

   

      
         
            ZDPortalSubmitTicket.show()
         
      
      

   

      
         
            [ZDPortalSubmitTicket showWithTitle:<#NSString#>];
         
      
      

   

      
         
            ZDPortalSubmitTicket.showAddTicketForm(completion: { (ticket) in
            　　// The ticket parameter contains the details of the ticket created.
            　　// Your program logic goes here.
            }, onError: { error in
            　　// error creating Ticket 
            })
         
      
      

   

      
         
            [ZDPortalSubmitTicket showAddTicketFormWithTitle:<#(NSString * _Nullable)#> navigationMode:<#(enum ZDPNavigationMode)#> completion:^(ZDPTicket * ticket) {
            　// The ticket parameter contains the details of the ticket created.
            　　// Your program logic goes here.
            } onError:^(NSError * error) {
            　　// error creating Ticket 
            }];
         
      
      

   

メモ ：認証済みユーザーによって問い合わせが送信されると、問い合わせのすべての詳細情報が送信されます。ゲストユーザーによって問い合わせが送信されると、問い合わせ番号のみが送信されます。

      
         
            ZDPortalTicket.show()
         
      
      

   

      
         
            [ZDPortalTicket showWithTitle:<#NSString#>];
         
      
      

   

      
         
            import ZohoDeskPortalCommunity
         
      
      

   

      
         
            @import ZohoDeskPortalCommunity;
         
      
      

   

      
         
            ZDPortalCommunity.show()
         
      
      

   

      
         
            [ZDPortalCommunity show];
         
      
      

   

      
         
            ZDPortalCommunity.showTopic(withID: <#String#>)
         
      
      

   

      
         
            [ZDPortalCommunity showTopicWithID:<#NSString#>];
         
      
      

   

自動ガイドボットに関連するすべてのメソッドの実行には、以下のインポートステートメントを追加します。

Swift

         
            
               import ZohoDeskPortalLiveChat
            
         
         
            

         
      

Objective-C

            
               
                  @import ZohoDeskPortalLiveChat;
               
            
            
               

            
         

以下のメソッドにより、自動ガイドボットが表示されます。

Swift

            
               
                  ZDPortalLiveChat.show()
               
            
            
               

            
         

Objective-C

            
               
                  [ZDPortalLiveChat show];
               
            
            
               

            
         

Ziaや自動ガイドボットの機能を有効にすると、チャットの画面は以下のように表示されます。

1. すでにサインインしているユーザーが最新のバージョンに移行し、自動ガイドボットを利用する場合、一度サインアウト（ログアウト）してから、もう一度サインイン（ログイン）の操作を行い、再認証する必要があります。再認証が完了すると、ユーザーの認証情報が自動ガイドボット機能に同期されます。
   
2. 自動ガイドボットとZiaを一緒に有効にすると、初期設定では自動ガイドボットが読み込まれます。必要に応じて、Ziaに切り替えることもできます。会話を再開するメニューをクリックしてフローをリセットしない限り、フロー中にZiaと自動ガイドボットを切り替えることはできませんので、ご注意ください。
3. Ziaのボットから回答が得られなかったときに顧客が実行できる処理は、チャットタブが有効になっているかどうかによって異なります。たとえば、チャットタブが有効な場合、顧客は担当者とやりとりを行うように切り替えることもできます。無効になっている場合、顧客は問い合わせの送信のみを行うことができます。

SDKでのユーザー認証

• 匿名： この方法では、エンドユーザーはゲストユーザーとみなされます。ゲストユーザーが行える操作は、問い合わせの送信、ユーザーコミュニティでの投稿内容の表示、サポート担当者とのチャット、に限定されます。自分が送信した問い合わせを表示したり、ユーザーコミュニティに参加したりすることはできません。
  
• JWT： この方法では、エンドユーザーは認証済みユーザーとみなされます。ゲストユーザーが行える操作に加えて、認証済みユーザーは、自分が送信した問い合わせを表示したり、ユーザーコミュニティに参加したりすることもできます。コミュニティでは、トピックのフォロー、トピックの追加、既存の投稿へのコメントの追加など、さまざまな操作を行うことができます。
  

      
         
            import ZohoDeskPortalAPIKit
         
      
      

   

      
         
            @import ZohoDeskPortalAPIKit;
         
      
      

   

      
         
            if !ZohoDeskPortalSDK.isUserLoggedIn{ 
            　　　　ZohoDeskPortalSDK.login(withUserToken: String) { (isSuccess: Bool) in
            // isSuccess shows whether the login attempt was successful
            // any errors will be logged
            　　　　}
            }else{
            // user logged in already 
            }
         
      
      

   

      
         
            if (!ZohoDeskPortalSDK.isUserLoggedIn){
            　　　 [ZohoDeskPortalSDK loginWithUserToken:<#(NSString * _Nonnull)#> onCompletion:^(BOOL isSuccess) {
            // isSuccess shows whether the login attempt was successful
            // any errors will be logged
            　　　　}];
            }else{
            // user logged in already 
            }
         
      
      

   

      
         
            ZohoDeskPortalSDK.logout { (isSuccess: Bool ) in
            　　　// isSuccess shows whether the logout attempt was successful
            　　　// any errors will be logged
            }
         
      
   

      
         
            [ZohoDeskPortalSDK logoutOnCompletion:^(BOOL isSuccess) {
            // isSuccess shows whether the logout attempt was successful
            　　　　// any errors will be logged
            }];
         
      
      

   

ローカルデータのクリア

      
         
            ZohoDeskPortalSDK.clearAllLocalData()
         
      
      

   

      
         
            [ZohoDeskPortalSDK clearAllLocalData];
         
      
      

   

アドオンの操作画面のカスタマイズ

      
         
            import ZDThemeKit
         
      
      

   

      
         
            @import ZDThemeKit;
         
      
      

   

      
         
            ZDThemeManager.setTheme(type: .white)
         
      
      

   

      
         
            [ZDThemeManager setTheme:ZDThemeTypeWhite];
         
      
      

   

      
         
            ZDThemeManager.setTheme(type: .dark)
         
      
      

   

      
         
            [ZDThemeManager setTheme:ZDThemeTypeDark];
         
      
      

   

      
         
            ZDThemeManager.setTheme(type: .system)
         
      
      

   

      
         
            [ZDThemeManager setTheme:ZDThemeTypeSystem];
         
      
      

   

メモ

1. 「ZDThemeType.system」は、iOS 13以降でのみ利用できます。
   
2. 初期設定では、iOS 13以降でシステムテーマが適用されます。iOS 13以前ではライトテーマが適用されます。
   

      
         
            ZDThemeManager.updateTheme(theme: <#ZDThemeProtocol#>)
         
      
      

   

      
         
            [ZDThemeManager updateThemeWithTheme:<#ZDThemeProtocol#>];
         
      
      

   

      
         
            ZDThemeManager.updateDarkTheme(theme: <#ZDThemeProtocol#>)
         
      
      

   

      
         
            [ZDThemeManager updateDarkThemeWithTheme:<#ZDThemeProtocol#>];
         
      
      

   

メモ ：SDKのテーマの更新処理は、テーマの種類の設定処理とは異なります。通常、設定したテーマの種類に応じて、SDKにダークまたはライトテーマが適用されます。

1. プロジェクトにフォントを追加します。
   
2. アプリの「info.plist」ファイルを編集して、アプリケーションキーが提供する フォント を追加します。
   
3. このキーには、SDKの操作画面で使用するすべてのフォントの名前が表示されます。
   

      
         
            ZDPortalConfiguration.customFontName = <#String#>
         
      
      

   

      
         
            ZDPortalConfiguration.customFontName = <#NSString#>;
         
      
      

   

メモ ：カスタムフォントを使用しない場合、初期設定ではシステムのフォントが表示されます。バージョン2.0からフォントのサイズを変更できるようになりました。カスタムフォントは、iOS 11以降でのみ対応しています。

言語設定の変更

      
         
            ZDPortalConfiguration.setSDKLanguage(<#String#>)
         
      
      

   

      
         
            [ZDPortalConfiguration setSDKLanguage:<#NSString#>];
         
      
      

   

操作画面上の文字列のカスタマイズ

1. 「 ASAPStrings.bundle 」という件名のバンドルを、アプリのXcodeのプロジェクトに作成します。このバンドルへのアクセスパスは、次のとおりです：Application-bundle/ASAPStrings.bundle.
   
2. ファイル名を言語コードにした新しい「Iproj」ファイルを作成し、必要に応じて、キーの値をカスタマイズします。  以下に一覧されている主要なキー、または、言語バンドル内のすべてのキーをカスタマイズできます。
   
3. この新しい「lproj」ファイルを、「 ASAPStrings 」バンドルに追加します。
   

メモ ：言語ごとに個別の「lproj」ファイルが必要です。アドオンで対応する各言語で文字列をカスタマイズするには、手順2と手順3を必要な回数だけ繰り返します。

通知の有効化

1. Appleの開発者ポータルでAPNs証明書を作成し、ダウンロードします。
   
2. 証明書をダブルクリックします。ダブルクリックすると、自動的に証明書がキーチェーンアクセスアプリケーションにインポートされます。
   
3. キーチェーンアクセス内の証明書を開きます。証明書に対応するキーが表示されます。
   
4. 証明書とキーを選択して、右クリックします。コンテキストメニューが表示されます。
   
5. エクスポートオプションをクリックします。ダイアログボックスが表示されます。
   
6. ダイアログボックスの ［File Format］ のドロップダウンで ［.p12］ が選択されていることを確認し、 ［保存］ をクリックします。
   
7. ファイルにアクセスするためのパスワードを入力して、 ［OK］ をクリックします。証明書が.p12ファイルとしてエクスポートされます。
   

      
         
            func application(_ application: UIApplication,didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data) { let token = deviceToken.reduce("", {$0 + String(format: "%02X", $1)}).uppercased() ZohoDeskPortalSDK.enablePushNotification(deviceToken:token, mode: .production) }
         
      
      

   

      
         
            - (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken{ NSString * token = [[[[deviceToken description] stringByReplacingOccurrencesOfString: @"<" withString: @""] stringByReplacingOccurrencesOfString: @">" withString: @""] stringByReplacingOccurrencesOfString: @" " withString: @""]; [ZohoDeskPortalSDK enablePushNotificationWithDeviceToken:token isTestDevice:NO mode:APNSModeProduction]; }
         
      
      

   

メモ ：開発モードで機能をテストして、通知が正しく送信されるかどうか検証することができます。開発モードに切り替えるには、上記のコードの「.production」を「.sandbox」に変更します。エンドユーザーに対してアプリを公開する前に、必ず本番環境モードに切り替えてください。

      
         
            import ZohoDeskPortalConfiguration 
            ... func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable : Any]) {
            　　 ZDPortalConfiguration.processRemoteNotification(userInfo: userInfo) 
            }
         
      
      

   

      
         
            @import ZohoDeskPortalConfiguration; 
            ...
            　- (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo fetchCompletionHandler:(void (^)(UIBackgroundFetchResult))completionHandler{
            　　 [ZDPortalConfiguration processRemoteNotificationWithUserInfo:userInfo]; 
            }
         
      
      

   

担当者に対する匿名ユーザーの詳細データの表示

      
         
            import ZohoDeskPortalChat 
            ...
            ZDPortalChat.setGuestUser(email:<#Guest_User_Email#>, displayName:<#Guest_User_DisplayName#>", phoneNumber: <#Guest_User_PhoneNumber#>")
         
      
      

   

      
         
            @import ZohoDeskPortalChat;
            ...
            [ZDPortalChat setGuestUserWithEmail:<#Guest_User_Email#>displayName:<#Guest_User_DisplayName#>phoneNumber:<#Guest_User_PhoneNumber#>];
         
      
      

   

プログラムによる問い合わせの追加

      
         
            import ZohoDeskPortalAPIKit
         
      
      

   

      
         
            @import ZohoDeskPortalAPIKit;
         
      
      

   

      
         
            ZohoDeskPortalSDK.getDepartments(onCompletion: { (departments, error) in
            // on success, departments will return an array, error will return nil
            // on failure, error will return a value, departments will return nil 
            }
         
      
      

   

      
         
            ZohoDeskPortalSDK getDepartmentsOnCompletion:^(NSArray * departments, NSError * error) {
            // on success, departments will return an array, error will return nil
            // on failure, error will return a value, departments will return nil 
            }];
         
      
      

   

      
         
            ZohoDeskPortalSDK.getProducts(inDepartmentID: String, [String: Any]?){ (products, error) in
            // on success, products will return an array, error will return nil
            // on failure, error will return a value, products will return nil 
            }
         
      
      

   

      
         
            [ZohoDeskPortalSDK getProductsInDepartmentID:<#NSString#>params:<#NSDictionary#>onCompletion:^(NSArray * products, NSError * error) {
            // on success, products will return an array, error will return nil
            // on failure, error will return a value, products will return nil 
            }];
         
      
      

   

      
         
            ZohoDeskPortalSDK.Ticket.getFields([String: Any]?){ (fields, error) in
            // on success, fields will return an array, error will return nil
            // on failure, error will return a value, products will return nil 
            }
         
      
      

   

      
         
            [ZohoDeskPortalSDKTicket getFields:<#(NSDictionary * _Nullable)#>onCompletion:^(NSArray * fields, NSError * error) {
            // on success, fields will return an array, error will return nil
            // on failure, error will return a value, fields will return nil 
            }];
         
      
      

   

      
         
            ZohoDeskPortalSDK.Ticket.addAttachment(with:<#Data#>, andName:<#String#>, using: <#ZDPUploaderDelegate?#>) { (attachment, error) in
            // on success, attachment will return a value, error will return nil
            // on failure, error will return a value, attachment will return nil 
            }
         
      
      

   

      
         
            [ZohoDeskPortalSDKTicket addAttachmentWith:<#NSData#>andName:<#NSString#>using:<#(id _Nullable)#>onCompletion:^(ZDPortalAttachment * attachment, NSError * error) {
            // on success, attachment will return a value, error will return nil
            // on failure, error will return a value, attachment will return nil 
            }];
         
      
      

   

      
         
            if ZohoDeskPortalSDK.isUserLoggedIn {
            ZohoDeskPortalSDK.Ticket.add(withFields:<#T##[String : Any]#>) { (ticket, error) in
            // on success, ticket will return an object, error will return nil
            // on failure, error will return a value, ticket will return nil 
            } 
            } else {
            ZohoDeskPortalSDK.Ticket.addAsGuest(withFields: <#T##[String : Any]#>) { (ticketNumber, error) in
            // on success, ticketNumber will return a string value, error will return nil
            // on failure, error will return a value, ticketNumber will return nil 
            } 
            }
         
      
      

   

      
         
            if (ZohoDeskPortalSDK.isUserLoggedIn) {
            　　　 [ZohoDeskPortalSDKTicket addWithFields:<#(NSDictionary * _Nonnull)#>onCompletion:^(ZDPTicket * ticket, NSError * error) {
            　　　　　　 // on success, ticket will return an object, error will return nil
            　　　　　 　// on failure, error will return a value, ticket will return nil
            　　　 }]; 
            }else{
            　　　[ZohoDeskPortalSDKTicket addAsGuestWithFields:<#(NSDictionary * _Nonnull)#>onCompletion:^(NSString * ticketNumber, NSError * error) {
            　　　　　　 // on success, ticketNumber will return a string value, error will return nil
            　　　　　 　// on failure, error will return a value, ticketNumber will return nil 
            　　　　}] 
            }
         
      
      

   

メモ ：メソッドを呼び出すにあたって、 EmailAddress 、 Subject 、 DepartmentID は必須パラメーターです。

コミュニティタブのカスタマイズ

      
         
            ZDPCommunityConfiguration.isTopicEditAllowed = <#Bool#> 
            ZDPCommunityConfiguration.isTopicDeleteAllowed = <#Bool#> 
            ZDPCommunityConfiguration.isReplyAllowed = <#Bool#> 
            ZDPCommunityConfiguration.iReplyEditAllowed = <#Bool#> 
            ZDPCommunityConfiguration.isReplyDeleteAllowed = <#Bool#>
         
      
      

   

      
         
            ZDPCommunityConfiguration.isTopicEditAllowed = <#Bool#>; 
            ZDPCommunityConfiguration.isTopicDeleteAllowed = <#Bool#>; 
            ZDPCommunityConfiguration.isReplyAllowed = <#Bool#>; 
            ZDPCommunityConfiguration.iReplyEditAllowed = <#Bool#>; 
            ZDPCommunityConfiguration.isReplyDeleteAllowed = <#Bool#>;
         
      
      

   

      
         
            ZohoDeskPortalSDK.Community.getMostPopularTopics(<#[String:Any]?#>) { (result: Result<[ZDPCommunity.TopicDetail], ZDPError>) in
            　　 // switch on result to get array of topics on success 
            }
         
      
      

   

      
         
            [ZohoDeskPortalSDKCommunity getMostPopularTopics:<#(NSDictionary * _Nullable)#>onCompletion:^(NSArray * topics, NSError * error) {
            　　　 // on success, topics will return an array, error will return nil
            　　　 // on failure, error will return a value, topics will return nil 
            }];
         
      
      

   

1. categoryId - string：トピックを取得するコミュニティのカテゴリーのIDです。すべてのカテゴリーを追加する場合、値に「-1」を指定します。
   
2. filterType - string：フォーラムのトピックの種類です。指定可能な値は次のとおりです： QUESTION 、 IDEA 、 ANNOUNCEMENT 、 PROBLEM 、 DISCUSSION
   
3. from - int：インデックス番号です。この番号からトピックのデータを取得します。値は「1」から開始できます。
   
4. limit - int：取得するトピックの件数です。
   
5. includeCount - Boolean：取得したトピックの件数を表示するかどうかを指定するパラメーターです。
   

      
         
            ZohoDeskPortalSDK.Community.getMostDiscussedTopics(<#[String:Any]?#>) { (topics, error) in
            　　 // on success, topics will return an array, error will return nil
            　　 // on failure, error will return a value, products will return nil 
            }
         
      
      

   

      
         
            [ZohoDeskPortalSDKCommunity getMostDisuccedTopics:<#(NSDictionary * _Nullable)#>onCompletion:^(NSArray * topics, NSError * error) {
            　　　 // on success, topics will return an array, error will return nil
            　　　 // on failure, error will return a value, topics will return nil 
            }];
         
      
      

   

1. categoryId - string：トピックを取得するコミュニティのカテゴリーのIDです。すべてのカテゴリーを追加する場合、値に「-1」を指定します。
   
2. filterType - string：フォーラムのトピックの種類です。指定可能な値は次のとおりです： QUESTION 、 IDEA 、 ANNOUNCEMENT 、 PROBLEM 、 DISCUSSION
   
3. from - int：インデックス番号です。この番号からトピックのデータを取得します。値は「1」から開始できます。
   
4. limit - int：取得するトピックの件数です。
   
5. includeCount - Boolean：取得したトピックの件数を表示するかどうかを指定するパラメーターです。
   

問い合わせタブのカスタマイズ

      
         
            ZDPortalSubmitTicket.setFieldsListTobeShown(fields: <#[ZDVisibleTicketField]#>)
         
      
      

   

      
         
            [ZDPortalSubmitTicket setFieldsListTobeShownWithFields:<#(NSArray * _Nonnull)#>];
         
      
      

   

      
         
            ZDPortalSubmitTicket.preFillTicketFields(forForms: <#[ZDCustomizedTicketForm]#>)
         
      
      

   

      
         
            [ZDPortalSubmitTicket preFillTicketFieldsForForms:<#[ZDCustomizedTicketForm]#>];
         
      
      

   

1. fieldApiName - string：問い合わせ項目の「apiName」です。それぞれの項目の「apiName」を取得するには、「 getTicketForm() 」メソッドを使用します。
   
2. fieldValue - object：
   
   1. 複数選択項目の場合、選択可能な文字列の値をコンマ区切りで指定します。
      
   2. 選択リスト項目の場合、選択可能な文字列の値のいずれかを指定します。
      
   3. 日付項目の場合、文字列の値を「 MM/dd/yyyy 」形式で指定します。
      
   4. 日時項目の場合、文字列の値を「 MM-dd-yyyy hh:mm aa 」形式で指定します。
      
   5. 真偽値項目の場合、文字列の値（「true」または「false」）を指定します。
      
   6. 他の項目の場合、文字列の値を指定します。
      
   7. こちらで指定した値が、項目で設定されている文字数や小数点の上限内になるようにしてください。
      
3. isEditable - Boolean：対象の項目が編集可能かどうかを指定するキーです。
   

メモ ：詳細については、 こちら をご確認ください。

      
         
            ZDPTicketConfiguration.isCommentAllowed = <#Bool#> 
            ZDPTicketConfiguration.isCommentDeleteAllowed = <#Bool#> 
            ZDPTicketConfiguration.isCommentEditAllowed = <#Bool#> 
            ZDPTicketConfiguration.isReplyAllowed = <#Bool#> 
            ZDPTicketConfiguration.isTicketUpdateAllowed = <#Bool#>
         
      
      

   

      
         
            ZDPTicketConfiguration.isCommentAllowed = YES; 
            ZDPTicketConfiguration.isCommentDeleteAllowed = YES; 
            ZDPTicketConfiguration.isCommentEditAllowed = YES; 
            ZDPTicketConfiguration.isReplyAllowed = YES; 
            ZDPTicketConfiguration.isTicketUpdateAllowed = YES;
         
      
      

   

その他

      
         
            import ZohoDeskPortalAPIKit 
            ... var body = [String : Any]() 
            body["displayName"] = "displayName" 
            body["mobile"] = "123456" 
            ZohoDeskPortalSDK.updateUserInformation(with: body) { (profile, error) in {
            　　 // on success only profile will return a value, error will return nil
            　　 // on failure only error will return a value, profile will return nil 
            }
         
      
      

   

      
         
            NSMutableDictionary * body = [NSMutableDictionary new]; 
            [body setObject:@"displayName" forKey:@"displayName"]; 
            [body setObject:@"123456" forKey:@"mobile"]; 
            [ZohoDeskPortalSDK updateUserInformationWith:body onCompletion:^(Profile * profile, NSError * error) {
            　　 // on success only profile will return a value, error will return nil
            　　 // on failure only error will return a value, profile will return nil 
            }];
         
      
      

   

SDKのログ

      
         
            import ZohoDeskPortalAPIKit 
            ...
            ZohoDeskPortalSDK.disableLogs()
         
      
      

   

      
         
            @import ZohoDeskPortalAPIKit; 
            ...
            [ZohoDeskPortalKit disableLogs]
         
      
      

   

リリースノート

• 複数言語のナレッジベースの設定に対応しました。
  
• iOS 14に対応しました。
  
• 問い合わせの追加タブにて、条件付きレイアウトと問い合わせテンプレートが利用できるようになりました。
  
• 利用可能なすべてのAPIを含む別のフレームワークとして、APIプロバイダーを追加しました。操作画面をカスタマイズして、APIを組み込めるようになりました。
  
• ダークモードに対応しました。
  
• システムにて設定されているフォントサイズに適合させることで、SDKのテキストをより便利に利用できるようにしました。
  
• iOS 11以降にて、件名をより大きく表示できるオプションを追加しました。
  
• iOS 11以降にて、ナビゲーションバーに検索バーを埋め込みました。
  

SDKバージョン1.0

はじめに

• カスタマーサポートチームへの問い合わせ（問い合わせの送信、サポート担当者とのチャット）
  
• ナレッジベース（ヘルプ記事へのアクセス）
  
• ユーザーコミュニティ（アプリを通じた他の顧客とやりとり）
  

Zoho DeskでのSDKの設定

1. Zoho Deskで、 ［設定］ > ［チャネル］ > ［どこでもサポート］ の順に移動します。
   
2. 左側の 設定 メニューの どこでもサポート にて、 モバイル の隣にある ［+］ ボタンをクリックします。 モバイルアドオンの作成 画面が表示されます。 
   
   
   
   

   
   
3. ［アドオンの詳細］ で、以下の内容を設定します：
   
   • 名前： どこでもサポートのアドオンの名前です。この名前は参照用です。アプリの操作画面上には表示されません。
     
   • 有効 ：どこでもサポートのアドオンを有効にする部門を選択します。
     
   • バンドルID： iOS の項目に、iOSアプリのバンドルIDを入力します。（対象のアプリの設定内にある 一般 タブでバンドルIDを確認できます。）
     
     メモ ：チャット機能を有効にしたり、プッシュ通知を送信したりするには、バンドルIDが必須です。
     
   • チャット： 切り替えボタンを操作することで、チャット機能を有効または無効にできます。
     
     メモ ：チャットの項目には、ポータルのチャットチャネルにて設定された内容が反映されます。そのため、設定を変更するには、Zoho Deskの設定画面で行う必要があります。
     
   • プッシュ通知： 切り替えボタンを操作することで、プッシュ通知を有効または無効にできます。詳細については、このドキュメントの「通知の有効化」セクションをご参照ください。
     
     メモ ：通知を有効にするには、JWT方式でのユーザー認証が必須となります。匿名ユーザーに対して、問い合わせに関するプッシュ通知を送信することはできません。
     
   • 認証方法： このアドオンにおけるユーザーの認証方法を設定します。
     
     • 匿名： この方法では、エンドユーザーはゲストユーザーとみなされます。ゲストユーザーが行える操作は、問い合わせの送信、ユーザーコミュニティでの投稿内容の表示、サポート担当者とのチャット、に限定されます。自分が送信した問い合わせを表示したり、ユーザーコミュニティに参加したりすることはできません。
       
     • JWT ： この方法では、エンドユーザーは認証済みユーザーとみなされます。ゲストユーザーが行える操作に加えて、認証済みユーザーは、自分が送信した問い合わせのステータスを表示したり、問い合わせに返信/コメントしたり、ユーザーコミュニティに参加したりすることもできます。コミュニティでは、トピックのフォロー、トピックの追加、既存の投稿へのコメントの追加など、さまざまな操作を行うことができます。
       
4. ［保存］ をクリックします。
   

SDKとアプリとの連携

1. ターミナルで、プロジェクトの最上位のフォルダーに移動します（ xcodeproj ファイルが含まれるフォルダーです）。
   
2. コマンド「 $ pod init 」を実行します。
   
3. 次に、コマンド「 open -a Xcode Podfile 」を実行して、XcodeのPodfileを開きます。ファイルの内容が以下のように表示されます：
   

               
                  
                     # Uncomment this line to define a global platform for your project 
                     # platform :ios, '9.0' 
                     # Uncomment this line if you're using Swift 
                     # use_frameworks! 
                     target 'My Sample App' do 
                     end
                  
               
               
   
            

4. Swiftを利用する場合は、「 use_frameworks! 」の行に何も入力しないでください。
   

1. 以下のコードをPodfileのdoブロックに追加します。
   

               
                  
                     target 'My Sample App' do
                     pod 'ZohoDeskPortalSDK', :git => '
                     
                        https://github.com/zoho/ZohoDeskPortalSDK.git
                     
                     ' 
                     end
                  
               
               
   
            

2. Podfileを保存します。
   
3. ターミナルで、コマンド「 $ pod install 」を実行します。
   

メモ  

アプリの開発にSwiftを使用する場合、利用中のXcodeのバージョンに応じてPodfileに以下のいずれかの行を追加する必要があります。

• バージョン10.0、または10.1のXcodeの場合、以下のコードを追加します：
  
  pod 'ZohoDeskPortalSDK', :git => ' https://github.com/zoho/ZohoDeskPortalSDK.git ', :branch => 'Xcode_10.0'
  
• バージョン10.2のXcodeの場合、以下のコードを追加します：
  
  pod 'ZohoDeskPortalSDK', :git => ' https://github.com/zoho/ZohoDeskPortalSDK.git '
  

1. ZohoDeskPortalSDKを こちらのリンク から、Mobilisten SDKを こちらのリンク からそれぞれダウンロードします。
   
2. ダウンロードしたzipファイルを解凍します。次に、 ZohoDeskPortalSDK.framework 、 Mobilisten.framework ファイルをXcodeのプロジェクトの Embedded Binaries セクションにドラッグ＆ドロップします。
   
3. アプリ内の対象となる Build Phases タブにて、新しい実行スクリプトフェーズを作成します。以下のコードを、表示された実行スクリプトのテキスト項目に貼り付けます。（このスクリプトは Build Phases タブの後部に表示されますのでご注意ください。） 
   

               
                  
                     bash "${BUILT_PRODUCTS_DIR}/${FRAMEWORKS_FOLDER_PATH}/
                     
                        ZohoDeskPortalSDK.framework/strip-frameworks.sh
                     
                     "
                  
               
               
   
            

   このスクリプトは、App Storeに送信されたアプリ内のUniversal Binaryのアーカイブに関するバグの解決に役立ちます。アプリに設定されている VALID_ARCHS ビルドに、リリース時の設定である i386 、 x86_64 が含まれていないことを確認してください。 
   

メモ ： NSPhotoLibraryUsageDescription 、 NSCameraUsageDescription 、 NSBluetoothPeripheralUsageDescription キーを、アプリ内の info.plist ファイルに追加してください。 

アプリ内のSDKの初期設定

• 組織ID（Org ID）
  
• アプリID（App ID）
  
• データセンター（Datacenter）
  

1. Zoho DeskポータルのSDKフレームワークを、プロジェクトの AppDelegate ファイル内にインポートします。
   
   Swift
   

               
                  
                     import ZohoDeskPortalSDK
                  
               
               
   
            

   Objective-C
   

               
                  
                     @import ZohoDeskPortalSDK;
                  
               
               
   
            

2. 以下の初期化コードを、引数「 didFinishLaunchingWithOptions 」を持つアプリケーションのメソッド内に貼り付けます。
   
   Swift
   

               
                  
                     func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?)-> Bool {
                     　 let config = ZDPortalConfiguration()
                     　 config.enableHelpCenter = true
                     　 config.enableCreateTicket = true
                     　 config.enableMyTicket = true
                     　 config.enableCommunity = false
                     　 ZohoDeskPortalSDK.initializeSDK(<#ORGID#>, appId: <#APPID#>, dataCenter: <#dataCenterValue#>, configuration: <#config#>)
                     　 return true 
                     }
                  
               
               
   
            

   Objective-C
   

               
                  
                     - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
                     　　　 ZDPortalConfiguration * config = [[ZDPortalConfiguration alloc]init];
                     　　　 config.enableHelpCenter = YES;
                     　　　 config.enableCommunity = YES;
                     　　　 config.enableCreateTicket = YES;
                     　　　 config.enableMyTicket = YES;
                     　　　 [ZohoDeskPortalSDK initializeSDK:<#ORGID#> appId:<#APPID#> dataCenter:<#dataCenterValue#> configuration:<#config#>];
                     　　　 return YES; 
                     }
                  
               
               
   
            

メモ

：配置の種類の応じたデータセンターの値は、以下のとおりです：

CN：ZDDataCenter.CN

EU：ZDDataCenter.EU

US：ZDDataCenter.US

IN：ZDDataCenter.IN

ヘルプ項目の表示

メモ ：初期設定では、SDKの操作画面にてチャット機能は無効になっています。利用するには、はじめにZoho Deskのポータルでチャット機能を有効にする必要があります。

      
         
            ZohoDeskPortalSDK.showHomePage(controller: self)
         
      
      

   

      
         
            [ZohoDeskPortalSDK showHomePageWithController:self];
         
      
      

   

      
         
            let config = ZDPortalConfiguration()
            config.enableHelpCenter = true // disable/enable the Help center (Knowledge Base). 
            config.enableCommunity = false // disable/enable the Community. 
            config.enableCreateTicket = true // disable/enable the CreateTicket. 
            config.enableMyTicket = true // disable/enable My Tickets.
            ZohoDeskPortalSDK.showHomePage(controller: self, withConfiguration: config)
         
      
      

   

      
         
            ZDPortalConfiguration * 
            config = [[ZDPortalConfiguration alloc]init]; 
            config.enableHelpCenter = YES; // disable/enable the Help center (Knowledge Base). 
            config.enableCommunity = NO; // disable/enable the Community. 
            config.enableCreateTicket = YES; // disable/enable the CreateTicket. 
            config.enableMyTicket = YES; // disable/enable My Tickets.
            [ZohoDeskPortalSDK showHomePageWithController:self withConfiguration:config];
         
      
      

   

      
         
            ZohoDeskPortalSDK.showLiveChat(controller: self)
         
      
      

   

      
         
            [ZohoDeskPortalSDK showLiveChatWithController:self];
         
      
      

   

      
         
            ZohoDeskPortalSDK.showHelpCenter(controller: self)
         
      
      

   

      
         
            [ZohoDeskPortalSDK showHelpCenterWithController:self];
         
      
      

   

      
         
            ZohoDeskPortalSDK.addTicket(controller: self)
         
      
      

   

      
         
            [ZohoDeskPortalSDK addTicketWithController:self];
         
      
      

   

      
         
            ZohoDeskPortalSDK.addTicket(controller: self, onCompletion: { (ticketDetail) in
            　 // The ticketDetail parameter contains the details of the ticket created.
            　　// Your program logic goes here.
            }) { (error) in
            　 // error creating Ticket 
            }
         
      
      

   

      
         
            [ZohoDeskPortalSDK addTicketWithController:self onCompletion:^(TicketDetailJsonObject * ticket) {
            　　 // The ticketDetail parameter contains the details of the ticket created.
            　　　// Your program logic goes here.
            } onError:^(NSError * error) {
            　 　// error creating Ticket 
            }];
         
      
      

   

メモ ：認証済みユーザーによって問い合わせが送信されると、問い合わせのすべての詳細情報がアプリに送信されます。ゲストユーザーによって問い合わせが送信されると、問い合わせ番号のみが送信されます。

      
         
            ZohoDeskPortalSDK.ticketList(controller: self)
         
      
      

   

      
         
            [ZohoDeskPortalSDK ticketListWithController:self];
         
      
      

   

      
         
            ZohoDeskPortalSDK.showCommunity(controller: self)
         
      
      

   

      
         
            [ZohoDeskPortalSDK showCommunityWithController:self];
         
      
      

   

SDKでのユーザー認証

• 匿名： この方法では、エンドユーザーはゲストユーザーとみなされます。ゲストユーザーが行える操作は、問い合わせの送信、ユーザーコミュニティでの投稿内容の表示、サポート担当者とのチャット、に限定されます。自分が送信した問い合わせを表示したり、ユーザーコミュニティに参加したりすることはできません。
  
• JWT： この方法では、エンドユーザーは認証済みユーザーとみなされます。ゲストユーザーが行える操作に加えて、認証済みユーザーは、自分が送信した問い合わせを表示したり、ユーザーコミュニティに参加したりすることもできます。コミュニティでは、トピックのフォロー、トピックの追加、既存の投稿へのコメントの追加など、さまざまな操作を行うことができます。
  

      
         
            if !ZohoDeskPortalSDK.isZDUserSignedIn{
            　 ZohoDeskPortalSDK.set(jwtUserIdentifier: <#Remote user Token#>, onCompletion: {
            　 }, onError: { (error) in
            　 }) 
            }else{
            　 //User already signed into SDK 
            }
         
      
      

   

      
         
            if (![ZohoDeskPortalSDK isZDUserSignedIn]){
            　 [ZohoDeskPortalSDK setWithJwtUserIdentifier:<#Remote user Token#> onComplition:^{
            　 } onError:^(NSError * error) {
            　 }]; 
            }else{
            　　 //User already signed into SDK 
            }
         
      
      

   

• 真偽値が「true」を返す場合、ユーザーはアドオンの認証ユーザーとしてタスクを行うことができます。
  
• 真偽値が「false」を返す場合、 ZohoDeskPortalSDK.set によってユーザーにログインするように促されます。
  

      
         
            ZohoDeskPortalSDK.logout()
         
      
      

   

      
         
            [ZohoDeskPortalSDK logout];
         
      
      

   

ローカルデータのクリア

      
         
            ZohoDeskPortalSDK.clearAllLocalData()
         
      
      

   

      
         
            [ZohoDeskPortalSDK clearAllLocalData];
         
      
      

   

ヘルプ項目の非表示

      
         
            let config = ZDPortalConfiguration() 
            config.enableHelpCenter = false // disable the Help center (Knowledge Base). 
            config.enableCommunity = false // disable the Community. 
            config.enableCreateTicket = false // disable the CreateTicket. 
            config.enableMyTicket = false // disable My Tickets. 
            config.showLeftMenu = true // enable/disable left Menu
         
      
      

   

      
         
            ZDPortalConfiguration * config = [[ZDPortalConfiguration alloc]init]; 
            config.enableHelpCenter = NO; // disable the Help center (Knowledge Base). 
            config.enableCommunity = NO; // disable the Community. 
            config.enableCreateTicket = NO; // disable the CreateTicket. 
            config.enableMyTicket = NO; // disable My Tickets. 
            config.showLeftMenu = YES; // enable/disable left Menu
         
      
      

   

メモ ：「 ZohoDeskPortalSDK.initializeSDK 」関数に設定したオブジェクトを送信する必要があります。詳細については、このドキュメントの「 アプリ内のSDKの初期設定 」セクションをご参照ください。

アドオンの操作画面のカスタマイズ

      
         
            ZDTheme.applyTheme(theme: .white)
         
      
      

   

      
         
            [ZDTheme applyThemeWithTheme:ZDThemeTypeWhite];
         
      
      

   

      
         
            ZDTheme.applyTheme(theme: .dark)
         
      
      

   

      
         
            [ZDTheme applyThemeWithTheme:ZDThemeTypeDark];
         
      
      

   

      
         
            let articleTheme = ZDThemeArticle.init() 
            articleTheme.tintColor = UIColor.white 
            articleTheme.primaryTextColor = UIColor.white 
            articleTheme.secondryTextColor = UIColor(red:0.12, green:0.13, blue:0.15, alpha:1.00) 
            articleTheme.primaryBackgroundColor = UIColor(red:0.12, green:0.13, blue:0.15, alpha:1.00) 
            articleTheme.secondryBackgroundColor = UIColor(red:0.12, green:0.13, blue:0.15, alpha:1.00) 
            articleTheme.cellSeporatorColor = UIColor(red:0.12, green:0.13, blue:0.15, alpha:1.00) 
            articleTheme.headerColor = UIColor(red:0.13, green:0.18, blue:0.15, alpha:1.00)
         
      
      

   

      
         
            ZDThemeArticle * articleTheme = [ZDThemeArticle init]; 
            articleTheme.tintColor = [UIColor whiteColor]; 
            articleTheme.primaryTextColor = [UIColor whiteColor]; 
            articleTheme.secondryTextColor = [UIColor colorWithRed:0.12 green:0.13 blue:0.15 alpha:1.00]; 
            articleTheme.primaryBackgroundColor = [UIColor colorWithRed:0.12 green:0.13 blue:0.15 alpha:1.00]; 
            articleTheme.secondryBackgroundColor = [UIColor colorWithRed:0.12 green:0.13 blue:0.15 alpha:1.00]; 
            articleTheme.cellSeporatorColor = [UIColor colorWithRed:0.12 green:0.13 blue:0.15 alpha:1.00]; 
            articleTheme.headerColor = [UIColor colorWithRed:0.12 green:0.13 blue:0.15 alpha:1.00];
         
      
      

   

メモ ：同様に、記事の一覧画面や問い合わせの送信画面のテーマをカスタマイズすることもできます。テーマをカスタマイズすると、SDKのテーマが上書きされますのでご注意ください。

      
         
            ZDNavigationTheme.navigationBarColor = UIColor.blue 
            ZDNavigationTheme.titleColor = UIColor.white 
            ZDNavigationTheme.barButtonTextColor = UIColor.white 
            ZDNavigationTheme.translucent = false 
            ZDNavigationTheme.statusBarApperance = .lightContent 
            ZDNavigationTheme.backButtonStyle = ZDNavigationBackButtonStyle.icon
         
      
      

   

      
         
            [ZDNavigationTheme setNavigationBarColor:[UIColor blueColor]]; 
            [ZDNavigationTheme setTitleColor:[UIColor blueColor]]; 
            [ZDNavigationTheme setBarButtonTextColor:[UIColor blueColor]]; 
            [ZDNavigationTheme setTranslucent:NO]; 
            [ZDNavigationTheme setStatusBarApperance:UIStatusBarStyleLightContent]; 
            [ZDNavigationTheme setBackButtonStyle:ZDNavigationBackButtonStyleIcon];
         
      
      

   

1. プロジェクトにフォントを追加します。
   
2. アプリの「info.plist」ファイルを編集して、 アプリケーションキーが提供するフォント を追加します。
   
3. このキーには、SDKの操作画面で使用するすべてのフォントの名前が表示されます。
   

      
         
            let font = ZDCustomFont() 
            font.fontFamilyName = "ProximaNova" 
            font.regularFontName = "ProximaNova-reg" 
            font.lightFontName = "ProximaNova-light" 
            font.boldFontName = "ProximaNova-Bold" 
            font.mediumFontName = "ProximaNova-Bold"
         
      
      

   

      
         
            ZDCustomFont * font = [ZDCustomFont init]; 
            font.fontFamilyName = @"ProximaNova"; 
            font.regularFontName = @"ProximaNova-reg"; 
            font.lightFontName = @"ProximaNova-light"; 
            font.boldFontName = @"ProximaNova-Bold"; 
            font.mediumFontName = @"ProximaNova-Bold";
         
      
      

   

メモ ：カスタムフォントを使用しない場合、初期設定ではシステムのフォントが表示されます。

言語設定の変更

      
         
            ZDPortalConfiguration.setSDKLanguage = "en"
         
      
      

   

      
         
            ZDPortalConfiguration.setSDKLanguage = @"en";
         
      
      

   

操作画面上の文字列のカスタマイズ

1. 「 ASAPStrings.bundle 」という件名のバンドルを、アプリのXcodeのプロジェクトに作成します。このバンドルへのアクセスパスは、次のとおりです：Application-bundle/ASAPStrings.bundle.
   
2. こちらのリンク から、SDKの操作画面に表示される初期設定の文字列が含まれる「lproj」ファイルをダウンロードします。
   
3. ダウンロードした「lproj」ファイルを、「 ASAPStrings 」バンドルに追加します。
   
4. 「lproj」ファイル内で「 ASAPLocalizable.strings 」ファイルを開き、必要に応じてテキストをカスタマイズします。
   

メモ ：言語が複数ある場合は、それぞれに「lproj」ファイルが必要です。SDKで複数の言語を表示する場合、文字列をカスタマイズするには、手順2で対応する「lproj」ファイルを選択し、手順3、４を繰り返します。

通知の有効化

1. Appleの開発者ポータルでAPNs証明書を作成し、ダウンロードします。
   
2. 証明書をダブルクリックします。ダブルクリックすると、自動的に証明書がキーチェーンアクセスアプリケーションにインポートされます。
   
3. キーチェーンアクセス内の証明書を開きます。証明書に対応するキーが表示されます。
   
4. 証明書とキーを選択して、右クリックします。コンテキストメニューが表示されます。
   
5. エクスポートオプションをクリックします。ダイアログボックスが表示されます。
   
6. ダイアログボックスの File Format のドロップダウンで .p12 が選択されていることを確認し、［ 保存 ］をクリックします。 
   
7. ファイルにアクセスするためのパスワードを入力して、［ OK ］をクリックします。証明書が.p12ファイルとしてエクスポートされました。 
   

      
         
            func application(_ application: UIApplication,didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data) {
            　 let token = deviceToken.reduce("", {$0 + String(format: "%02X", $1)}).uppercased()
            　 ZohoDeskPortalSDK.enablePushNotification(deviceToken:token, mode: .production) 
            }
         
      
      

   

      
         
            - (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken{
            　　　 NSString * token = [[[[deviceToken description]
            　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　 stringByReplacingOccurrencesOfString: @"<" withString: @""]
            　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　 stringByReplacingOccurrencesOfString: @">" withString: @""]
            　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　 stringByReplacingOccurrencesOfString: @" " withString: @""];
            　　　 [ZohoDeskPortalSDK enablePushNotificationWithDeviceToken:token isTestDevice:NO mode:APNSModeProduction]; 
            }
         
      
      

   

メモ

• 開発モードで機能をテストして、通知が正しく送信されるかどうか検証することができます。開発モードに切り替えるには、上記のコードの「.production」を「.sandbox」に変更します。
  
• エンドユーザーに対してアプリを公開する前に、必ず本番環境モードに切り替えてください。
  

      
         
            func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable : Any]) {
            　 ZohoDeskPortalSDK.processRemoteNotification(userInfo: userInfo)  
            }
         
      
      

   

      
         
            - (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo fetchCompletionHandler:(void (^)(UIBackgroundFetchResult))completionHandler{
            　　　 [ZohoDeskPortalSDK processRemoteNotificationWithUserInfo:userInfo]; 
            }
         
      
      

   

担当者に対する匿名ユーザーの詳細データの表示

      
         
            ZDPortalConfiguration.setGuestUser(email: <#Guest_User_Email#>, displayName: <#Guest_User_DisplayName#>", phoneNumber: <#Guest_User_PhoneNumber#>")
         
      
      

   

      
         
            [ZDPortalConfiguration setGuestUserWithEmail:<#Guest_User_Email#> displayName:<#Guest_User_DisplayName#> phoneNumber:<#Guest_User_PhoneNumber#>];
         
      
      

   

プログラムによる問い合わせの追加

      
         
            ZDProvoider.sharedInstance.getDepartments(onCompletion: { (departments) in
            // get departments list in departments variable 
            }) { (error) in
            　　　 // error in departments fetch 
            }
         
      
      

   

      
         
            [[ZDProvoider sharedInstance] getDepartmentsOnCompletion:^(NSArray<DepartmentJsonObject *> * departments) {
            　　　 // get departments list in departments variable 
            } onError:^(NSError * error) {
            　　　 // error in departments fetch 
            }];
         
      
      

   

      
         
            ZDProvoider().getProductsFor(<#Department ID#>, from: <#T##Int#>, limit: <#T##Int#>, onCompletion: { (products) in
            　　　 // get products list in products variable 
            }) { (error) in
            　　　 // error in products fetch 
            }
         
      
      

   

      
         
            [ZDProvoider sharedInstance] getProductsFor:@"Department ID" from:<#(NSInteger)#> limit:<#(NSInteger)#> onCompletion:^(NSArray products) {
            　　　 // get products list in products variable 
            } onError:^(NSError * error) {
            　　　 // error in products fetch 
            }
         
      
      

   

      
         
            ZDProvoider.sharedInstance.getTicketForm(<#Department ID#>, onCompletion: { (ticketFilelds) in
            　　 // get Ticket Form in ticketFilelds variable 
            }) { (error) in
            　　 // error in TicketForm fetch 
            }
         
      
      

   

      
         
            [[ZDProvoider sharedInstance] getTicketForm:<#Department ID#> onCompletion:^(NSArray<TicketFieldsJsonObject *> * ticketFilelds) {
            　　　 // get Ticket Form in ticketFilelds variable 
            } onError:^(NSError * error) {
            　　 // error in TicketForm fetch 
            }];
         
      
      

   

      
         
            ZDProvoider.sharedInstance.uploadTicketAttachment(<#Your File path#>, onCompletion: { (attachement) in
            　　　 // get uploaded attachement object in attachement variable 
            }) { (error) in
            　　　 // error in Attachement upload 
            }
         
      
      

   

      
         
            [[ZDProvoider sharedInstance] uploadTicketAttachment:<#Your File path#> onCompletion:^(AttachmentJsonObject * attachement) {
            　　　 // get Ticket Form in ticketFilelds variable 
            } onError:^(NSError * error) {
            　　 // error in Attachement upload 
            }];
         
      
      

   

      
         
            let ticketForm = ZDTicketForm() 
            ticketForm.emailID = <#User email ID#> 
            ticketForm.contactName = <#Contact Name#> 
            ticketForm.subject = <#Ticket Subject#> 
            ticketForm.departmentID = <#Ticket Department ID#> 
            ticketForm.descriptionText = <#Ticket Description Text#> 
            ZDProvoider.sharedInstance.createTicket(form: ticketForm, onCompletion: { (ticket) in
            　　　 // get created ticket object in ticketDetail variable 
            }) { (error) in
            　　　 // error in ticket submission 
            }
         
      
      

   

      
         
            ZDTicketForm * ticketForm = [ZDTicketForm init]; 
            [ticketForm setEmailID:<#User email ID#>]; 
            [ticketForm setContactName:<#Contact Name#>]; 
            [ticketForm setSubject:<#Ticket Subject#>]; 
            [ticketForm setDepartmentID:<#Ticket Department ID#>]; 
            [ticketForm setDescriptionText:<#Ticket Description Text#>]; 
            [[ZDProvoider sharedInstance] createTicketWithForm:ticketForm onCompletion:^(TicketDetailJsonObject * ticket) {
            　　　 // get created ticket object in ticketDetail variable 
            } onError:^(NSError * error) {
            　　 // error in ticket submission 
            }]
         
      
      

   

ナレッジベース

      
         
            ZohoDeskPortalSDK.showCatgoryByPermalink(forPermaLink:"permalink", controller: self)
         
      
      

   

      
         
            [ZohoDeskPortalSDK showCatgoryByPermalinkForPermaLink:@"permalink" controller:self];
         
      
      

   

1. 「self」は、「UIViewController」のインスタンスです。
   
2. パーマリンクが対象のナレッジベースのカテゴリーのURLを指すようになります。
   

      
         
            ZohoDeskPortalSDK.showHelpPage(forPermaLink: "permalink", controller: self)
         
      
      

   

      
         
            [ZohoDeskPortalSDK showHelpPageForPermaLink:@"permalink" controller:self];
         
      
      

   

1. 「self」は、「UIViewController」のインスタンスです。
   
2. パーマリンクが対象のヘルプ記事のURLを指すようになります。
   

コミュニティ

      
         
            ZDCommunityConfiguration.configure.isTopicDeleteAllowed = true 
            ZDCommunityConfiguration.configure.isTopicEditAllowed = true 
            ZDCommunityConfiguration.configure.isReplyDeleteAllowed = true 
            ZDCommunityConfiguration.configure.isReplyEditAllowed = true 
            ZDCommunityConfiguration.configure.isReplyAllowed = true
         
      
      

   

      
         
            [ZDCommunityConfiguration configure].isTopicDeleteAllowed = YES; 
            [ZDCommunityConfiguration configure].isTopicEditAllowed = YES; 
            [ZDCommunityConfiguration configure].isReplyDeleteAllowed = YES; 
            [ZDCommunityConfiguration configure].isReplyEditAllowed = YES; 
            [ZDCommunityConfiguration configure].isReplyAllowed = YES;
         
      
      

   

      
         
            ZDProvoider.sharedInstance.getZDMostPopularCommunityTopics(forCategory: "Your Category ID", filterType: "ALL", from: 1, limit: 10, includeCount: false, { (communityTopics) in
            　　　 // get most popular topic list in communityTopics callback 
            }) { (error) in
            　　 // error 
            }
         
      
      

   

      
         
            [[ZDProvoider sharedInstance] getZDMostPopularCommunityTopicsForCategory:@"Your Catehory ID" filterType:@"ALL" from:1 limit:10 includeCount:NO :^(NSArray communityTopics) {
            　　　 // get most popular topic list in communityTopics callback 
            } onError:^(NSError * error) {
            　　 　// error 
            }];
         
      
      

   

1. categoryId - string：トピックを取得するコミュニティのカテゴリーのIDです。すべてのカテゴリーを追加する場合、値に「-1」を指定します。
   
2. filterType - string：フォーラムのトピックの種類です。指定可能な値は次のとおりです： QUESTION 、 IDEA 、 ANNOUNCEMENT 、 PROBLEM 、 DISCUSSION
   
3. from - int：インデックス番号です。この番号からトピックのデータを取得します。値は「1」から開始できます。
   
4. limit - int：取得するトピックの件数です。
   
5. includeCount - Boolean：取得したトピックの件数を表示するかどうかを指定するパラメーターです。
   

      
         
            ZDProvoider.sharedInstance.getZDMostDiscussedCommunityTopics(forCategory: "Your Category ID", filterType: "ALL", from: 1, limit: 10, includeCount: false, { (communityTopics) in
            　　　 // get most discussed topic list in communityTopics callback 
            }) { (error) in
            　　　 // error 
            }
         
      
      

   

      
         
            [[ZDProvoider sharedInstance] getZDMostDiscussedCommunityTopicsForCategory:@"Your Catehory ID" filterType:@"ALL" from:1 limit:10 includeCount:NO :^(NSArray communityTopics) {
            　　　 // get most discussed topic list in communityTopics callback 
            } onError:^(NSError * error) {
            　　　// error 
            }];
         
      
      

   

1. categoryId - string：トピックを取得するコミュニティのカテゴリーのIDです。すべてのカテゴリーを追加する場合、値に「-1」を指定します。
   
2. filterType - string：フォーラムのトピックの種類です。指定可能な値は次のとおりです： QUESTION 、 IDEA 、 ANNOUNCEMENT 、 PROBLEM 、 DISCUSSION
   
3. from - int：インデックス番号です。この番号からトピックのデータを取得します。値は「1」から開始できます。
   
4. limit - int：取得するトピックの件数です。
   
5. includeCount - Boolean：取得したトピックの件数を表示するかどうかを指定するパラメーターです。
   

問い合わせ

1. fieldApiName - string：問い合わせ項目の「apiName」です。それぞれの項目の「apiName」を取得するには、「 getTicketForm() 」メソッドを使用します。
   
2. fieldValue - object：
   
   • 複数選択項目の場合、選択可能な文字列の値をコンマ区切りで指定します。
     
   • 選択リスト項目の場合、選択可能な文字列の値のいずれかを指定します。
     
   • 日付項目の場合、文字列の値を「 MM/dd/yyyy 」形式で指定します。
     
   • 日時項目の場合、文字列の値を「 MM-dd-yyyy hh:mm aa 」形式で指定します。
     
   • 真偽値項目の場合、文字列の値（「true」または「false」）を指定します。
     
   • 他の項目の場合、文字列の値を指定します。
     
   • こちらで指定した値が、項目で設定されている文字数や小数点の上限内になるようにしてください。
     
3. isEditable - Boolean：対象の項目が編集可能かどうかを指定するキーです。
   

メモ ：詳細については、 こちら をご確認ください。

      
         
            ZDTicketConfiguration.configure.isCommentAllowed = true 
            ZDTicketConfiguration.configure.isCommentDeleteAllowed = true 
            ZDTicketConfiguration.configure.isCommentEditAllowed = true 
            ZDTicketConfiguration.configure.isReplyAllowed = true 
            ZDTicketConfiguration.configure.isTicketUpdateAllowed = true
         
      
      

   

      
         
            ZDTicketConfiguration.configure.isCommentAllowed = YES; 
            ZDTicketConfiguration.configure.isCommentDeleteAllowed = YES; 
            ZDTicketConfiguration.configure.isCommentEditAllowed = YES; 
            ZDTicketConfiguration.configure.isReplyAllowed = YES; 
            ZDTicketConfiguration.configure.isTicketUpdateAllowed = YES;
         
      
      

   

その他

      
         
            var body = [String : Any]() 
            body["displayName"] = "displayName" 
            body["mobile"] = "123456" 
            ZDProvoider.sharedInstance.UpdateUserInformation(userInfo: body, { (userInfo) in
            // get updated user information in userInfo variable 
            }) { (error) in
            // error 
            }
         
      
      

   

      
         
            NSMutableDictionary * body = [NSMutableDictionary new]; 
            [body setObject:@"displayName" forKey:@"displayName"]; 
            [body setObject:@"123456" forKey:@"mobile"]; 
            [[ZDProvoider sharedInstance] UpdateUserInformationWithUserInfo:body :^(NSDictionary * userInfo) {
            // get updated user information in userInfo variable 
            } onError:^(NSError * error) {
            // error 
            }];
         
      
      

   

SDKのログ

      
         
            ZDPortalConfiguration.enableLogMessages = true
         
      
      

   

      
         
            ZDPortalConfiguration.enableLogMessages = YES;
         
      
      

   

リリースノート

• イベントのコールバック機能を追加しました。これにより、チャットタブが機能を停止した際に検知することができます。
  
• 起動時のチャット画面の読み込み時間に時間がかかる問題を解決しました。
  
• ユーザーがカスタムテキストやラベルを表示する条件を追加しました。
  
• 問い合わせの送信画面でのユーザーの操作を有効または無効にする条件を追加しました。詳細については、 こちらをクリック してください。
  
• ファイルの添付に関する機能を改善しました。
  

• ユーザーの詳細データを更新するAPIを追加しました。詳細については、 こちらをクリック してください。
  

• ユーザーがアドオンにログインしようとする際にアプリが突然終了する問題を解決しました。
  

• イベントのコールバック機能を追加しました。これにより、ZohoDeskPortalSDKのビューコントローラーが機能を停止した際に検知することができます。
  
  Swift
  

                 
                    
                       ZohoDeskPortalSDK.dismissController {(controller) in
                       // You can find dismissed from ZohoDeskPortalSDK using ZDViewController object
                       switch controller{ 
                       case .DashBoard:
                       print("DashBoard")
                       default:
                       break
                       } 
                       }
                    
                 
                 
  
              

  Objective-C
  

                 
                    
                       [ZohoDeskPortalSDK dismissControllerOnCompletion:^(enum ZDViewController controller) {
                       switch (controller) {
                       case ZDViewControllerDashBoard:
                       NSLog(@"DashBoard");
                       default:
                       break;
                       }
                       }];
                    
                 
                 
  
              

• ログアウトメソッドにイベントのコールバック機能を追加しました。
  
  Swift
  

                 
                    
                       ZohoDeskPortalSDK.logout(onComplition: {
                       print("User sucessfully logged out")
                       }) { (error) in
                       print(error) 
                       }
                    
                 
                 
  
              

  Objective-C
  

                 
                    
                       [ZohoDeskPortalSDK logoutOnComplition:^{
                       // 
                       } onError:^(NSError * error) {
                       // 
                       }];
                    
                 
                 
  
              

• コミュニティタブのサブフォーラムに「すべて」のオプションを追加しました。
  
• ナレッジベースのカテゴリーに対してディープリンクを利用できるようになりました。
  
• コミュニティタブでのユーザーの操作を有効または無効にする条件を追加しました。詳細については、 こちら をご確認ください。
  

• 問い合わせの送信画面の項目でカスタマイズ設定を行えるメソッドを追加しました。詳細については、 こちらをクリック してください。
  
• ポータルで登録されている部署が1件のみの場合に部署の項目が表示されない、といった問い合わせの送信フォームの機能を調整しました。
  

• 問い合わせのコメントにてリッチテキスト（書式付きテキスト）でテキストの書式を設定できるようにしました。
  
• ユーザーコミュニティのフォーラムのトピックにスレッド形式でコメントを追加できるようにしました。
  
• フォーラムのトピックでのコメントに対して、操作を行えるようにしました。
  
• ユーザーコミュニティに検索機能を追加しました。
  
• コミュニティのカテゴリー、最も人気のあるトピック、最も議論されたトピックに関連するAPIを追加しました。
  
• トピックIDが入力された際にトピックの詳細画面が表示されるようにするメソッドを追加しました。
  
• コミュニティタブにディスカッションのトピックの種類を追加しました。
  
• イベントのコールバック機能を追加しました。詳細については、以下のサンプルコードをご参照ください。
  
  Swift
  

                 
                    
                       ZohoDeskPortalSDK.ZDAnalyticsTracker { (analyticsObject) in
                       　　 if analyticsObject?.getEventAction() == .KBArticleClicked{
                       　　　　　　 print("An Article is clicked.")
                       　　　　　　　//An Article is clicked.You can Log or Push this to any of the Analytics tools.
                       　　　}else if analyticsObject?.getEventAction() == .CommunityTopicClicked{
                       　　　　　　 print("A Topic is clicked.")
                       　　　　　　　//A topic is clicked.You can Log or Push this to any of the Analytics tools.
                       　　　} 
                       }
                    
                 
                 
  
              

  Objective-C
  

                 
                    
                       [ZohoDeskPortalSDK ZDAnalyticsTrackerOnCompletion:^(ZDAnalytics * analyticsObject) {
                       　　　 if ([analyticsObject getEventAction] == ZDPortalUIActionKBArticleClicked) {
                       　　　　　　　NSLog(@"An Article is clicked.");
                       　　　　　　 //An Article is clicked.You can Log or Push this to any of the Analytics tools.
                       　　　　}else if ([analyticsObject getEventAction] == ZDPortalUIActionCommunityTopicClicked) {
                       　　　　　　　 NSLog(@"A Topic is clicked."); 
                       　　　　　　　　//A topic is clicked.You can Log or Push this to any of the Analytics tools.
                       　　　　} 
                       }];
                    
                 
                 
  
              

• コミュニティタブの検索機能に関連する問題を解決しました。（バージョン1.0からSDKを使用し始めた場合、この問題に対して操作を行う必要はありません。1.0以前のバージョンからSDKを使用しており、Zoho DeskのポータルでJWT認証を有効にしている場合は、1.0にアップグレードした後にユーザートークンを再生成する必要があります。エンドユーザーに対する影響はありません。）詳細については、以下のサンプルコードをご参照ください。
  
  Swift
  

                 
                    
                       if !ZohoDeskPortalSDK.isZDUserSignedIn || !ZohoDeskPortalSDK.isZDSDKMigratedTo1_0{ 
                       　　　ZohoDeskPortalSDK.set(jwtUserIdentifier: <#Remote user Token#>, onComplition: { 
                       　　　}, onError: { (error) in
                       　　 })
                       }else{
                       　　//User already signed into SDK 
                       }
                    
                 
                 
  
              

  Objective-C
  

                 
                    
                       if (![ZohoDeskPortalSDK isZDUserSignedIn] || ![ZohoDeskPortalSDK isZDSDKMigratedTo1_0]){ 
                       　　　[ZohoDeskPortalSDK setWithJwtUserIdentifier:<#Remote user Token#> onComplition:^{ 
                       　　　} onError:^(NSError * error) { 
                       　　　}]; 
                       }else{
                       　　//User already signed into SDK 
                       }
                    
                 
                 
  
              

• コミュニティタブのカテゴリーに「 フォロー 」オプションを追加しました。
  
• ナビゲーションバーの「戻る」ボタンにてカスタマイズ設定を利用できるようにしました
  
  Swift
  

                 
                    
                       ZDNavigationTheme.backButtonStyle = ZDNavigationBackButtonStyle.icon
                    
                 
                 
  
              

  Objective-C
  

                 
                    
                       [ZDNavigationTheme setBackButtonStyle:ZDNavigationBackButtonStyleIcon];
                    
                 
                 
  
              

• インドのデータセンターのサポートを開始しました。インドのデータセンターにてどこでもサポートのアドオンをホスティングするには、 SDKの初期設定 時にデータセンターのキーに「 ZDDataCenter.IN 」と指定してください。
  
• 設定を上書きしたアドオンのダッシュボードを表示できる新しいメソッドを追加しました。詳細については、 こちらをクリック してください
  

• 商品に関するAPIにパラメーター「 from 」、「 limit 」を追加しました。パラメーター「 from 」はリソースのインデックス番号を表します。パラメーター「 limit 」は返すデータの件数を表します。この2種類のパラメーターがAPIリクエストで指定されない場合、初期設定で最初の10件の商品が返されます。
  
• 問い合わせの作成に関するAPIにて、問い合わせにファイルが添付されている場合に問い合わせが送信できない、といった問題を解決しました。
  

• 以下の操作が行われた際にプッシュ通知を送信できるようにしました：
  
  • 担当者がユーザーの代わりに問い合わせを作成。
    
  • 担当者が新たに問い合わせに返信。
    
  • 問い合わせの優先度の変更。
    
  • 問い合わせのステータスの変更。
    
  • 問い合わせに新たにコメントを追加。
    
  • 問い合わせのコメントを編集。
    
• 問い合わせの送信画面にコールバックメソッドを追加しました。このメソッドを使用すると、問い合わせの送信後に、問い合わせの詳細データが即座にアプリに送信されるように、どこでもサポートのアドオンを設定することができます。
  

• どこでもサポートのフレームワークがCore Dataにアクセスする際にアプリが突然終了する問題を解決しました。
  

バージョン1.xから2.0への移行

SDKとiOSアプリとの連携

メモ  

バージョン2.0以降 :

• 表示メソッドでは、View Controllerは必要ありません。
  
• すべての表示メソッドでは、件名とスタイルのパラメーターに初期値が設定してあります。必要に応じてパラメーターを上書きできます。