GETRICHMESSAGE

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

依存関係

• このアクションにはDigital Experienceが必要です。
• デジタルスクリプトを使用する前に、従来のACDスクリプトとデジタルスクリプトの違いについて説明します。
• AskCaller またはTExtMsgのいずれかのアクションと一緒に使用する必要があります。
• スクリプトではGETRICHMESSAGEをAskCallerまたはTExtMsgの前に配置します。

• リッチメッセージのコンテンツタイプのサポートは、以下のドロップダウンにあるように、チャネルによって異なります。

  詳細を見る

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

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

デジタル

類似アクションの比較

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

• AskCaller：デジタルチャットベースのチャネルでコンタクトに情報をリクエストします。リッチメッセージング ボタン、画像、メニュー、オプションピッカーなどのデジタルメッセージの要素。コンテンツを表示できます。
• GetRichMessage：CXoneでチャネルの設定からリッチメッセージテンプレートを取得します。
• Textmsg：コンタクトにテキストベースのメッセージを送信します。リッチメッセージングコンテンツを表示できます。

入力プロパティ

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

プロパティ	説明
を追加	スクリプト内でこのアクションを一意に識別できる、短いフレーズを入力します。アクションアイコンにカーソルを合わせるとキャプションが表示されます。The default is the action name.
channelID	このスクリプトがメッセージ送信に使用するデジタルチャネルを選択します。

出力プロパティ

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

プロパティ	説明
resultSet	CXoneから返されたJSONを保持します。変数の内容を、AskcallerまたはTExtmsgにJSON文字列として渡します。

結果ブランチ条件

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

条件	説明
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. GETRICHMESSAGEのChannelIdプロパティを、テンプレートを割り当てたポイントオブコンタクト(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は、GETRICHMESSAGeのresultSetプロパティのデフォルトの変数名です。jsonY変数は、AskCallerとTextmsgのMessageプロパティで使用されます。
8. AskCallerまたはTextmsgを設定します。
   1. MessageFormatプロパティをJSONに設定します。
   2. Messageを、送信するテンプレートのJSONを保持する変数の名前で設定します。これはJSON文字列として送信されなければなりません。このフィールドで変数置換を使用できます。その場合は、送信するテンプレートを選択して適切な変数を渡すコードをSnippetに追加します。
   3. ブランチの接続など、必要に応じてアクションのその他のプロパティを設定します。ASKCALLERアクションまたはTeXTMSGアクションのオンラインヘルプを参照してください。

スクリプトの例

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

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