Skip to content

Commit 345227b

Browse files
sahilsuman933sahil
andauthored
Add guide for entering multiple keypad entries at once (#751)
Co-authored-by: sahil <[email protected]>
1 parent 6d16f91 commit 345227b

File tree

1 file changed

+36
-0
lines changed

1 file changed

+36
-0
lines changed

fern/ivr-navigation.mdx

Lines changed: 36 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -95,3 +95,39 @@ DTMF sending varies across telephony providers due to internal implementations.
9595
- **Try and compare**: Twilio, Telnyx, Vonage, Vapi Numbers, and BYOK SIP
9696
- **Evaluate**: digit recognition accuracy, latency between digits, and success rate across menu depths.
9797

98+
### 5. Enter multiple keypad entries at once
99+
100+
Some IVRs ask for several digits or letters in a single prompt (for example, by‑name directories that require the first three letters of a last name). In these cases, send all required keys in a single `dtmf` call, using pause characters between keys so the IVR reliably registers them.
101+
102+
- **How**: Use `keys` with a combined sequence, inserting `w` (0.5s pause) or `W` (1s pause) between entries.
103+
- **Why**: Multiple separate `dtmf` calls can arrive too slowly or be partially ignored; a single combined sequence is more consistent.
104+
105+
```json title="Single dtmf with multiple keys"
106+
{
107+
"role": "tool_calls",
108+
"time": 1760710106938,
109+
"message": "",
110+
"toolCalls": [
111+
{
112+
"id": "call_CTgHfSj4lNZaqVjByk2eJooc",
113+
"type": "function",
114+
"function": {
115+
"name": "dtmf",
116+
"arguments": "{\"keys\": \"w2w1w2\"}"
117+
}
118+
}
119+
],
120+
"secondsFromStart": 25.16
121+
}
122+
```
123+
124+
```txt title="By‑name directory example"
125+
# If the IVR says: "Enter the first 3 letters of the last name"
126+
# Map letters to digits using the IVR's on‑screen or spoken mapping (e.g., S=7, M=6, I=4)
127+
dtmf(keys=w7w6w4)
128+
```
129+
130+
<Info>
131+
When sending multiple keys at once, keep brief pauses between keys (`w`/`W`) to match the IVR's capture speed. See provider‑specific pause characters above.
132+
</Info>
133+

0 commit comments

Comments
 (0)