DTMFトーン

概要

デュアル・トーン・マルチ・フリークエンシー（DTMF）は、電話システムが数字を送信するために使用する信号の形式です。 0-9 そして * そして # 文字で構成される。通常、発信者は電話機のキーパッドでこれらのボタンを押し、電話機は2つの周波数からなるトーンを同時に発生させる（これがデュアル・トーンである）。

DTMFは、固定電話で相手先をダイヤルするときにも、通話に応答してリモート側に信号を送るときにも使用されます。 一般的にこれは、インタラクティブ音声応答（IVR）システムの実装や、PIN番号や電話会議のPINなどの情報を入力するために使用されます。 Vonage Voice API は、Vonage Voice API を使用して発信者から情報を収集することも、Vonage Voice API を使用して発信者から情報を収集することもサポートしています。 input NCCOのアクションと同様に、通話内でDTMFトーンを送信する。

インプットの収集

呼び出し元からの入力を収集するには input アクションを NCCO 内で実行できます。特定の桁数を集めたり、タイムアウト値を設定したり、ユーザーが # キーを押してください。 入力アクション).アクションが完了すると、VonageはWebhookをお客様の event_url 押されたキーを含む。このイベントに応答して新しいNCCOを返すと、Vonageは既存のNCCOを置き換えます。 input.

NCCOの例

[
  {
    "action": "talk",
    "text": "Please enter a digit",
    "bargeIn": true
  },
  {
    "eventUrl": [
      "https://api.example.com/callbacks/events"
    ],
    "action": "input",
    "type": [ "dtmf" ],
    "dtmf": {
      "maxDigits": 1,
      "submitOnHash": true,
      "timeOut": 5
    }
  }
]

について NCCOリファレンスガイド には、DTMF と組み合わせて使用できるすべてのパラメータに関する情報が含まれています。 input NCCOの行動

DTMF送信

通話にDTMFトーンを送信するには、2つの方法があります：

  1. アウトバウンドコールは 呼び出しを作成する エンドポイント、または connect アクションで dtmfAnswer パラメータを使用します。つまり、通話に応答すると、Vonageは自動的に定義されたトーン文字列を送信します。

  2. にPUTリクエストを行うことで、いつでも通話にDTMF数字を送信することもできます。 REST APIの文字列を指定する。 digits.

桁の数字が使えます。 0-9, *そして #.A p は、桁の送信に遅延を加える必要がある場合、500msのポーズを示す。

トラブルシューティング

DTMFは、インバンドおよびアウトオブバンドと呼ばれるいくつかの方法でデジタル電話ネットワークに送信できます。インバンドでは、トーンは通話のオーディオチャネルで再生され、通話の当事者に聞こえます。帯域外信号では、トーンは別の信号チャネルで送信されるため、相手側で聞いている通話相手には聞こえない場合があります。つまり、自分の電話機に電話をかけてDTMFの送信をテストする場合、イヤホンからトーンが聞こえない可能性があります。

DTMFはまた、特定のローカルキャリアの問題が発生する可能性があります。DTMFの使用に問題がある場合は、以下までご連絡ください。 サポート 問題の詳細をお知らせください。