Workflow Execute

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

Workflow Executeを使えば、CRM 連絡先、販売情報、サポートの詳細、ケース履歴などを管理するサードパーティのシステム。とCXone AgentまたはCXone Agent Integratedを統合することができます。このアクションはワークフローを実行します。ワークフローには、コンタクトのデータを表示したり、チケットを作成したりすることなどが含まれます。スクリプトで使用されるその他のアクションは、エージェントが電話に出たときに、結果と関連データをエージェントアプリケーションに送信します。また、その他のアクションでは、通話が完了した際に必要な情報をCRMに引き渡します。

スクリプトがワークフローを実行する間、コンタクトに対して再生する音楽ファイルやその他の音声シーケンスを定義することができます。

依存関係

このアクションを設定する前に、CXoneにCRM 連絡先、販売情報、サポートの詳細、ケース履歴などを管理するサードパーティのシステム。統合を追加し、使用するワークフローを有効にする必要があります。CRMをCXone Agent、CXone Agent Embedded、およびCXone Agent Integratedと統合することができます。
スクリプトで使用したいワークフローごとに、別のWorkflow Executeアクションを使用する必要があります。必要に応じて、スクリプトに複数のWorkflow Executeアクションを含めることができます。
このアクションで設定ウィザードを使用するには、CXoneにログインしているか、[ログイン]ボタンを使ってStudioにCXoneのユーザー名とパスワードでログインしている必要があります。CXoneにログインしていない状態で、[セッションIDでログインする]ボタンを使用してログインした場合、ウィザードは表示されません。これは、ウィザードへのアクセスがグローバル認証に依存しているためです。グローバル認証は、CXoneのユーザー名とパスワードでログインする場合にのみ使用されます。
ワークフローの結果をエージェントアプリケーションに送信するには、スクリプトにCustom Eventアクションを含める必要があります。Custom Eventアクションは特定のイベントを呼び出す必要があります。イベントは、CXone Agent、CXone Agent Embedded、またはCXone Agent IntegratedとCRMを統合するスクリプトの作成に関するオンラインヘルプで説明されています。
このアクションは、Agent Workflow Configurationアクションと一緒に使用する必要があります。CRM統合スクリプトでのみ使用できます。

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


電話	デジタル

入力プロパティ

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

プロパティ	説明
キャプションを追加	スクリプト内でこのアクションを一意に識別できる、短いフレーズを入力します。アクションアイコンにカーソルを合わせるとキャプションが表示されます。
Configuration Id	設定IDを保持する変数名を入力します。中括弧（{ }）で囲んで書式設定します。例えば、 {integrationConfigId}です。
Workflow Id	ワークフローIDを保持する変数名を入力します。中括弧（{ }）で囲んで書式設定します。例えば、 {searchWorkflowId}です。ワークフローIDは、CXoneのエージェント統合設定ページで確認できます。
Workflow Payload	このアクションが処理するワークフローペイロードを保持する変数名を入力します。名前を中括弧（{ }）で囲みます。ペイロードはJSONに変換される必要があります。例：{searchInput.asjson()}。
Sequence	アクションが再生するプロンプトを定義します。プロンプトがオーディオファイルの場合は、ファイル名を二重引用符で囲んで入力します。例えば、 "greeting.wav" 。プロンプトがテキスト読み上げの場合は、省略記号ボタンをクリックして、TTS ユーザーが録音されたプロンプトをテキストとして入力し、コンピューターで生成された音声を使用してコンテンツを話すことができるようにします。サービスに読み上げさせたいテキストを入力します。各セグメントは、二重引用符で囲み、情報の種類を識別するための文字列参照文字を含める必要があります。たとえば。 "%Your account balance is" "silence.wav" "${accountBalance}" このプロパティでプロンプトをフォーマットする方法の詳細については、プロンプトの管理のページを参照してください。 Playなど、それをサポートするアクションからシーケンスエディターを使用し、そのアクションのSequenceフィールドからシーケンステキストをコピーしてこのアクションに貼り付けることができます。このアクションでは、プロンプトの再生は任意です。
Phrase	このプロパティを使用して、プロンプトに含めるテキストを文書化します。スクリプトでは、このプロパティのテキストは使用しません。プロンプトの中には複雑で複数のセグメントを含むものがあるため、シーケンスプロパティで必要な書式設定を行わずに書かれたテキストを含めると便利な場合があります。
ActionType	これはスニペットです。
Dynamic Data Mapping ID	これはスニペットです。

出力プロパティ

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

状態	説明
errorArgs	エラーに関する情報を保持するための変数名を入力します。デフォルトの変数はworkflowErrorOutputです。変数名を中括弧で囲んでフォーマットする必要はありません。
resultSet	指定したワークフローの結果を保持する変数名を入力します。デフォルトの変数はworkflowResultOutputです。このフィールドには中括弧は必要ありません。
cacheKey	これはスニペットです。

結果ブランチ条件

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

状態	説明
Default	スクリプトが他のブランチのいずれかを取る必要がある条件を満たさない限り、パスが取られます。他のブランチが定義されていない場合にも使用されます。
InternalError	アクションでエラーが発生したときに取るべきパス。
InvalidWorkflow	指定されたワークフローが無効な場合に取るパス。
NotConfigured	テナントテクニカルサポート、請求、およびCXone環境のグローバル設定の管理に使用される高レベルの組織グループでエージェントの連携が有効でない場合のパス。この機能を有効にするには、 CXoneアカウント担当者にお問い合わせください。
Success	アクションがエラーなしで完了し、API呼び出しまたはデータの戻りが成功した場合に実行されるパス(2xx応答コード)。
Timeout	ワークフローの実行が、入力で指定されたタイムアウト値を超えた場合のパス。timeoutMilliSec = "6000"変数をWorkflow入力スニペットに追加し、このワークフローにタイムアウトを持たせたい場合に使用します。必要に応じて、秒数を変更します。
ValidationError	任意の入力が検証できない場合に取るべきパス。これは次を含んでいます：設定ID：CXoneのエージェント連携>設定ページにある有効な設定IDでなければなりません。ワークフローID：CXoneのエージェント連携>設定ページにある有効なワークフローIDでなければなりません。ワークフローペイロード：有効なJSON文字列でなければなりません。

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

このアクションには、カスタムコードを使用したSnippetアクションが必要です。

これらのスニペットをスクリプトに追加する方法については、CRMをCXone Agentアプリケーションと統合するためのオンラインヘルプページを参照してください。

スクリプトの例

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

次の例では、Workflow Executeアクションを使用して、CRMアプリケーションをCXone Agent、CXone Agent Embedded、またはCXone Agent Integratedと統合しています。ダウンロードするサンプルスクリプトを含む、アクションの使用に関する詳細情報は、統合プロセスに関するヘルプページにあります。