Get Bot Transcript

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

Dependencies

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

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

Supported Script Types

チャット	電話	デジタル

Input Properties

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

プロパティ	説明
Caption	Captionを、スクリプト内でこのアクションを一意に識別するものに変更します。IVRプレスパスレポートには、アクション名とキャプションが含まれます。キャプションを説明的でユニークなものにすると、レポートが読みやすく、理解しやすくなります。
Format	トランスクリプトを返却する形式を入力します。サポートされている形式はHTMLとJSONです。

Output Properties

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

プロパティ	説明
TranscriptVarName (out)	転写されたテキストが含まれています。

Result Branch Conditions

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

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

Required SNIPPET Action Code

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

Example Script

この例は完全なスクリプトではありません。このアクションを使用するには、追加のスクリプト作業が必要です。

The example script shows a virtual agent script that uses the Voicebot Exchange action. It includes a branch for when the virtual agent signals that the interaction needs to be transferred to a human agent. That branch is shown in the image below.

When the human agent answers the call, the Get Bot Transcript action requests the transcript and passes the returned data to the Snippet action. The snippet code creates a dynamic data object called myTranscript. It then converts the data into JSON and stores it in a variable called transcriptHtml. This allows it to be sent to エージェントアプリケーション. The Runapp action is configured to display a web page that contains the transcript.

Download script.