テレフォニー統合用の DTMF

テレフォニーのインテグレーション用に DTMF（デュアルトーンマルチ周波数信号）を有効にして構成できます。有効にすると、エンドユーザーが電話で押したキーが通常のテキストに変換され、エージェントによってエンドユーザー入力として処理されます。この変換は、電話キーの押下（12*34#）に関連する文字と同様に簡単なものにできます。または、より複雑なシーケンスの場合は正規表現（regex）を使用することもできます。

一致するルール

DTMF 設定には、次の 3 つの一致ルールがあります。

DTMF パターンを個々のインテントとエンティティに関連付けて、エンドユーザー入力シーケンスとの一致をトリガーできます。DTMF をグローバルに有効にすると、システムエンティティがデフォルトで有効になります。

システムエンティティルール

DTMF を有効にすると、システムエンティティルールがデフォルトで有効になります。

型名	DTMF パターン	例
`sys.percentage`	任意の整数	29 -> 29%
`sys.temperature`	任意の整数	30 -> 30C または 30F
`sys.phone-number`	任意の数字シーケンス	4081111111
`sys.date`	（言語 / 地域に応じて）YYYYMMDD（en-us）または MMDDYYY	20231001 -> 2023-10-01、10-01-2023 -> 10-01-2023
`sys.zip-code`	任意の数字シーケンス	94043
`sys.number`	ピリオドが「*」キーで表される数字のシーケンス	123 -> 123、123*45 -> 123.45
`sys.cardinal`	任意の数字シーケンス	12345
`sys.number-integer`	任意の数字シーケンス	12345
`sys.number-sequence`	任意の数字シーケンス	12345
`sys.ordinal`	任意の数字シーケンス	12345

設定

このセクションでは、DTMF を有効にするときに構成できる追加の設定について説明します。

終了ディジット

この設定では、その他の入力を待たずに DTMF 入力を直ちに終了するキーの押下を制御します。通常、この設定には # を使用します。変換されたエンドユーザー入力に終了ディジットが含まれていない。たとえば、終了ディジットが # であり、入力が 123# である場合、エージェント処理に提供される変換済みのエンドユーザー入力は 123 です。

ディジット間のタイムアウト時間

エンドユーザーがキー入力のシーケンスを入力する際に一時停止する場合があります。この一時停止時間がディジット間のタイムアウト時間よりも長い場合、Dialogflow はシーケンスの DTMF 処理を中止します。

Dialogflow が DTMF 処理を中止した場合、その時点でキャプチャされた変換されていないシーケンスをエンドユーザー入力としてエージェントに提供します。この入力はインテントまたはフォームパラメータと一致する可能性は低いため、Dialogflow は不一致イベントを呼び出すと考えられます。

コンソールを使用する場合、このフィールドは秒単位です。

エンドポイントのタイムアウト時間

キー入力シーケンスが一致すると、Dialogflow はキー入力の処理を続行します。エンドポイントタイムアウト時間は、Dialogflow が一致を検出した後でさらに入力を待機する時間です。この動作は、シーケンスが無制限の数などの可変長であるシナリオを処理します。

エンドユーザーがエンドポイントのタイムアウト時間に設定された時間を超えて入力を一時停止した場合、Dialogflow は DTMF 処理を中止し、現在一致しているシーケンスを通常どおり変換します。

DTMF を有効にする

DTMF は、エージェント、ページ、またはパラメータレベルで有効にできます。DTMF はスコープ内のすべての対象に適用されます。このセクションでは、エージェントに対して DTMF を有効にする方法について説明します。DTMF は、ページ設定（ページ）またはフロー設定（フロー）を使用して有効にすることもできます。また、パラメータを選択して設定メニューを表示することでも有効にできます。いずれの場合も、DTMF の設定はページの下部にあります。

[エージェントの設定] に移動し、[音声と IVR] タブを選択します。
ページの下部にある [DTMF を有効にする] チェックボックスをオンにします。
[終了ディジット]、[ディジット間のタイムアウト時間]、[エンドポイントタイムアウト時間] の値を設定します。これで、DTMF が該当するエージェントのスコープ内のすべての対象に対して有効になります。下位レベルで設定された場合、これらの設定は上位レベルの設定をオーバーライドします。DTMF パターンが定義されている場合は、該当するスコープ内のアクティブなスロットのアクティブなインテントまたはエンティティタイプがトリガーされる可能性があります。

インテントに DTMF パターンを追加する

左側のナビゲーションメニューで [管理] タブを選択し、[インテント] をクリックします。
表示されたリストからインテントを選択し、[DTMF パターン] ボックスに移動します。
DTMF シーケンスを入力します。より複雑な DTMF パターンの場合は、正規表現パターンを使用できます。
[保存] をクリックして、変更を保存します。

エンティティに DTMF パターンを追加する

左側のナビゲーションメニューで [管理] タブを選択し、[エンティティタイプ] をクリックします。
表示されたリストからエンティティタイプを選択します。[エンティティ] 表の [DTMF パターン] 列に移動します。
テーブル内のエンティティごとに DTMF パターンを設定します。より複雑な DTMF パターンの場合は、正規表現パターンを使用できます。
[保存] をクリックして、変更を保存します。

シミュレータで DTMF を使用する

DTMF 構成は、コンソールシミュレータでテストできます。

Dialogflow コンソールで、画面右上隅の [エージェントをテストする] をクリックします。
ポップアップしたパネルで、[+] テキスト入力ボックスの横にある + 記号をクリックします。[DTMF] を選択します。
テストする DTMF パターンと DTMF 終了ディジットを入力します。[Send new DTMF input] チェックボックスがオンになっていることを確認して、[Send] をクリックします。DTMF 入力に対するレスポンスがシミュレータに表示されます。