전화 통합을 위해 DTMF(Dual-tone multi-frequency signalin)를 사용 설정하고 구성할 수 있습니다. 사용 설정하면 최종 사용자 전화 키 누르기는 일반 텍스트로 변환되고 에이전트가 최종 사용자 입력으로 처리합니다. 이 변환은 전화 키 누르기(12*34#)와 연결된 문자만큼 간단할 수도 있고 보다 복잡한 시퀀스의 경우 정규 표현식(정규식)을 사용할 수도 있습니다.
이 설정은 추가 입력을 기다릴 필요 없이 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 사용
Console 시뮬레이터에서 DTMF 구성을 테스트할 수 있습니다.
Dialogflow 콘솔에서 화면 오른쪽 상단에 있는 에이전트 테스트를 클릭합니다.
팝업 패널에서 에이전트에게 말하기 텍스트 입력 상자 옆에 있는 + 기호를 클릭합니다. DTMF를 선택합니다.
테스트하려는 DTMF 패턴과 DTMF 마무리 자릿수를 입력합니다. 새 DTMF 입력 전송 체크박스가 선택되어 있는지 확인한 다음 전송을 클릭합니다.
DTMF 입력에 대한 응답이 시뮬레이터에 표시됩니다.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["이해하기 어려움","hardToUnderstand","thumb-down"],["잘못된 정보 또는 샘플 코드","incorrectInformationOrSampleCode","thumb-down"],["필요한 정보/샘플이 없음","missingTheInformationSamplesINeed","thumb-down"],["번역 문제","translationIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-09-04(UTC)"],[[["\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."]]
