How can I tool call to play audio file through call?
Is there a way to play audio file through call with a tool call?
VCurrently, Vapi's tool calling system does not document a built-in way to play an arbitrary audio file through a call using a tool call—only text-to-speech ("say" message) is supported out of the box.
To help further:
Are you looking to play a specific pre-recorded audio file (not TTS) during a call, and if so, do you need this to be triggered dynamically via a tool call or would a static solution work for your use case?
Sources:
To help further:
Are you looking to play a specific pre-recorded audio file (not TTS) during a call, and if so, do you need this to be triggered dynamically via a tool call or would a static solution work for your use case?
Sources:
⤵️ Mention @Vapi Support Bot for follow-ups 🐥
VYou can return the message as audio file link which will do the trick.
WSo I put in the say response or response parameter? How should the response look?
VVapi's "say" tool call only supports text-to-speech, not direct audio file playback.
To use the "say" action, your response should look like this:
There is no documented way to play an audio file by providing a file link in the "say" or "response" parameter—only TTS is supported officially.
Sources:
To use the "say" action, your response should look like this:
There is no documented way to play an audio file by providing a file link in the "say" or "response" parameter—only TTS is supported officially.
Sources:
WSo what type of response is needed to return the audio then?
VVapi does not support returning or playing an audio file through a tool call.
The only supported way to play audio is via text-to-speech using the
Providing an audio file link or binary in the response will not play the audio—only TTS is supported for tool calls at this time.
See Vapi Call Features Documentation
Sources:
The only supported way to play audio is via text-to-speech using the
"say" action, like this:Providing an audio file link or binary in the response will not play the audio—only TTS is supported for tool calls at this time.
See Vapi Call Features Documentation
Sources:
WBut your rep just said it could be done
VTo clarify: According to official Vapi documentation, you cannot play an audio file through a tool call—only text-to-speech via the
Could you clarify if you are looking for an official solution, or are you interested in potential (but unsupported) workarounds?
Sources:
"say" action is supported. Providing an audio file link in the response will not play the audio.Could you clarify if you are looking for an official solution, or are you interested in potential (but unsupported) workarounds?
Sources:
WWhat about server messages?
WTool calls see messages to be exact
WServer messages
VAccording to official Vapi documentation, you cannot play an audio file through a tool call or server message—only text-to-speech via the
Are you looking for an official solution only, or are you interested in exploring potential (but unsupported) workarounds?
Sources:
"say" action is supported. Are you looking for an official solution only, or are you interested in exploring potential (but unsupported) workarounds?
Sources:
VAccording to Vapi's official documentation, only text-to-speech (TTS) playback is supported during calls—even when using server messages or tool calls. There is no documented way to play an audio file by returning a file link or binary in any response; these will not result in audio playback.
If you are specifically looking for an officially supported solution, TTS is the only option.
To clarify: Are you interested in exploring potential (but unsupported) workarounds, or do you only want officially documented solutions?
Sources:
If you are specifically looking for an officially supported solution, TTS is the only option.
To clarify: Are you interested in exploring potential (but unsupported) workarounds, or do you only want officially documented solutions?
Sources:
VTo confirm: Vapi only supports text-to-speech playback via the
Are you looking strictly for an official, documented solution, or are you interested in exploring potential (but unsupported) workarounds?
Sources:
"say" action, and providing an audio file link will not play the audio during a call. Server messages are not documented as a way to inject audio playback either.Are you looking strictly for an official, documented solution, or are you interested in exploring potential (but unsupported) workarounds?
Sources:
VIt should be a wav file, you just need to send back the request-start message and it will do the trick.
{
"results": [
{
"toolCallId": "{{ $('Webhook').item.json.body.message.toolCalls[0].id }}",
"message": {
"type": "request-complete",
"content": {{ $json.response }}
},
"result": {{ $json.response }}
}
]
}
content part will be your audio file link in wav format.
{
"results": [
{
"toolCallId": "{{ $('Webhook').item.json.body.message.toolCalls[0].id }}",
"message": {
"type": "request-complete",
"content": {{ $json.response }}
},
"result": {{ $json.response }}
}
]
}
content part will be your audio file link in wav format.
