newCommEventメソッド

このメソッドは、ツールバーによって呼び出され、新しい通信イベントが開始されたことをServiceCenterに通知します。

これは、ツールバーが通信イベントに対して行う最初のAPIコールです。このメソッドは、通信イベントに使用される一意の識別子またはメディア・イベント識別子のいずれかをeventIdパラメータで指定する必要があります。インバウンド・コールとアウトバウンド・コールの両方について、インタラクションの方向を指定することが重要です。 newCommEventには、コールの方向を示す次のinDataトークンが含まれている必要があります: "SVCMCA_COMMUNICATION_DIRECTION". 有効な値は次のとおりです: "ORA_SVC_INBOUND"および"ORA_SVC_OUTBOUND"。このメソッド・コールは必須です。

インバウンド・コールの場合、コールの主な目的は、リバース・ルックアップ機能を使用して顧客を識別し、着信コール通知をトリガーすることです。ツールバーは、トークンを使用してインタラクティブ音声レスポンス・システムからすべての情報を渡します。取得されたすべての顧客情報は、システム・トークンを使用してツールバーに返送されます。

次に、newCommEventパラメータのリストを示します。

パラメータ	説明
チャネル	メソッドがコールされるチャネルの名前。使用可能なチャネルの詳細は、「チャネル・タイプ・データ」を参照してください。
appClassification	現在のツールバーに定義されているアプリケーション分類の名前。このパラメータがnullとして渡された場合、アプリケーション分類がないと想定されます。事前構成済の値のリストは、「アプリケーション分類コード」を参照してください。
eventId	ツールバーで生成されたメディア・イベント識別子。通信のすべてのメソッド呼出しに同じパラメータ値を使用する必要があります。このパラメータは、内部顧客対応レコードとともに格納されます。
inData	顧客識別可能データの受信イベントに関する情報と、システムまたはユーザー定義トークンの名前を含む属性を含むオブジェクト。着信コール通知のタイムアウト値を指定するには、このパラメータに次のペアを追加:`SVCMCA_OFFER_TIMEOUT_SEC, #OFSECOND` #OFSECONDS値を、タイマーを開始する実際の秒数で置き換えます。タイマーが期限切れになると、updateTypeパラメータをOFFER_TIMEOUTに設定してonDataUpdated()メソッドが呼び出されます。次に、ツールバーによってcloseCommEvent()メソッドが起動され、相互作用が終了します。
callback	呼び出し元ツールバーに結果を返します。
lookupObject	逆参照の実行に使用されるビジネス・オブジェクト。このオプション・パラメータを使用して、顧客情報を取得します。担当者のデフォルト値。システム・ルックアップ・オブジェクトのリストの詳細は、「システム・ビジネス・オブジェクト」を参照してください。
channelType	メソッドがコールされるチャネルのタイプ。たとえば、チャネルがPHONEで、channelTypeが指定されていない場合、デフォルト値はORA_SVC_PHONEに設定されます。詳細は、「チャネル・タイプ・データ」を参照してください。

レスポンス・オブジェクトのメンバー属性のリストを次に示します。オブジェクトに戻り値がありません。

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

ノート: newCommEventメソッドは、相互作用オブジェクトの作成をトリガーします。このオブジェクトには、通信に関連する情報および通信に関連するオブジェクトが含まれます。対話の識別子は、SVCMCA_INTERACTION_IDトークンの値としてコールバック・レスポンスとともに返されます。メソッドの以降の呼び出しでは、このトークンとその値を、ほかのIVRデータとともに「サービス・センター」に送信する必要があります。

転送に対してnewCommEventメソッドが呼び出されると、ツールバーはSVCMCA_PARENT_INTERACTION_IDトークンを使用してIVRデータおよび発信元通信相互作用IDを「サービス・センター」に送信し、通信イベントが関連付けられます。また、SVCMCA_2NDARY_CALL_TYPEトークンを指定して、このコールが転送、確認または会議のいずれであるかを指定する必要があります。

このメソッドの呼出しに使用されるコードの例を次に示します。

<html>
<head>
<script type="text/javascript" src="http://domain:port/ora_support/js/mcaInteractionV1.js"> 
</script>
<script type="text/javascript">
function inboundCallNotification() {
      var inData = {};
      inData.SVCMCA_ANI = '5551234';
      inData.SVCMCA_CONTACT_ID = '1234567890';
      svcMca.tlb.api.newCommEvent('PHONE', 'ORA_SERVICE', '12345-1234-67890', inData, null, function (response) {
        if (response.result == 'success') {
          console.log('Customer: '+response.outData.SVCMCA_CONTACT_NAME +' ('+response.outData.SVCMCA_CONTACT_ID +')');
          console.log('Account: '+response.outData.SVCMCA_ORG_NAME +' ('+response.outData.SVCMCA_ORG_ID +')');
          alert('Success! Results available in log.');
        } else {
          alert('Operation finished with error: ' + response.error);
        }
      },'ORA_SVC_PHONE');
    }</script>
</head>
<body>
<input type="button" value="Get customer data" onclick="inboundCallNotification()"/>
</body>
</html>