ASRDIGITS

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

音声入力を数字の文字列としてキャプチャし、それを使用してスクリプト変数を設定できます。このアクションは、入力が本質的に数値であるが数値ではない場合に適しています (たとえば、12345 は "1 つ、2、3、4、5" と発声されます)。 Asrdigitsは電話番号、口座番号、社会保障番号などをキャプチャするために使用できます。

このアクションは、0から9までの数字の所定のリストを認識し、「oh」または「zero」はゼロとして受け入れられます。発信者の発話が「12」や「23」など2桁以上の数字である可能性がある場合、またはプロンプトが数値(年齢や平方フィートなど)を要求する場合は、代わりにASRNUMBER アクションを使用します。

ASRアクションは、組織でASRが有効になっている場合にのみ表示されます。 ASRはオプション機能です。詳細については、アカウント担当者にお問い合わせください。

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

電話

入力プロパティ

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

プロパティ	説明
Add Caption	スクリプト内でこのアクションを一意に識別できる、短いフレーズを入力します。アクションアイコンにカーソルを合わせるとキャプションが表示されます。
Sequence	アクションが再生するプロンプトを定義します。プロンプトは、事前に録音されたWAVオーディオファイルまたはテキスト読み上げ(TTS) ユーザーが録音プロンプトをテキストとして入力し、コンピューターで生成された音声を使用してその内容を読み上げる機能。 (TTS)を使用できます。プロンプトがオーディオファイルの場合は、ファイル名を二重引用符で囲んで入力します。たとえば、"greeting.wav"とします。オーディオファイルが別のフォルダーにある場合は、ファイルへのパスを含めてください。たとえば、スクリプトがルートフォルダーにあり、オーディオファイルがその2つ下のレベルのサブフォルダーにある場合、"Subfolder\Subfolder2\Audio-file.wav"と入力します。スクリプトがルートから1レベル下のサブフォルダーにあり、オーディオファイルがそれと同じレベルの別のサブフォルダーにある場合、"\..\Subfolder\Audio-file.wav"と入力します。プロンプトがテキスト読み上げの場合は、TTS ユーザーが録音プロンプトをテキストとして入力し、コンピューターで生成された音声を使用してその内容を読み上げる機能。サービスで読み上げるテキストを入力します。各セグメントは、二重引用符で囲み、情報の種類を識別するための文字列参照文字を含める必要があります。例： "%アカウントの残高は""silence.wav""${accountBalance}" このプロパティでプロンプトをフォーマットする方法（使用する文字列参照プレフィックス文字など）については、プロンプトのページを参照してください。シーケンスプロパティを持つ一部のアクションは、プロンプトの作成に使用できるグラフィカルインターフェイスであるシーケンスエディターにアクセスできます。このアクションは、このエディターにアクセスしません。ただし、Playなどのシーケンスエディターをサポートするアクションからシーケンスエディターを使用することができます。 Playをスクリプトに追加し、プロンプトシーケンスを作成します。のシーケンスPlayフィールドからのシーケンステキストをこのアクションにペーストしてから、Playを削除します。
Phrase	このプロパティを使用して、プロンプトに含めるテキストを定義します。このプロパティはスクリプトでは使用されません。プロンプトの中には複雑で複数のセグメントを含むものがあるため、Sequenceフィールドで必要な書式設定を行わずに書かれたテキストを含めると便利な場合があります。
High Confidence	ASRエンジンは、発信者が話したフレーズを認識すると、音声認識での一致の信頼度を示すパーセンテージも返します。スクリプトは、この認識パーセンテージをこのプロパティの値と比較し、パーセンテージが値以上の場合、OnHighConfidenceブランチが実行されます。 MinConfidence値と100の間の整数を入力します。デフォルト値は72です。
Min Confidence	認識一致のための最小許容信頼度パーセンテージを定義します。認識率がこの値とHighConfidence値の間にある場合、OnMedConfidenceブランチが実行されます。これにより、通常、コンタクトは発話のASR理解を確認できます。認識率がこの値を下回る場合、OnNoConfidenceブランチに移行します。これを変更するには、1からHighConfidence値までの整数を入力します。デフォルト値は51です。
Timeout Seconds	IVR 対話型音声応答。自動電話メニューのコンタクトは、音声入力またはキー入力を介して、情報の取得、着信音声コールのルーティング、またはその両方を行います。がOnTimeoutブランチをとる前に（音声またはキープレスによる）入力を待つ時間を決定します。これは、回線が完全に無音になるしきい値です。デフォルト値は10（秒）です。変更するには、整数を入力します。重要タイマーは、プロンプトが完全に終了したときにのみ開始されます。ただし、システムには、プロンプトの長さを含む2分（120秒）の制限が組み込まれています。アクション中にこの制限に達すると、アクティブなプロンプトはすべて中止され、スクリプトはOnError分岐します。このため、プロンプトの長さを把握し、このフィールドに値を設定して、アクションが2分未満アクティブになるようにする必要があります。
Result Var Name	連絡先の音声入力または手動入力の認識結果を保持する変数の名前を決定します。たとえば、プロンプトが連絡先に生年月日を言うか入力するように要求した場合、結果はこのプロパティで定義された変数に格納されます。デフォルト値は、アクションの名前+ "結果"です（たとえばASRDIGITSResult）。連絡先が音声入力を提供し、ASRエンジンが一致を見つけられない場合、この変数は入力されません。アクションにOnDTMFブランチがある場合は、Captureアクションを使用して変数値をバッファーからプルする必要があることに注意してください（DTMF値は自動的にバッファーに格納されます）。
Confidence Var Name	ASRエンジンによって返される信頼度のパーセンテージを保持する変数の名前を決定します。デフォルト値はASRConfです。
Detect DTMF	IVRスクリプトを構成して、音声入力と手動入力の両方のDTMF コンタクトが電話のキーパッドのキーを押したときに生成されるシグナリングトーン。入力を処理できます。値がTrueまたはYesの場合、音声入力とDTMF入力の両方が受け入れられます。連絡先がDTMFディジットを押すと、スクリプトは進行中のプロンプトシーケンスを直ちに停止し、OnDTMFブランチを実行します。アクションの間、発話は考慮されません。値がFalseまたはNoの場合、コンタクトがキーを押してもDTMF入力は認識されません。アクション中に押されたDTMFディジットはDTMFバッファに保存されますが、アクションはNoConfidenceブランチを実行します。値モード：YesをクリックしてDTMF検出を有効にします。式モードTrueを入力してDTMF検出を有効にします。このアクションにはOnDTMFブランチがないため、DTMF値はResultVarNameで指定された結果変数に格納されます。
Clear Digits	連絡先が電話のキーパッドのキーを押すと、生成されたDTMFトーンがバッファに保存されます。数字をクリアがはいまたはTrueに設定されている場合、そのバッファはこのアクションの開始時にクリアされます。 Falseに設定され、DTMFトーンがバッファ内のこのアクションに持ち越される場合、DTMFトーンは直ちに検出されます。このとき、以前のアクションに関連するキーが押された場合でも、アクションはOnDigitまたはOnDTMFブランチを呼び出します。 Yes/True がデフォルトの値です。有効にするには値モード：Noをクリックします。有効にするには式モードFalseと入力します。
Inter Digit Timeout	コンタクトが数字を入力した後、次の数字を入力するかどうかをシステムが待機する時間。タイムアウトを処理するためのスクリプトロジックを作成する必要があります。
Min Digits	スクリプトを続行するためにこのアクションで受信する必要がある最小桁数を決定します。たとえば、プロンプトがコンタクトの社会保障番号を要求する場合、この値は9に設定する必要があります。デフォルト値は1です。プロンプトが常に同じ桁数の応答をリクエストする場合は、このプロパティをMaxDigitsと同じ値に設定します。
Max Digits	ユーザーがアクションに提供できる最大桁数。たとえば、プロンプトが個人の社会保障番号の下4桁をリクエストする場合、この値を4に設定します。デフォルト値は11です。プロンプトがシャープ記号（#）などのターミネーターを必要とする場合は、MaxDigits値でそれを考慮する必要があります。例えば、録音されたメニューメッセージで社会保障番号の下4桁に続けてシャープ記号の入力を求める場合は、値を5に設定します。 MaxDigits値に達すると、スクリプトはMaxDigitsブランチが接続されていれば、それに従って実行を続けます。
Term Digit	ターミネータの数字を入力して情報を提供することを連絡先が完了したことを示す方法を指定できます。最も一般的な値は＃です（つまり、発信者は自分の電話でシャープキーを押します）。デフォルトでは、TermDigitは、ASRDIGITSResult変数に受信および格納される数字の1つとして含まれています。この値を自動的に削除するには、このフィールドにダッシュ（-）を追加します（たとえば、シャープ記号を使用して、保存されている結果から削除するには、#-と入力します）。

結果分岐条件

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

条件	説明
Default	スクリプトが他のブランチのいずれかを取る必要がある条件を満たさない限り、パスが取られます。他のブランチが未定義の場合にも使用されます。
HighConfidence	信頼度がHigh Confidenceプロパティで設定された値を超えている場合に使用されるパス。
MedConfidence	ASRエンジンから返された認識率がHighConfidence値とMinConfidence値の間にある場合に分岐します。このブランチは、呼び出し側がASRYESNO アクションを使用して提供された情報を確認できるようにするためによく使用されます。
NoConfidence	ASRエンジンから返された認識率がMinConfidence値よりも小さい場合に取られるパス。
Timeout	指定された秒数の間応答がない場合に取られるパス。
Error	予期しない問題（たとえば、接続不良、構文エラーなど）が発生したときに使用されるパス。 _ERR変数には、問題の簡潔な説明を入力する必要があります。
MaxDigits	発信者の入力がMaxDigits値に達したときに取られるパス。
Terminator	呼び出し元がプロパティで指定された値を提供するときに取られるパス。
InterDigitTimeout	プロンプトに対する呼び出し側のDTMF応答中に、InterDigitTimeoutプロパティで指定された時間が経過したときに取られるパス。

ヒントとコツ

VoiceparamsアクションからlanguageLocale変数を渡すことで、アクションが検出する言語を設定できます。
数字を発音する際、「マイナス」はハードコードされています。
数字を発音する際、「ポイント」はハードコードされています。
詳細は、「ASRの概要」を参照してください。
DTMFトーンはバッファに保存されます。アクションにOnDTMFまたはOnDigitsブランチが含まれている場合は、Captureアクションを使用してDTMF値をバッファから引き出す必要があります。
複数のDTMFプレスをキャプチャする場合、アクションは最初のDTMFが押されたときにすぐにOnDTMFブランチを取得します（*と＃を含む）。この場合、Captureアクションで複数のプレスをキャプチャする必要があります。
バッファにDMTFが存在し、ClearDigitsがTrueに設定されていない場合、OnDTMFブランチがすぐに実行され、Captureアクションが必要になります。

スクリプトの例

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

このサンプルスクリプトでは、通話をエージェントに接続する前に、発信者の口座番号が取得されます。 Asrdigitsアクションを使用して、IVRが発信者に最小6桁、最大12桁の口座番号を入力するよう促します。認識率がHighConfidence値に達するかそれを超えた場合、メッセージが再生され、通話はエージェントにルーティングされます。このパスは、TermDigit値が提供された場合やInterDigitTimeoutが発生した場合にも従われます。

システムが入力に自信がない場合(つまり、認識率がHighConfidence値とMinConfidence値の間にある場合)、OnMedConfidenceブランチはAsryesnoアクションを使用して、取得した入力を再生し、発信者に「はい」または「いいえ」で確認するよう求めます。「はい」と答えた場合、通話はOnHighConfidenceブランチに進みます。「いいえ」と答えた場合、発信者は再入力のためにAsrdigitsアクションに戻ります。 3回失敗すると、Loopアクションがコンタクトに電話をかけ直すように促し、通話を切断します。この通話フローは、AsrdigitsとAsryesnoの間の双方向接続により実現されています。

入力が正しい可能性がない場合(たとえば、発信者が数値以外の応答をした場合)、システムはOnNoConfidenceブランチに移行し、発信者をAsrdigitsアクションに戻して再入力を促します。 3回失敗すると、Loopアクションがコンタクトに電話をかけ直すように促し、通話を切断します。

このスクリプトをダウンロードしますか？