DTMF-Töne

Übersicht

Dual Tone Multi Frequency (DTMF) ist eine Form der Signalisierung, die von Telefonsystemen zur Übertragung der Ziffern 0-9 und die * und # Zeichen. In der Regel drückt ein Anrufer diese Tasten auf seiner Telefontastatur, woraufhin das Telefon einen Ton erzeugt, der aus zwei gleichzeitig gespielten Frequenzen besteht (daher Dual Tone).

DTMF wird sowohl für die Wahl eines Ziels auf einem Festnetztelefon als auch für die Signalisierung an die Gegenstelle verwendet, sobald ein Anruf angenommen wurde. Typischerweise wird dies verwendet, um ein Interactive Voice Response (IVR)-System zu implementieren oder um Informationen wie eine PIN-Nummer oder einen Konferenzgesprächs-Pin einzugeben. Die Vonage Voice API unterstützt sowohl das Sammeln von Informationen von Anrufern über die input Aktion in einer NCCO sowie das Senden von DTMF-Tönen innerhalb eines Anrufs.

Sammeln von Input

Sie können Eingaben von Ihrem Anrufer sammeln, indem Sie die input Aktion innerhalb Ihres NCCO. Sie können eine bestimmte Anzahl von Ziffern erfassen, einen Timeout-Wert festlegen oder warten, bis der Benutzer die Taste # Taste, bevor Sie fortfahren (siehe die Eingabeaktion). Sobald die Aktion abgeschlossen ist, sendet Vonage einen Webhook an Ihre event_url die die gedrückten Tasten enthält. Wenn Sie als Antwort auf dieses Ereignis ein neues NCCO zurückgeben, ersetzt Vonage das bestehende NCCO und ignoriert alle Aktionen, die nach dem input.

NCCO-Beispiel

[
  {
    "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
    }
  }
]

Die NCCO-Referenzhandbuch enthält Informationen über alle möglichen Parameter, die in Verbindung mit dem DTMF verwendet werden können input NCCO-Aktion.

DTMF-Senden

Es gibt zwei Möglichkeiten, DTMF-Töne an einen Anruf zu senden:

  1. Für einen ausgehenden Anruf, der entweder über Aufruf erstellen Endpunkt, oder über einen connect Aktion, können Sie die dtmfAnswer Parameter innerhalb des Telefon-Endpunkts. Das bedeutet, dass Vonage automatisch die definierte Tonfolge sendet, wenn der Anruf angenommen wird.

  2. Sie können auch jederzeit DTMF-Ziffern an einen Anruf senden, indem Sie eine PUT-Anfrage an die REST-APImit der Angabe einer Zeichenfolge von digits.

Sie können Ziffern verwenden 0-9, *und #. A p gibt eine Pause von 500 ms an, wenn Sie eine Verzögerung beim Senden der Ziffern einfügen müssen.

Fehlersuche

DTMF kann auf verschiedene Arten über digitale Telefonnetzwerke gesendet werden, bekannt als In-Band und Out-of-Band. Bei In-Band werden die Töne im Audiokanal des Anrufs abgespielt und sind für die Gesprächsteilnehmer hörbar. Bei der Out-of-Band-Signalisierung werden die Töne in einem separaten Signalisierungskanal gesendet und können von einem Anrufer, der am anderen Ende zuhört, nicht gehört werden. Wenn Sie also testen, ob Sie DTMF senden können, indem Sie Ihr eigenes Telefon anrufen, hören Sie die Töne möglicherweise nicht in Ihrem Hörer.

Auch bei DTMF kann es zu spezifischen Problemen mit dem lokalen Netzbetreiber kommen. Wenn Sie Schwierigkeiten bei der Verwendung von DTMF haben, wenden Sie sich bitte an Unterstützung mit Einzelheiten zu Ihrem Problem.