GETRICHMESSAGE

このヘルプページはStudio向けです。 この情報は、Desktop Studio用にも提供されています。

下向き矢印が付いた線入りの吹き出し。

リッチメッセージJSONを、デジタルAskCallerアクションまたはTExtMsgアクションに渡します。  これにより、スクリプトでJSONを構築する代わりに、ACDのポイントオブコンタクト(PoC)デジタルページで作成されたリッチメッセージテンプレートをスクリプトで使用することができます。

依存関係

  • このアクションにはDigital Experienceが必要です。
  • デジタルスクリプトを使用する前に、従来のACDスクリプトとデジタルスクリプトの違いについて説明します。
  • AskCaller またはTExtMsgのいずれかのアクションと一緒に使用する必要があります。
  • スクリプトではGETRICHMESSAGEAskCallerまたはTExtMsgの前に配置します。
  • リッチメッセージのコンテンツタイプのサポートは、以下のドロップダウンにあるように、チャネルによって異なります。

  • リッチメッセージテンプレートを作成して、CXone Mpowerのポイントオブコンタクト(PoC)デジタルのページでこのアクションと一緒に使用します。 リストピッカー、タイムピッカー、リッチリンク、クイックリプライのテンプレートを作成できます。 他のリッチメディアを使う必要がある場合は、GETRICHMESSAGEは使用できません。 代わりにJSONをSnippetアクションでビルドして、これをAskCallerまたはTExtMsgに直接渡す必要があります。 詳細については、これらのアクションのオンラインヘルプの依存関係セクションを参照してください。

サポートされているスクリプトタイプ

デジタル

類似アクションの比較

以下のアクションには同様の機能がありますが、いくつかの重要な相違点があります。

入力プロパティ

これらのプロパティは、アクションが実行時に使用するデータを定義します。

プロパティ

説明

Add Caption

スクリプト内でこのアクションを一意に識別できる、短いフレーズを入力します。 アクションアイコンにカーソルを合わせるとキャプションが表示されます。

channelID

このスクリプトがメッセージ送信に使用するデジタルチャネルを選択します。

出力プロパティ

これらのプロパティには、実行したアクションから返されたデータを保持する変数が含まれています。 これらはアクションが完了したときに参照・使用することができます。

プロパティ

説明

resultSet CXone Mpowerから返されたJSONを保持します。 変数の内容を、AskcallerまたはTExtmsgJSON文字列として渡します。

結果分岐条件

結果の分岐条件を使用すると、アクションが実行されたときにさまざまな結果を処理できるように、スクリプトにブランチを作成できます。

条件

説明

Default

スクリプトが他のブランチのいずれかを取る必要がある条件を満たさない限り、パスが取られます。 他のブランチが未定義の場合にも使用されます。

エラー

アクションが正しく実行されなかったときにとられるパス。 これは例えば、接続不良、構文エラーなど予期しない問題が発生した場合などです。 _ERR変数に1つのアンダースコア文字がある場合、問題の簡潔な説明を入力する必要があります。

成功

アクションがエラーなしで完了し、API呼び出しまたはデータの戻りが成功した場合に実行されるパス(2xx応答コード)。

必要なSNIPPETアクションコード

このアクションは、GETRICHMESSAGEアクションがデジタルポイントオブコンタクト(PoC)から返すリッチメディアテンプレートを処理するコードを持つ、Snippetアクションを必要とする場合があります。 ポイントオブコンタクト(PoC)にテンプレートが1つしかない場合、スニペットコードは必要ありません。 Result Setプロパティで指定された変数を使用できます。 複数のテンプレートを持つポイントオブコンタクト(PoC)の場合にはスニペットコードが必要です。

  1. ACDアプリケーションのポイントオブコンタクト(PoC)デジタルページでテンプレートを作成し、それを適用したいポイントオブコンタクト(PoC)に割り当てます。 このステップを完了するには、CXone Mpower管理者の協力が必要な場合があります。

  2. デジタルメディアタイプのスクリプトを作成します。

  3. GETRICHMESSAGEアクションと、ASKCALLERアクションTeXTMSGアクションを追加します。 ポイントオブコンタクト(PoC)にテンプレートが複数ある場合、SNIPPETアクションも必要です。
  4. GETRICHMESSAGEChannelIdプロパティを、テンプレートを割り当てたポイントオブコンタクト(PoC)で設定します。
  5. SNIPPETアクションに適切なコードを追加します。
    • テンプレートが1つしかない場合や、このスクリプトで送信したいテンプレートが1つだけの場合は、次のようなコードを使用してください:

      DYNAMIC json1 
      ASSIGN json1.data[1] = resultset.data[1]
    • 複数のテンプレートがあり、このスクリプトで複数のテンプレートを送信したい場合は、次のようなコードを使用してください:

      DYNAMIC json1
      DYNAMIC json2
      DYNAMIC json3
      				 
      ASSIGN json1.data[1] = resultset.data[1]
      ASSIGN json2.data[1] = resultset.data[2]
      ASSIGN json3.data[1] = resultset.data[3]
  6. 送信するテンプレートを識別するインデックス番号を変更します。 前のステップのコード例では、変数resultset.data[x]のインデックス番号を変更します。 テンプレートを割り当てる変数内のインデックスを変更しないでください。 コード例では、変数はjsonY.data[Z]であり、Yは変更できますが、Zは変更できません。 jsonY変数ごとに1つのテンプレートを保持します。
  7. 必要であれば変数名を変更してください。 その場合は、必要に応じてスクリプトの他のアクションでも変数名を変更します。 たとえば、resultSetは、GETRICHMESSAGeresultSetプロパティのデフォルトの変数名です。 jsonY変数は、AskCallerTextmsgMessageプロパティで使用されます。
  8. AskCallerまたはTextmsgを設定します。
    1. MessageFormatプロパティをJSONに設定します。
    2. Messageを、送信するテンプレートのJSONを保持する変数の名前で設定します。 これはJSON文字列として送信されなければなりません。 このフィールドで変数置換を使用できます。 その場合は、送信するテンプレートを選択して適切な変数を渡すコードをSnippetに追加します。
    3. ブランチの接続など、必要に応じてアクションのその他のプロパティを設定します。 ASKCALLERアクションまたはTeXTMSGアクションのオンラインヘルプを参照してください。

スクリプトの例

これは、このアクションをスクリプトでどのように使用できるかを示す例です。 完全なスクリプトではありません。 追加のスクリプト作成が必要な場合があります。

この例は、TeXTMSGに接続されたSNIPPETアクションに接続されているGETRICHMESSAGEアクションを示しています。 これはASKCALLERに接続される場合もあります。 スクリプトが実行されると、GETRICHMESSAGEは、ChannelIdで指定されたデジタルチャネル用に利用できるリッチメッセージテンプレートを取得します。 これらはResult Setプロパティで指定された変数に格納されます。 この例では、変数はresultIdです。 スニペットコードには、特定のリッチメッセージテンプレートJSONを保持するダイナミックデータオブジェクトが含まれており、これをTeXTMSGに渡します。