GETRICHMESSAGE

This help page is for Desktop Studio.This information is also available for CXone Studio.

Three shapes containing iconograhic representations of lists, imgs, and music files.

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

依存関係

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

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

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

The icon for the Digital script type - a computer monitor with a smartphone next to it.

デジタル

類似アクションの比較

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

入力プロパティ

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

プロパティ

説明

を追加

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

channelID

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

出力プロパティ

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

プロパティ

説明

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

結果ブランチ条件

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

条件

説明

Default

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

OnError

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

OnSucess

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

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

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

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

  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で指定されたデジタルチャネル用に利用できるリッチメッセージテンプレートを取得します。これらはresultIdプロパティで指定された変数に格納されます。この例では、変数はresultIdです。スニペットコードには、特定のリッチメッセージテンプレートJSONを保持するダイナミックデータオブジェクトが含まれており、これをTeXTMSGに渡します。

BEGIN、GETRICHMESSAGE、SNIPPET、TEXTMSGアクションを含むサンプルスクリプト。

このスクリプトをダウンロード