startCommEventメソッド

ツールバーは、newCommEvent()コールによってトリガーされた新しい通信をエージェントが受け入れたときに、この必須メソッド・コールを実行します。

このメソッドは、担当者の識別フローを起動し、顧客検証フローをトリガーして、次のことを説明するスクリーン・ポップアップを実行します:

このメソッドは、最初に顧客検証フローをトリガーします。

このフローは、連絡データを問い合せて、担当者がすでに識別されているかどうかを確認します。そうでない場合は、担当者の検索ウィンドウが表示され、エージェントが担当者を検索または作成できます。担当者情報が見つかると、ツールバーに戻ります。ツールバーは、startCommEventコールの前に担当者を識別するか、SVCMCA_BYPASS_IDENTIFY_CONTACTを渡すことによって、このフローをバイパスできます。ツールバーでは、getCustomerData()メソッドを使用して、担当者の識別を手動でリクエストできます。
その後、顧客検証ページを開くオプション・フローである顧客検証フローがトリガーされます。エージェントが発信者を確認しない場合、画面ポップアップは実行されません。コール・データでSVCMCA_BYPASS_CUSTOMER_VERIFICATIONトークンを渡すことで、顧客検証をバイパスできます。
最後に、事前定義済のルールを使用してスクリーン・ポップを実行します。ツールバーで画面ポップアップを防止する場合は、SVCMCA_BYPASS_AUTO_SCREENPOPトークンをコール・データに追加し、invokeScreenPop()メソッドを使用して手動でポップアップをトリガーできます。

ノート: startCommEventメソッドで渡されたコールバックは、担当者および顧客検証の識別フローがトリガーされた場合に複数回起動できます。レスポンスのoutData情報には、更新された顧客情報を含めることができます。

メソッドの詳細を次に示します:

パラメータ	説明
チャネル	メソッドがコールされるチャネルの名前。使用可能なチャネルの詳細は、「チャネル・タイプ・データ」を参照してください。
appClassification	現在のツールバーに定義されているアプリケーション分類の名前。このパラメータがnullとして渡された場合、アプリケーション分類がないと想定されます。事前構成済の値のリストは、「アプリケーション分類コード」を参照してください。
eventId	ツールバーによって生成されたメディア・イベント識別子。通信のすべてのメソッド呼出しに同じパラメータ値を使用する必要があります。このパラメータは、内部顧客対応レコードとともに格納されます。
inData	顧客識別可能データの受信イベントに関する情報、およびシステムまたはユーザー定義トークンの名前を含む属性を含むオブジェクト。
callback	呼び出し元ツールバーに結果を返します。
channelType	メソッドがコールされるチャネルのタイプ。たとえば、チャネルがPHONEで、channelTypeが指定されていない場合、デフォルト値はORA_SVC_PHONEに設定されます。詳細は、「チャネル・タイプ・データ」を参照してください。

レスポンス・オブジェクトのメンバー属性は次のとおりです。オブジェクトに戻り値がありません。

メンバー属性	説明
result	サーバー側の実行ステータス。結果の値は成功またはエラーです。
outData	担当者または組織の「サービス・センター」から識別可能なデータを含むオブジェクトを表します。この属性には、システム・トークンの名前が含まれます。
錯誤	結果の値がエラーの場合にエラー・メッセージが表示されます。そうでない場合、値は未定義です。エラー・メッセージ・コードの詳細は、エラー・メッセージを参照してください。

<html>
<head>
<script type="text/javascript" src="http://domain:port/ora_support/js/mcaInteractionV1.js"> 
</script>
<script type="text/javascript">
function startCommEvent() {
      var inData = {};
      inData.SVCMCA_ANI = '5551234';
      inData.SVCMCA_CONTACT_ID = '1234567890';
      inData.SVCMCA_CONTACT_NAME = 'John Smith';
      inData.createSr = 'yes';
      svcMca.tlb.api.startCommEvent('PHONE', 'ORA_SERVICE', '12345-1234-67890', inData, function (response) {
        if (response.result == 'success') {
          console.log('Created service request: '+response.SVCMCA_SR_NUMBER);
          alert('Success! Results available in log.');
        } else {
          alert('Operation finished with error: ' + response.error);
        }
      },'ORA_SVC_PHONE');
    }</script>
</head>
<body>
<input type="button" value="Call started" onclick="startCommEvent()"/>
</body>
</html>