alisher1860
04/07/2025, 2:58 AMVapi Support Bot
04/07/2025, 3:00 AMdtmf_tool
.
### Description Section
For the description section, you should provide context about the tool's purpose. Based on the information I found, you could use something like:
Use this function to dial digits on a keypad when navigating voice menus or responding to automated prompts. The assistant can enter specific digits as requested by the voice system.
You might also want to add this warning to prevent the model from modifying user input:
[Warning]
Do not modify or attempt to correct user input parameters or user input. Pass them directly into the function or tool as given.
According to [Discord conversations](https://discord.com/channels/1211482211119796234/1211483291191083018/threads/1343641783367766088), adding context to the tool description helps the model understand how to use it properly.
### Messages Section
For the messages section, you should configure the following message types:
- `request-start`: Message played when the DTMF action begins
- `request-complete`: Message played when the DTMF action completes
- `request-failed`: Message played if the DTMF action fails
- `request-response-delayed`: Message played if there's a delay
According to [Discord information](https://discord.com/channels/1211482211119796234/1211483291191083018/threads/1341585041624666122), if no start message is provided, Vapi defaults to using random filler messages like "Hold on a sec", "One moment", etc.Vapi Support Bot
04/07/2025, 3:00 AMcurl --location --request PATCH 'https://api.vapi.ai/tool/toolId' \
--header 'Authorization: Bearer ' \
--header 'Content-Type: application/json' \
--data '{
"messages": [
{
"type": "request-complete",
"content": "I've entered the digits."
},
{
"type": "request-failed",
"content": "I was unable to enter the digits."
},
{
"type": "request-response-delayed",
"content": "Still working on entering the digits."
},
{
"type": "request-start",
"content": "I'll dial those digits for you now."
}
]
}'
### Async Option
I noticed in your screenshot that the "Async" option is enabled. According to [Discord information](https://discord.com/channels/1211482211119796234/1211483291191083018/threads/1334866220624908341), this means "Tool executes asynchronously."
When set to true, the tool will trigger functions without waiting for their responses. If you want to use the "call response" feature, you should set this to false according to [Discord information](https://discord.com/channels/1211482211119796234/1211483291191083018/threads/1340737584309211136).
### System Message Configuration
Make sure your assistant's system message instructs it to use the DTMF tool when encountering voice menus. For example:
You are an assistant that makes outbound calls. When you encounter a voice menu or automated system that asks you to press a specific digit, use the dtmf function to enter the digits.
Is there anything else you'd like to know about configuring your DTMF tool?
Sources:
- [Discord conversation about tool descriptions](https://discord.com/channels/1211482211119796234/1211483291191083018/threads/1343641783367766088)
- [Discord conversation about setting messages](https://discord.com/channels/1211482211119796234/1211483291191083018/threads/1341585041624666122)Vapi Support Bot
04/07/2025, 3:00 AMalisher1860
04/07/2025, 3:02 AMKings_big💫
04/07/2025, 3:08 AMalisher1860
04/07/2025, 3:14 AMalisher1860
04/07/2025, 6:05 AMVapi Support Bot
04/07/2025, 7:03 AMKings_big💫
04/07/2025, 7:07 AMKings Big
04/07/2025, 7:48 AMalisher1860
04/07/2025, 7:53 AMSahil
04/07/2025, 12:31 PMalisher1860
04/07/2025, 12:32 PMalisher1860
04/07/2025, 12:33 PMSahil
04/07/2025, 12:44 PMalisher1860
04/07/2025, 12:47 PMSahil
04/07/2025, 2:32 PMSahil
04/07/2025, 2:32 PMalisher1860
04/07/2025, 2:43 PMSahil
04/07/2025, 2:48 PMSahil
04/07/2025, 2:49 PMSahil
04/07/2025, 2:49 PMalisher1860
04/07/2025, 2:52 PMalisher1860
04/09/2025, 5:17 AMKings_big💫
04/09/2025, 5:18 AMSahil
04/09/2025, 8:37 AMalisher1860
04/09/2025, 8:39 AMSahil
04/09/2025, 8:40 AMSahil
04/09/2025, 8:49 AMalisher1860
04/09/2025, 8:50 AMKings Big
04/14/2025, 1:37 AM