Damith Senanayake
10/09/2025, 10:55 PMVapi Support Bot
10/09/2025, 10:57 PMdestination property in its parameters. Here’s the correct JSON configuration to add under your tool’s parameters:
json
"parameters": {
"type": "object",
"properties": {
"destination": {
"type": "string",
"enum": ["+1234567890"], // Replace with your external number in E.164 format
"description": "The destination to transfer the call to."
}
},
"required": ["destination"]
}
Update your tool with this, then retest the transfer.
For more details, see the [Vapi call forwarding documentation](https://docs.vapi.ai/call-forwarding).
Sources:
- [Vapi documentation: call forwarding](https://docs.vapi.ai/call-forwarding)
- [Vapi SIP Trunking Telnyx external number call forwarding troubleshooting](https://discord.com/channels/1211482211119796234/1343963959421829172)Vercel
10/10/2025, 8:44 AMChiranjeet Mishra
10/10/2025, 11:36 PM"phone-call-control" from serverMessages.
- Set phoneCallProviderBypassEnabled to false unless using custom logic.
2. **Transfer Scenarios**:
- Ensure the transfer scenario is supported (e.g., Phone to Phone is ✅ Yes, Web to Phone is ❌ No).
3. **Verify Call Logs**:
- Use the Vapi API to check for "assistant-forwarded-call" as the endedReason.
- Cross-check logs from your telephony provider for transfer-specific errors.
4. **SIP and Provider Issues**:
- For SIP call setups, examine Wireshark traces for REFER packets and SIP responses.
For more on troubleshooting, you might refer to the [debug call forwarding drops](https://docs.vapi.ai/phone-calling/transfer-calls/debug-forwarding-drops).prum8439
10/12/2025, 1:41 PMNir Simionovich (CEO@Cloudonix)
10/13/2025, 10:01 PMChiranjeet Mishra
10/14/2025, 6:45 PMendedReason. If it shows "assistant-forwarded-call", Vapi transferred correctly and the issue lies with the telephony provider.
python
from vapi import Vapi
client = Vapi(token=os.getenv("VAPI_API_KEY"))
call = client.calls.get("ca123456xxxxx")
print(f"End reason: {call.ended_reason}")
2. **Check assistant configuration**:
Ensure your assistant's serverMessages configuration does not include "phone-call-control", as this can override Vapi's call management.
3. **Telephony provider logs**:
If the transfer is initiated properly by Vapi, check your telephony provider's dashboard logs (Twilio, Vonage, Telnyx) for errors during the transfer.
4. **SIP Analysis**:
For SIP-based calls, use Wireshark to inspect SIP packets. Look for REFER packets to confirm Vapi issued the transfer and check for provider acceptance or rejection cases.
5. **Common solutions**:
- If calls drop after successful forwarding: Verify the destination number (including format and availability).
- If forwarding wasn't initiated: Correct assistant settings as mentioned above.
For detailed troubleshooting guidance, refer to [this document](https://docs.vapi.ai/phone-calling/transfer-calls/debug-forwarding-drops).
Make sure to test systematically across varied scenarios and ensure your configuration follows best practices outlined in the documentation.