> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.vapi.ai/tools/dtmf/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.vapi.ai/_mcp/server.

# DTMF tool

> Use the Vapi DTMF tool to let an assistant send keypad tones during a phone call to navigate phone menus, enter IDs, or accept forwarded calls.

The DTMF tool lets your assistant press keys on the phone keypad during a call. Your assistant listens to the other side, decides which keys to press, and Vapi sends the matching dual-tone multi-frequency (DTMF) tones.

The DTMF tool only sends tones. To collect keys your caller presses, use [keypad input](/documentation/assistants/conversation-behavior/keypad-input-settings). To compare all the ways to send and receive tones, see [Keypad tones (DTMF)](/calls/dtmf).

## When to use the DTMF tool

Use the DTMF tool when your assistant must react to what it hears before pressing keys. Common examples:

* **Navigate a phone menu.** Your assistant calls a business, hears "Press 1 for billing," and presses 1.
* **Enter an ID or code.** Your assistant enters a member ID, an account number, or a conference ID when a phone system asks for it.
* **Accept a forwarded or screened call.** Some forwarding and call-screening services ask the answering party to press a key before they connect the call.

Use a different method when:

* **You always dial the same extension.** Set the extension on the [transfer destination](/tools/transfer-call) or the [outbound call](/calls/outbound-calling) instead. See [Choose how to send tones](/calls/dtmf#choose-how-to-send-tones).
* **You need to pass information to a person.** A person who answers hears only beeps. Use [SIP headers](/tools/transfer-call#introductions-and-headers) on Vapi numbers, BYO SIP trunks, and Telnyx, or a data lookup on other providers, instead.

## Requirements

The DTMF tool works on phone calls on Twilio, Telnyx, Vonage, Vapi numbers, and BYO SIP trunks. It doesn't work on web calls or WebSocket calls.

What you can send depends on the provider. For example, pause characters work on Twilio and Telnyx but not on Vapi numbers. See [Where keypad tones work](/calls/dtmf#where-keypad-tones-work).

## How the tool works during a call

1. **Your assistant calls the tool.** It passes the keys to press as a single string, such as `1` or `1234#`.
2. **Vapi sends the tones through the call's provider.** If the provider rejects the request, Vapi plays the tones as audio on the call instead.
3. **The tool returns right away.** The result tells the assistant the tones were sent. It doesn't confirm that the other side received them.
4. **Your assistant waits.** After pressing keys, your assistant doesn't speak or press more keys until the other side says something. On a phone menu, that's usually the next prompt.

Because of step 4, your assistant presses one set of keys per turn. Send everything a prompt asks for in one tool call, and expect the next tool call after the phone system's next prompt.

## Next steps

#### [Configure the DTMF tool](/tools/dtmf/configure)

Create the tool, write key strings, prompt the assistant, keep it quiet while it presses keys, and verify the tones were sent.

#### [IVR navigation](/ivr-navigation)

Time your assistant's responses and key presses for automated phone menus.

> Let an assistant press keys on the phone keypad during a call

## Docs

- [Configure the DTMF tool](https://docs.vapi.ai/tools/dtmf/configure.md): Configure the Vapi DTMF tool in the dashboard or API, with key strings by provider, prompt rules, tool messages, SIP INFO, and tone checks.