1. 画面
   
2. 分岐
   
3. 処理
   

画面

表示要素

テキスト

クエリー 

キオスクのデータ

データ取得

データ作成

Zia分析

1. 項目値の予測
   
2. 競合他社の検出
   
3. 解約予測
   
4. おすすめの次の一手
   
5. Ziaスコア
   
6. レコメンド
   
7. 類似データのレコメンド
   
8. 連絡に最適な時間帯
   

項目

ボタン 

メモ

1. 1件の画面に追加できる項目の上限は、20件です。
   
2. 1件の画面に追加できるボタンの上限は、4件です。
   
3. 表示要素や項目は並べ替えることができます。
   

キオスクの項目 

キオスクの項目では、画面内に追加された項目や処理を通じて生成された項目をまとめることができます。

処理の項目

 分岐   

処理

1. 項目の更新
   
2. 担当者の割り当て
   
3. タグ（タグの割り当て、タグの削除）
   
4. メール通知
   
5. メモの追加
6. 活動（タスクの追加、通話の予約、予定の追加）
   
7. データの作成（標準の設定、ユーザー入力）
   
8. 変換
   
9. Webhook
   
10. 関数
    
11. データを開く
    
12. リンクを開く
    

データの作成 

1. キオスクの設定画面で［処理］→［データの作成］→［ユーザー入力を使用する］の順に選択します。
   
2. 処理名を入力し、タブとレイアウトを選択します。
   
3. 実行すると、選択したタブのかんたん作成の画面が表示されます。
   
4. 設定するにあたって、使用頻度の高い項目の値を事前入力するように指定できます。
   
5. ユーザーは、キオスクの実行中に詳細を直接入力できます。
   
6. メモ：ユーザーに対してタブ内のデータの作成権限が許可されていない場合、この手順はスキップされ、該当の値は入力されません。
   

連続処理

メモ

1. 多くの処理において、［完了待ち］の設定は標準で有効になっています。ただし、活動（タスク、通話、予定）、データの作成、Webhook、関数に関する処理においては、手動で有効にする必要があります。
   
2. ［処理待ち］の設定が無効な場合、直前の段階の処理が完了するのを待たずに次の段階の処理が実行されます。この場合、直前の段階の処理で収集した値を次の段階の処理で使用することはできません。
   

メモ：キオスクが編集され、要素が更新または削除された場合、処理を通じて出力されたデータは再度取得されません。

関数とWebhookを使用した連続処理

1. JSONObjectをテキスト形式で出力する関数を記述します。新しい関数の画面で設定することで、テキスト形式の値を出力できます。
   
2. キオスクに処理として追加し、［完了待ち］の設定を有効にします。
   
3. 引数の関連付けで、「#」を入力して、キオスクで使用するデータ元を各引数に関連付けます。キオスクの実行中には、引数に実際の値が入力されます。
   
4. テストの値を使用してキオスクで処理を実行し、出力値を取得します。テストの値は、この設定時の実行でのみ使用されます。実行時の入力値は使用されません。また、「#」を入力して項目を選択することはできません。
   
5. 出力値の関連付けで、各出力値（result.<key>）をZoho CRMの項目に関連付けます。関連付けた値は、画面、分岐、後続の処理で使用できます。
   

関数の引数に対するデータの指定  

1. 対象の関数を開いて右側のパネルで［引数を追加する］をクリックし、引数の関連付けの画面を開きます。
   
2. 各引数の欄で、引数の名前を入力します。
   
3. 値の項目をクリックし、「#」を入力します。
   
4. 差し込み項目の選択画面で、対象のキオスク、データ元（処理対象のデータ、データ取得の結果、Ziaエージェント、前の画面）、項目を選択します。
   
5. 各引数で上記の手順を繰り返し、［保存する］をクリックします。
   
6. 関数のテストを行い、関数が正しく機能することを確認して、［保存して関連付ける］をクリックします。
   

response = {
    "recordId_1": "1234567890",
    "recordId_2": "9876543210"
}; 
return response.toString();

出力値に関連付けるテストの値 

関数から出力された値を項目として利用できるようにするため、キオスクでは設定時に関数を一度テスト実行する必要があります。関数の処理で［実行する］をクリックすると、入力パラメーターの画面が開きます。こちらの画面で、各引数にテストの値を入力します（例：実際のデータID）。

この画面では、「#」を入力して項目を選択することはできません。引数の関連付けとは手順が異なります。

1. 引数の関連付け（#）：実行時における各引数への入力値のデータ元を指定します。キオスクを実行すると、値が動的に取得されます。
   
2. 入力パラメーター（テストの値。「#」の項目選択メニューは使用できません）：テスト時に処理を実行するための、一度のみ使用される値です。キオスクを通じて、出力値の構造が取得されます。
   

以下の画像は、キオスクで値のテストを行う際に「#」の項目選択メニューが表示されない例です。

関数が実際に実行されるため、関数の処理によってデータが作成されたり、重複したりする可能性がある旨のメッセージが表示されます。テストの値を入力すると、キオスクを通じて処理が実行され、出力値の関連付けの画面が開きます。こちらの画面には、関数から返された各値が「result.status」などの参照名として表示されます。これらの値を、Zoho CRMの項目の種類とラベルに関連付けます。

Webhookの設定  

1. メソッド：HTTPメソッドです（例：POST）。
   
2. 通知先のURL：キオスクを実行する際のエンドポイントです。
   
3. 認証方法：一般または外部連携のいずれかを選択します。
   
4. ヘッダー、タブのパラメーター、独自パラメーター：リクエストと共に送信するデータです。
   
5. ボディ：リクエストのペイロードとその種類です。
   

実行の制限と失敗  

例  

1. 引数の関連付けで、関数に必要な各引数を追加します。各引数に対して「#」を使用して、見込み客IDなどのデータの値は処理対象のデータの項目に、ユーザーが画面で入力した値は対応する画面の項目に関連付けます。
   
2. 関数で、「JSONObject」として出力値を設計し、テキストで出力します。例：{"status":"logged","assessmentId":"..."}
   
3. ［完了待ち］の設定を有効にして、失敗の経路を追加します。関数でエラーが発生したり、上限の10秒に達したりすると、フローは失敗の経路に移動し、再試行の選択画面が表示されます。
   
4. 項目として出力値を取得するには、［入力パラメーター］画面でテスト値を入力して処理を実行します。この画面では、［#］を使用して項目を選択することはできません。処理を実行すると、キオスクを通じて出力値が取得され、出力値の関連付けの画面が開きます。こちらには、「result.status」と「result.assessmentId」などの値が表示されます。それぞれに対して、Zoho CRMの項目の種類とラベルを関連付けます。
   
5. 実行に成功すると、キオスクを通じてこれらの項目に値が設定されます。次の画面で［処理の項目］を追加し、「result.status」を表示します。
   
6. 関数の出力値に応じてフローを分岐するには、分岐の要素を追加して、「result.status」を条件として設定します。この要素により、失敗の経路とは異なる経路が設定されます。失敗の経路では、関数の処理に失敗した際の対応を設定します。分岐では関数の処理に成功した際の対応を設定します。
   

トラブルシューティング  

1. 出力値の項目が生成されない：関数の出力値がテキストの「JSONObject」であり、配列でないことを確認してください。また、該当の関数が新しい関数の画面で設計されていることを確認してください。
   
2. 出力値を次の画面で使用できない：出力値の関連付けの画面で値が項目に関連付けられていることを確認してください。たとえば、「result.status」に対応する値をステータス項目に関連付けると、出力値を次の画面や分岐条件で使用できるようになります。
   
3. 処理が失敗の経路に移動する：実行エラーが発生していないかどうかを確認してください。また、実行時間が上限の10秒に達していないかどうか、ソケット、スレッド、接続のタイムアウトが発生していないかどうかを確認してください。

関数に関する詳細については、こちらをご参照ください。

キオスクのデータ

キオスクの画面では、ユーザーのデータを収集したり、Zoho CRM内に保存されているデータや直前の画面で収集したデータを表示したりできます。データを収集／取得／表示するにあたって、以下の方法が用意されています。 

処理対象のデータ    

キオスクは、Zoho CRM内のさまざまな場所に配置できます。ただし、以下の場所に配置した場合は、特定のデータのみを取得／表示できます。

1. データの詳細ページ
   
2. タブのデータ一覧ページ（内の各データ）
   

 この場合、キオスクの画面では特定のデータ（処理対象のデータ）のみを取得／表示できます。上記の場所以外からキオスクにアクセスした場合、処理中のデータには値が表示されません。

データ取得

データ取得の要素では、Zoho CRMに保存されているデータを取得し、画面に表示できます。画面、分岐、処理でこの要素を作成、使用することが可能です。データ取得の要素には、以下の種類が用意されています。

1. 単一データの表示：1件のデータのみを取得して、画面に表示できます。このデータは、次の画面、分岐条件、処理で使用可能です。
   
2. 複数データの表示：選択した条件に基づいて、複数のデータを取得して表示できます。
   
1. 単一データの選択：取得した複数のデータのうち、ユーザーは1件のデータのみ選択できます。この項目は、単一データの表示項目が使用されている場所で使用できます。
   
2. 複数データの選択：取得した複数のデータから、ユーザーは複数のデータを選択できます。選択したデータは、分岐条件またはメール通知のテンプレートで使用することが可能です。使用するには、メールテンプレートの設計画面で［表］→［データ取得］の順に移動します。
   

タブのすべてのデータの取得と表示：タブのデータを取得し、データ取得の画面に表示できます。  タブのすべてのデータを表示したり、すべてのデータに対して処理を実行したりする際に役立ちます。

データ取得の要素の画面下部では、ページに表示されているデータ数を確認できます。大量のデータがある場合に、ページの切り替えをすばやく行うことが可能です。

データ取得の画面右上のフィルターアイコンをクリックし、データをすばやく抽出できます。また、設定画面から、選択可能なデータ数の上限を指定することも可能です。指定するにあたって、10～100の値を選択できます。

キオスクでは、データ取得の最初の画面が自動で読み込まれます。画面を手動で更新する必要はありません。キオスクを通じてデータ取得の最初の画面が開くと、ホーム画面、キャンバス、データの詳細ページ、ブループリント、カスタムボタンなどの場所にかかわらず、データがすぐに読み込まれます。

データ作成

データ作成の処理で［完了待ち］を有効にしている場合、新しく作成されたデータを次の段階の処理の画面で使用できます。データ作成のセクションには、次の段階の処理で使用できる新しいデータが表示されます。

分岐の要素におけるデータ作成

分岐の要素を設定する際には、データ取得、処理対象のデータのいずれかに基づいてのみ条件を追加できます。

連続処理が有効な場合、データ作成に基づいて条件を追加し、分岐の要素を設定することも可能です。設定するには、キオスクのデータ（データ取得、処理対象のデータ、データ作成）をクリックし、データ作成を選択して、条件を設定します。

処理の要素におけるデータ作成

キオスクでは、データ作成の要素に基づいて、処理を設定できます。設定するには、対象の処理を選択し、データの種類としてデータ作成を選択します。

たとえば、キオスクを通じて既存のデータを更新したいとします。この場合、項目の更新の処理を設定し、データの種類としてデータ作成を選択し、更新対象の項目を選択します。

同様に、さまざまな処理の要素でデータ作成の要素を使用することが可能です。

差し込み項目

差し込み項目とは、他の項目のデータを参照し、該当の項目の値を表示するための項目です。キオスクで差し込み項目として指定できる項目は、以下のとおりです。

1. データ取得の項目（Zoho CRMのデータの項目）
   
2. 直前の画面の項目
   
3. 処理中のデータの項目
   
4. データ作成の項目
   
5. ユーザーの項目（キオスクにアクセスしているユーザーの詳細）
   
6. 組織の項目
   

 これらの項目は、以下の場所で使用できます。

1. 画面内：差し込み項目が有効になっている状態で「#」を押すと、項目を選択できます。これにより、画面上に表示するテキストをカスタマイズしたり、参照用にZoho CRMの項目のデータを表示したりできます。
   
2. メールテンプレート：メールテンプレートを作成するにあたって、差し込み項目を使用して通知内容をカスタマイズできます。 

クエリー  

クエリーは、Zoho CRMの処理において必要なデータを取得するための機能です。キオスクにおいてクエリーを使用すると、見込み客や顧客のデータを取得し、キオスクの画面で表示したり、分岐の条件に使用したりできます。データを取得するにあたっては、Zoho CRMのAPIまたはCOQL（CRM Object Query Language：CRM内のデータを取得するための構文）を使用します。また、必要に応じて外部サービスのデータを取得することも可能です。キオスクにおいてクエリーを使用できる場所は、以下のとおりです。

1. 画面：キオスクの画面にクエリーを追加できます。これにより、処理に必要なデータを取得して画面上に表示することが可能です。
   
2. 分岐：キオスクの分岐の要素にクエリーを追加できます。分岐の判断に必要な各種データをクエリーから取得し、データの値に基づいてその後の処理を分岐させるように条件を設定することが可能です。なお、分岐の要素でクエリーを用いて条件を設定するには、分岐の要素より前の画面において、クエリーによるデータ取得の設定を追加しておく必要があります。
   

キオスクの画面にクエリーを追加するには   

1. キオスクの設計画面で［+］をクリックし、要素を追加します。
   
2. ［画面］を選択し、［追加する］をクリックします。
   
3. ［クエリーによるデータ取得］を選択します。
   
4. ［新しいクエリー］をクリックします。
   
5. 一覧から対象のクエリーを選択します。
     
6. 新しいクエリーを追加するには、［クエリーを追加する］をクリックして詳細を入力します。
   データ元：データの取得元を選択します。Zoho CRMのタブ、またはCOQL（データ取得用の構文）のいずれかを選択できます。独自のデータ元を追加することも可能です。
   
   情報：クエリーの名前を入力します。なお、API名は自動で入力されます。対象のタブを選択し、必要に応じて関連タブを選択します。その後、項目を選択します。
   
   条件：データを取得する条件を指定します。
   
   データ加工処理：JavaScriptを使用してデータを加工／変換する処理を設定できます。内容を入力して、［保存する］をクリックします。
   
   ［詳細設定］の項目で並べ替え条件を追加し、［次へ］をクリックします。
   
7. クエリーの選択後、［次へ］をクリックします。表示されるポップアップ画面でクエリーの名前を編集し、データの取得元となる項目を選択します。
   
8. ［データ設定］の項目で、取得するデータの種類（単一データまたは複数データ）を選択します。［単一データ］を選択する場合、表示する項目を選択して［保存する］をクリックします。
   
9. ［複数データ］を選択した場合、識別情報を選択します。識別情報とは、複数のデータ元から取得したデータを識別するために使用する項目です。
   この項目をもとに、データを特定することが可能です。そのため、識別情報には重複禁止項目を指定する必要があります（例：見込み客ID、メールアドレスなど）。選択数の上限を入力し、［識別情報］と［表示する項目］を選択して、［保存する］をクリックします。
    

キオスクの分岐の要素にクエリーを追加するには
   

1. キオスクの設計画面で［+］をクリックし、要素を追加します。
   
2. ［分岐］を選択し、条件を追加します。
   
3. 選択肢から［クエリー］を選択します。
   
4. 条件を選択し、［完了する］をクリックします。
   

クエリーで使用できる項目とその上限

クエリーで表示できる項目数の上限は、全体で100件までです。たとえば、数値の項目を40件使用していて、他の項目（小数、パーセント、通貨）を60件使用している場合、クエリーで他の項目をこれ以上使用することはできません。クエリーで使用できる項目の種類とその上限は、以下の表のとおりです。

クエリーで使用できる項目の種類	上限
テキスト （1行、メールアドレス、電話番号、複数行、URL、自動番号） 複数行の上限：25件 自動番号の上限：1件	100件
数値（小数点なし）	40件
小数、パーセント、通貨	60件
日付	50件
日時	50件
チェックボックス	80件
長整数	35件
暗号化された項目 （暗号化された項目の件数には、数値とテキストの項目（1行、メールアドレス、URL、電話番号）が含まれます）	10件