[[["易于理解","easyToUnderstand","thumb-up"],["解决了我的问题","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["很难理解","hardToUnderstand","thumb-down"],["信息或示例代码不正确","incorrectInformationOrSampleCode","thumb-down"],["没有我需要的信息/示例","missingTheInformationSamplesINeed","thumb-down"],["翻译问题","translationIssue","thumb-down"],["其他","otherDown","thumb-down"]],["最后更新时间 (UTC):2025-08-18。"],[[["\u003cp\u003eDTMF (Dual-tone multi-frequency signaling) can be enabled to convert end-user telephone key presses into text input for agent processing, supporting simple characters or complex regular expressions.\u003c/p\u003e\n"],["\u003cp\u003eDTMF settings offer three matching rules: matching to an intent, a custom entity, or a system entity type, with system entities being enabled by default when DTMF is globally enabled.\u003c/p\u003e\n"],["\u003cp\u003eAdditional DTMF settings include a finish digit to immediately terminate input, an interdigit timeout duration to abort processing if the pause between key presses is too long, and an endpointing timeout duration to manage variable-length sequences.\u003c/p\u003e\n"],["\u003cp\u003eDTMF can be enabled at the agent, page, or parameter level, and settings at lower levels will override higher-level settings, allowing fine-grained control over DTMF behavior within different scopes.\u003c/p\u003e\n"],["\u003cp\u003eDTMF patterns can be added to both intents and entities, allowing you to define specific sequences of numbers or regex expressions to trigger specific user inputs.\u003c/p\u003e\n"]]],[],null,["# DTMF for telephony integrations\n\nYou can enable and configure DTMF (Dual-tone multi-frequency signaling)\nfor telephony\n[integrations](/dialogflow/cx/docs/concept/integration). When enabled, end-user\ntelephone key-presses are converted to normal text and processed as end-user\ninput by the agent. This conversion can be as simple as the characters\nassociated with telephone keypresses (`12*34#`), or you can use\n[regular expressions (Regex)](https://www.regular-expressions.info/) for more\ncomplicated sequences.\n\nMatching rules\n--------------\n\nDTMF settings have three different matching rules:\n\n- Match to an [intent](/dialogflow/cx/docs/concept/intent).\n- Match to a [custom entity](/dialogflow/cx/docs/concept/entity-custom).\n- [Match to a system entity type](#system-rule)\n\nYou can associate DTMF patterns with individual\n[intents](/dialogflow/cx/docs/concept/intent) and\n[entities](/dialogflow/cx/docs/concept/entity-options) to trigger a match to\nend-user input sequences. When you enable DTMF globally, system entities are\nenabled by default.\n\nSystem entity rule\n------------------\n\n[System entity](/dialogflow/cx/docs/concept/entity-system) rules are enabled by\ndefault when you enable DTMF.\n\nSettings\n--------\n\nThis section outlines the additional settings that you can configure when you\nenable DTMF.\n\n### Finish digit\n\nThis setting controls the keypress that will immediately terminate DTMF input,\nwithout waiting for any more input. It is common to use `#` for this setting.\nThe finish digit is not included in the converted end-user input. For example,\nif the finish digit is `#`, and the input is `123#`, then the converted end-user\ninput provided to agent processing is `123`.\n\n### Interdigit timeout duration\n\nAn end-user might pause while entering a sequence of keypresses. If this pause\nduration is greater than the *interdigit timeout duration*, Dialogflow\naborts DTMF processing for the sequence.\n\nIf Dialogflow aborts DTMF processing, it provides the unconverted\nsequence captured up to that point to the agent as end-user input. This input is\nunlikely to match any intent or form parameters, so Dialogflow will\nlikely invoke a\n[no-match event](/dialogflow/cx/docs/concept/handler#event-built-in).\n\nWhen using the console, this field is in seconds.\n\n### Endpointing timeout duration\n\nAfter a match for a keypress sequence is made, Dialogflow continues to\nprocess keypresses. *Endpointing timeout duration* is the duration that\nDialogflow will wait for more input after a match is made before\nending detection. This behavior handles scenarios where the sequence is a\nvariable length, like unbounded numbers.\n\nIf the end-user pauses entry for than the time set in *endpointing timeout\nduration*, Dialogflow aborts DTMF processing and converts the\ncurrently-matched sequence as it normally would.\n\nEnable DTMF\n-----------\n\n| **Note:** To enable this feature on a [form parameter](/dialogflow/cx/docs/concept/parameter#form) you must set **`dtmf`** to **`Required`** in the parameter's settings.\n\nYou can enable DTMF at the agent, page, or parameter level. DTMF will be\napplied to everything within that scope. This section describes enabling DTMF\nfor an agent as an example. You can also enable DTMF using **Page settings**\n(pages), **Flow settings** (flows), or by selecting a parameter and viewing the\nsettings menu. In all cases, DTMF settings are found at the bottom of the page.\n\n1. Go to **Agent settings** and select the **Speech and IVR** tab.\n\n2. Go to the bottom of the page and click the **Enable DTMF** checkbox.\n\n3. Set the values for **Finish digit** , **Interdigit timeout duration** , and\n **Enpointing timeout duration**. DTMF is now enabled for everything within the\n scope of that agent. If set at a lower level, these settings now override any\n upper-level settings. Any active intents or entity types of the active slots\n within that scope might be triggered if they have DTMF patterns defined.\n\n### Add a DTMF pattern to an intent\n\n1. In the left-hand navigation menu, select the **Manage** tab and click\n **Intents**.\n\n2. Select an intent from the list that appears and go to the **DTMF pattern**\n box.\n\n3. Enter a DTMF sequence. You can use\n [regex patterns](https://www.regular-expressions.info/) in cases of more\n complex DTMF patterns.\n\n4. Click **Save** to save your changes.\n\n### Add a DTMF pattern to an entity\n\n1. In the left-hand navigation menu, select the **Manage** tab and click\n **Entity types**.\n\n2. Select an entity type from the list that appears. Go to the **DTMF Pattern**\n column in the **Entities** table.\n\n3. Set a DTMF pattern for each entity in the table. You can use\n [regex patterns](https://www.regular-expressions.info/) in cases of more\n complex DTMF patterns.\n\n4. Click **Save** to save your changes.\n\nUse DTMF in the simulator\n-------------------------\n\nYou can test your DTMF configuration in the Console simulator.\n\n1. In the Dialogflow Console, click **Test Agent** in the upper right\n hand corner of the screen.\n\n2. In the panel that pops up, click the **+** symbol next to the **Talk to\n agent** text input box. Select **DTMF**.\n\n3. Enter the DTMF pattern you want to test and the DTMF finish digit. Make\n sure that the **Send new DTMF input** box is checked, then click **Send**.\n The response to the DTMF input will appear in the simulator."]]