1. 利用可能
2. Busy

1. 無効 自動化.availableSalesIQ()
2. {
3.   // 取得リクエストパラメーター用の空の map を作成（invokeurl 構文で必須）
4. requestParams = Map();
5. 
   
6.   // SalesIQ からオペレーター一覧を取得 API で取得
7. operatorResponse = invokeurl
8. [
9. url :'https://salesiq.Zoho.com/api/v2/harishtestacc/operators'
10. 種類 :取得する
11. パラメーター:requestParams
12. connection:'salesiq1'
13. ];
14. 
    
15.    // レスポンスから 'data' 配列を抽出します（オペレーター情報が含まれています）
16. operatorData = operatorResponse.取得する('data');
17. info operatorData;
18. 
    
19.   // 現在ログインしているZohoユーザーのメールアドレスを取得する
20. currentUserEmail = Zoho.loginuserid;
21. info 'ログインユーザー メール: ' + currentUserEmail;
22. 
    
23.     // 受注データを［パッケージ］データに変換するだけで、operator dataをリストに変換し各オペレーターを繰り返し処理します
24. operatorList = operatorData.toList();
25. 
    
26.   // 各オペレーターデータをループ処理
27. for each index operatorIndex in operatorList
28. {
29.       // オペレーターのメールアドレスを抽出
30. operatorEmail = operatorList.取得する(operatorIndex).取得する('email_id');
31. 
    
32.       // オペレーターのメールが現在ユーザーのメールと一致するか確認
33. if(operatorEmail == currentUserEmail)
34. {
35.           // 照合済みの場合、オペレーターのIDを取得
36. operatorId = operatorList.取得する(operatorIndex).取得する('id');
37. 
    
38.            // オペレーターのステータスを「利用可能」に設定するためのマップを準備
39. updateStatusMap = Map();
40. updateStatusMap.put('ステータス','利用可能');
41. 
    
42.            // オペレーターのステータスを更新するためにPOSTリクエストを実行
43. updateResponse = invokeurl
44. [
45. url :'https://salesiq.Zoho.com/api/v2/harishtestacc/operators/'+ operatorId + '/ステータス'
46. 種類 :POST
47. パラメーター:updateStatusMap.toString()
48. connection:'salesiq1'
49. ];
50. }
51. }
52. }
    

1. 無効 自動化.availableSalesIQ()
2. {
3.     // 取得リクエストパラメーター用の空のマップを作成（invokeurl構文で必須）
4. requestParams = Map();
5. 
   
6. // 取得する APIを使用してSalesIQからオペレーターの一覧を取得
7. operatorResponse = invokeurl
8. [
9. url :'https://salesiq.Zoho.com/api/v2/harishtestacc/operators'
10. 種類 :取得する
11. パラメーター:requestParams
12. connection:'salesiq1'
13. ];
14. 
    
15.     // レスポンスからオペレーター情報が含まれる 'data' 配列を抽出
16. operatorData = operatorResponse.取得する('data');
17. info operatorData;
18. 
    
19.     // 現在ログインしているZohoユーザーのメールアドレスを取得
20. currentUserEmail = Zoho.loginuserid;
21. info 'ログインユーザーメール: ' + currentUserEmail;
22. 
    
23.     // 受注データを［パッケージ］データに変換するだけで、operator dataをリスト化し各オペレーターを繰り返し処理できるようにします
24. operatorList = operatorData.toList();
25. 
    
26.     // 各オペレーターのデータをループ処理
27. for each index operatorIndex in operatorList
28. {
29.    // オペレーターのメールアドレスを抽出
30. operatorEmail = operatorList.取得する(operatorIndex).取得する('email_id');
31. 
    
32.   // オペレーターのメールが現在ユーザーのメールと一致するか確認
33. if(operatorEmail == currentUserEmail)
34. {
35.     // 照合済みの場合、オペレーターのIDを取得
36. operatorId = operatorList.取得する(operatorIndex).取得する('id');
37. 
    
38.        // オペレーターのステータスを「利用可能」に設定するマップを準備
39. updateStatusMap = Map();
40. updateStatusMap.put('ステータス','Busy');
41. 
    
42.     // オペレーターのステータスを更新するためにPOSTリクエストを送信
43. updateResponse = invokeurl
44. [
45. url :'https://salesiq.Zoho.com/api/v2/harishtestacc/operators/'+ operatorId + '/ステータス'
46. 種類 :POST
47. パラメーター:updateStatusMap.toString()
48. connection:'salesiq1'
49. ];
50. }
51. }
52. }

2. 画面上にボタンを配置

このKiosk画面にPeopleのステータス設定をボタンとして追加します。Zoho Peopleで利用可能な操作は次の通りです：

1. Check-in
2. Check-出力

「Check-in」と「Check-出力」という2つのボタンを画面に追加します。これにより、ユーザーは自分の現在の状況に応じて該当する出勤操作を簡単に選択できます。

ボタンラベルは、実行される操作内容が明確に伝わるように設定してください。これにより、ユーザーの混乱を防ぐことができます。

3. ステータスボタンの処理設定

次に、Zoho Peopleのステータスボタンに処理を追加していきます。キオスクからステータスを更新するには、Zoho People APIを利用したカスタム関数の設定が必要です。この関数は、ユーザーの選択（チェックインまたはチェックアウト）に応じて実行されます。例として、ユーザーがCheck-inボタンをクリックすると、関数がZoho People APIを呼び出してユーザーをチェックイン済みとして設定します。同様に、Check-出力をクリックするとユーザーをチェック出力済みとして設定します。

ユーザー体験を向上させるために、カスタム関数実行後に確認画面を追加することをおすすめします。

この画面には、「Text」要素を配置し、ユーザーにステータス更新が正常に完了したことを明確に伝えてください。

例として、「Zoho Peopleのステータスが正常に更新されました」のようなメッセージを表示します。

この最終手順により、意図した操作が完了したことに安心感を与え、ユーザーが自信を持って一連の流れを進められるようサポートできます。

サンプルスクリプト

以下は、Zoho Peopleでステータスを更新する方法を示したDelugeスクリプトのサンプルです。

1. Check-In：
   

1. // 現在ログイン中のユーザーをZoho Peopleの勤怠にチェックインする関数
2. // 現在ログイン中のZohoユーザーのメールアドレスを取得する
3. currentUserEmail = Zoho.loginuserid;
4. 
   
5. // メールアドレスでZoho Peopleから従業員データを取得するリクエストを実行
6. employeeResponse = invokeurl
7. [
8. url :'https://people.Zoho.com/api/forms/従業員/getRecords?searchParams={searchField:'EmailID',searchOperator:'Is',searchText:'+ currentUserEmail + '}'
9. 種類 :取得する
10. connection:'people1'
11. ];
12. 
    
13. // システムタイムゾーンの現在のタイムスタンプを取得する
14. currentTime = now;
15. 
    
16. // Zoho Peopleに出勤（チェックイン）を設定するPOSTリクエストを実行
17. checkInResponse = invokeurl
18. [
19. url :'https://people.Zoho.com/people/api/attendance?dateFormat=dd-MMM-yyyyHH:mm:ss&checkIn=' + currentTime + '&emailId=' + currentUserEmail
20. 種類 :POST
21. connection:'people1'
22. ];

1. チェック出力:

1. // 現在ログインしているユーザーをZoho Peopleの出勤管理に打刻する関数
2. // 現在ログインしているZohoユーザーのメールアドレスを取得
3. currentUserEmail = Zoho.loginuserid;
4. 
   
5. // メールアドレスでZoho Peopleから従業員データを取得するリクエストを送信
6. employeeResponse = invokeurl
7. [
8. url :'https://people.Zoho.com/api/forms/従業員/getRecords?searchParams={searchField:'EmailID',searchOperator:'Is',searchText:'+ currentUserEmail + '}'
9. 種類 :取得する
10. connection:'people1'
11. ];
12. 
    
13. // システムタイムゾーンで現在のタイムスタンプを取得
14. currentTime = now;
15. 
    
16. // Zoho PeopleにPOSTリクエストを送信し、出勤を記録する（打刻）
17. checkInResponse = invokeurl
18. [
19. url :'https://people.Zoho.com/people/api/attendance?dateFormat=dd-MMM-yyyyHH:mm:ss&決済する=' + currentTime + '&emailId=' + currentUserEmail
20. 種類 :POST
21. connection:'people1'
22. ];

接続用OAuthスコープ

ZOHOPEOPLE.forms.READ
ZOHOPEOPLE.attendance.すべて

上記のスコープを持つconnectionを使用する必要があります。Zoho CRMでconnectionを作成するには、以下の手順に従ってください。

ナビゲーション: 設定 >> Developer Hub >> 外部連携 >> Connection作成

1. Connection：

🎥 動作デモ: キオスク経由でのZoho Peopleのチェックイン／チェック出力

                  

1. キオスク内のZoho Voiceパス
   

1. 画面の設計と要素追加

キオスクのZoho Voiceパスに新規画面を追加します。この画面内に「Text」要素を挿入し、ユーザーへ分かりやすい案内を表示します。例として、利用可能、Busy、オンBreak、またはオフラインなど、ユーザーが選択したステータスに応じてZoho Voice内の状態が更新される仕組みを説明します。このような文脈を伝えることで、ユーザーが操作前に内容を十分に理解できるようになります。

2. ユーザー処理用ボタンの挿入

Kiosk画面にZoho Voiceステータス設定をボタンとして追加します。Zoho Voiceで利用可能なステータスは以下の通りです：

1. 利用可能
2. オン Break
3. Busy
4. オフライン

画面上に上記の各ステータスごとに4つの個別ボタンを作成してください。それぞれのボタンには該当するステータス名を表示します。これにより、ユーザーは自分の現在の稼働状況ステータスをワンクリックで簡単に選択できます。

各ボタンには、実行される操作が明確にわかるようにラベルを付けてください。これにより、ユーザーの混乱を防ぎ、スムーズな操作体験を実現できます。

3. ボタン処理によるステータス更新の実装

次に、Zoho Voiceステータスボタンに処理を追加していきます。Kioskからユーザーステータスを更新するには、Zoho Voice APIを利用してカスタム関数を設定する必要があります。この関数は、ユーザーが選択したステータス（利用可能・オンBreak・Busy・オフライン）に基づき実行されるようにしてください。各ボタンが、選択されたステータスを反映するために適切なAPIリクエストを送信するように設定します。

ユーザー体験を向上させるために、カスタム関数の実行後すぐに確認画面を追加してください。

この画面には「Text」要素を含め、Zoho Voiceステータスが正常に更新されたことをユーザーに通知します。

例として、「Zoho Voiceステータスが正常に更新されました。」などのメッセージを表示します。

この最後の手順により、操作が完了したことを明確にフィードバックでき、ユーザーは安心して手続きを進められます。

サンプルスクリプト

以下のサンプルDelugeスクリプトを使用して、KioskからZoho Voiceステータスを更新できます。

1. 利用可能：

1. // データの内容を保持するMapを初期化
2. data = Map();
3. data.put('ステータス', '利用可能'); // エージェントのステータスを「利用可能」に設定
4. 
   
5. // Zoho Voiceでエージェントのオンラインステータスを更新するためのHTTP PUTリクエストを送信
6. response = invokeurl
7. [
8. url : 'https://voice.Zoho.com/rest/json/zv/api/agents/onlineStatus' // Zoho Voice APIエンドポイント
9. 種類 : PUT // HTTPメソッド
10. パラメーター : data // データの内容
11. connection : 'voice1' // Zohoアカウントで事前設定された接続名
12. ];
13. 
    
14. // デバッグ用にAPIレスポンスを記録
15. info response;

1. オン break:

1. // データの内容を保持するMapを初期化
2. data = Map();
3. data.put('ステータス', 'オン Break');// エージェントのステータスを「利用可能」に設定
4. 
   
5. // Zoho Voiceでエージェントのオンラインステータスを更新するためのHTTP PUTリクエストを実行
6. response = invokeurl
7. [
8. url : 'https://voice.Zoho.com/rest/json/zv/api/agents/onlineStatus' // Zoho Voice APIエンドポイント
9. 種類 : PUT // HTTPメソッド
10. パラメーター : data // データの内容
11. connection : 'voice1' // Zohoアカウントで事前設定された接続名
12. ];
13. 
    
14. // デバッグ用にAPIレスポンスを記録
15. info response;

1. Busy：
   

1. // データの内容を保持するMapを初期化
2. data = Map();
3. data.put('ステータス', 'Busy'); // エージェントのステータスを「利用可能」に設定
4. 
   
5. // Zoho Voiceでエージェントのオンラインステータスを更新するHTTP PUTリクエストを送信
6. response = invokeurl
7. [
8. url : 'https://voice.Zoho.com/rest/json/zv/api/agents/onlineStatus' // Zoho Voice APIエンドポイント
9. 種類 : PUT // HTTPメソッド
10. パラメーター : data // データの内容
11. connection : 'voice1'// Zohoアカウントで事前設定されたコネクション名
12. ];
13. 
    
14. // デバッグ用にAPIレスポンスをログ出力
15. info response;

1. オフライン:
   

1. // データ内容を保持するMapを初期化
2. data = Map();
3. data.put('ステータス', 'オフライン'); // エージェントのステータスを「利用可能」に設定
4. 
   
5. // Zoho Voiceでエージェントのオンラインステータスを更新するHTTP PUTリクエストを実行
6. response = invokeurl
7. [
8. url : 'https://voice.Zoho.com/rest/json/zv/api/agents/onlineStatus' // Zoho Voice API エンドポイント
9. 種類 : PUT // HTTPメソッド
10. パラメーター : data // データ内容
11. connection : 'voice1' // Zohoアカウントであらかじめ設定したコネクション名
12. ];
13. 
    
14. // デバッグ用にAPIレスポンスをログ出力
15. info response;

Connection用OAuthスコープ:

ZohoVoice.agents.READ
ZohoVoice.agents.更新する

上記スコープを含むコネクションを利用する必要があります。Zoho CRMでコネクションを作成する手順は以下をご参照ください。

ナビゲーション: 設定 >> Developer Hub >> 外部連携 >> コネクション作成

1. コネクション:
   

メモ: このサンプル関数（Zoho Voice）は、ログイン中のユーザーの認証情報を使用して処理を実行します。現在、UI上では「Credential of ログインする ユーザー」を有効にするオプションは利用できず、バックエンドから有効化が必要です。ご希望の場合は、パートナー-サポート@zohocorp.com までメールを送信してください。

🎥 動作デモ: Kioskインターフェースを使ったZoho Voiceステータス管理

Zoho CRMでのKioskの導入

KioskはウィジェットコンポーネントとしてCRMのホームページやダッシュボードに配置したり、任意のタブ内にボタンとして追加したりすることができます。ホームページ上にウィジェットとして設定すると、ユーザーはZoho CRMを開いた際にすぐにKioskへアクセスできます。これにより、Zoho People、SalesIQ、Zoho Voiceなどの該当アプリケーションボタンをクリックして、他のセクションへ移動せずに素早くステータスを更新できます。

Kioskウィジェットをホームページに配置することで、表示性が向上し、定期的なステータス更新が促進されます。