Get Bot Transcript

Icon for the Get Bot Transcript action - a yellow circle with a piece of paper with lines on it inside.

仮想エージェントと連絡先の間の会話のトランスクリプトを返します。このアクションは、会話の意図情報を返すこともできます。キャプチャされる正確なデータは、バーチャルエージェントハブの仮想エージェントアプリのページで選択した構成設定によって異なります。トランスクリプトのみ、インテントのみ、トランスクリプトとインテント、または何もキャプチャできません。

キャプチャしたデータは変数に格納されます。格納されたデータは任意の方法で使用できますが、管理するようにスクリプトを設定する必要があります。たとえば、人間のエージェントに転送される相互作用については、Runappアクションを使用してエージェントアプリケーションにトランスクリプトを渡すことができます。

サポートされている仮想エージェントでGet Bot Transcriptを使用します。詳細については、このページの依存関係セクションを参照してください。

依存関係

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

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

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

The icon for the Chat script type - a chat bubble with an ellipsis inside (...), in a diamond shape.

The icon for the Phone script type - an old-style phone handset with curved lines indicating sound coming out of it.

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

チャット 電話 デジタル

入力プロパティ

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

プロパティ

説明

Caption

Captionを、スクリプト内でこのアクションを一意に識別するものに変更します。IVRプレスパスレポートには、アクション名とキャプションが含まれます。キャプションを説明的でユニークなものにすると、レポートが読みやすく、理解しやすくなります。

Format

トランスクリプトを返却する形式を入力します。サポートされている形式はHTMLJSONです。

出力プロパティ

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

プロパティ

説明

TranscriptVarName (out)

転写されたテキストが含まれています。

結果ブランチ条件

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

条件

説明

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

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

OnSuccess

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

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

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

スクリプト例

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

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

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

Get Bot Transcriptアクションを含むスクリプトの例。

前述のスクリプト例はVoicebot Conversationアクションを使用しています。Get Bot Transcriptは、Voicebot ExchangeTextbot ConversationおよびTextbot Exchangeと併用することもできます。

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