Get Bot Transcript

仮想エージェントと連絡先の間の会話のトランスクリプトを返します。 このアクションは、会話の意図情報を返すこともできます。 キャプチャされる正確なデータは、Virtual Agent Hubの仮想エージェントアプリのページで選択した構成設定によって異なります。 トランスクリプトのみ、インテントのみ、トランスクリプトとインテント、または何もキャプチャできません。 キャプチャしたデータは変数に格納されます。 格納されたデータは任意の方法で使用できますが、管理するようにスクリプトを設定する必要があります。 たとえば、人間のエージェントに転送される相互作用については、Runappアクションを使用してエージェントアプリケーションにトランスクリプトを渡すことができます。 サポートされている仮想エージェントでGet Bot Transcriptを使用します。 詳細については、このページの依存関係セクションを参照してください。

依存関係

• Get Bot Transcriptは、次の仮想エージェントプロバイダーをサポートしています。

  • Amazon Lex V1 (音声とチャット)
  • Amazon Lex V2 (音声とチャット)
  • Cognigy (チャットのみ)
  • CXone MpowerSmartAssist Powered by Amelia (チャットのみ)
  • Google Dialogflow ES (音声とチャット)
  • Google Dialogflow CX (音声とチャット)
  • IBM Watson (チャットのみ)
  • Microsoft Azure (音声とチャット)
  • Nuance Mix (音声とチャット)
  • Omilia (チャットのみ)
  • Salesforce Einstein (チャットのみ)
  • カスタムバーチャルエージェント統合(音声とチャット)
• このアクションは、SIP 音声通話やビデオ通話などのマルチメディア通信セッションのシグナリングと制御に使用されるプロトコル。バックチャネル接続を使用する音声仮想エージェント統合での使用はサポートされていません。
• このアクションを使用する仮想エージェントのVirtual Agent Hubの設定アプリのページで、トランスクリプトオプションを有効にする必要があります。
• キャプチャされたデータは、連絡先IDの有効期間中、一時的に保存されます。 データを保存する必要がある場合は、アーカイブに送信するようにスクリプトを設定する必要があります。
• すべてのバーチャルエージェントStudioアクション：Textbot Exchange、Voicebot Exchange、およびVoicebot ConversationでGet Bot Transcriptを使用できます。

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

チャット	電話	デジタル

入力プロパティ

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

プロパティ	説明
Add Caption	スクリプト内でこのアクションを一意に識別できる、短いフレーズを入力します。 アクションアイコンにカーソルを合わせるとキャプションが表示されます。
Format	トランスクリプトを返却する形式を入力します。サポートされている形式はHTMLとJSONです。

出力プロパティ

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

プロパティ	説明
TranscriptVarName (out)	転写されたテキストが含まれています。 デフォルトの変数はtranscriptOutです。 このプロパティの変数としてを使用は使用しないでくださいtranscript。 予期せぬ動作の原因となります。

結果分岐条件

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

条件	説明
Default	スクリプトが他のブランチのいずれかを取る必要がある条件を満たさない限り、パスが取られます。 他のブランチが未定義の場合にも使用されます。
Error	アクションが正しく実行されなかったときにとられるパス。 たとえば、接続不良、構文エラー、HTTPエラーコードなど予期しない問題が発生したときに使用されるパス。 ERR変数には、問題の簡潔な説明を入力する必要があります。
Success	アクションがエラーなしで完了し、API呼び出しまたはデータの戻りが成功した場合に実行されるパス(2xx応答コード)。

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

このアクションはTranscriptスニペットコードが必要です。 このコードは、トランスクリプトデータを保持する動的オブジェクトを作成します。 また、トランスクリプトの内容をオブジェクトから変数にコピーし、エージェントアプリケーションに渡せるようにします。

スクリプト例

このスクリプト例は、Voicebot Exchangeアクションを使用する仮想エージェントスクリプトです。 仮想エージェントがインタラクションを人間のエージェントに転送する必要があることを通知する時のためのブランチが含まれています。 下の画像にそのブランチを示します。

人間のエージェントが通話に応答すると、Get Bot Transcriptアクションはトランスクリプトを要求し、返されたデータをSnippetアクションに渡します。 スニペットコードは、myTranscriptと呼ばれる動的データオブジェクトを作成します。 そして、データをJSONに変換し、transcriptHtmlという変数に格納します。 これにより、データをエージェントアプリケーションに送信できるようになります。 Runappアクションは、トランスクリプトを含むウェブページを表示するように構成されています。

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