ratty-blush•23h ago

Is there any way to play some holdtime music while vapi agent is waiting for a tool to return data?

Is there any way to play some hold time music so that the customer who is waiting doesnt disconnect since there would be silence while the agent is waiting for the data.

1 Reply

Vapi Support Bot•23h ago

Vapi supports playing hold music during call transfers by specifying a holdAudioUrl in the TransferPlan (using the warm-transfer-experimental mode). While this is designed for transfers, it demonstrates how hold music can be configured. Example snippet for a transfer with hold music:

{
  "type": "transfer",
  "destination": {
    "transferPlan": {
      "mode": "warm-transfer-experimental",
      "holdAudioUrl": "https://your-hold-music-url.com/hold.mp3"
    }
  }
}

{
  "type": "transfer",
  "destination": {
    "transferPlan": {
      "mode": "warm-transfer-experimental",
      "holdAudioUrl": "https://your-hold-music-url.com/hold.mp3"
    }
  }
}

For playing hold music specifically while waiting for a tool to return data (outside of transfers), there is no direct method documented yet.
See the changelog for details. Source: - Changelog May 6, 2025

⤵️ Mention @Vapi Support Bot for follow-ups 🐥

Is there any way to play some holdtime music while vapi agent is waiting for a tool to return data?

Did you find this page helpful?