テレフォニー統合用に 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] ボックスがオンになっていることを確認して、[送信] をクリックします。DTMF 入力に対するレスポンスがシミュレータに表示されます。