Asrdigits

音声入力を数字の文字列としてキャプチャし、それを使用してスクリプト変数を設定できます。

このアクションは、入力が実際には数値であるが数値ではない場合に適しています（たとえば、12345が "one two three four five"と発声された場合）。 Asrdigitsは電話番号、口座番号、社会保障番号などをキャプチャするために使用できます。

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

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

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

電話

入力プロパティ

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

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

結果分岐条件

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

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

スクリプトの例

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

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

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

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

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

ヒントとコツ

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