Warm Transfer Acceptance is now available for Telnyx Voice AI Assistants. Recipients of a transfer can talk to the assistant and verbally accept or decline the call before the caller is bridged, giving teams control over which calls get through.
private
mode, or preserve it in the record with shared
mode.complete_transfer
tool is added to the assistant automatically when acceptance is enabled. No extra configuration needed.A standard warm transfer plays a recorded handoff message and bridges the call whether the destination is ready or not. That means dropped calls, transfers to unavailable agents, and frustrated callers left in dead air after a handoff. Warm Transfer Acceptance adds a live consult step so the destination can screen the call, hear the context, and decide whether to take it. The caller stays with the assistant hearing ringback and never hears the exchange. This is call control that normally requires a separate contact center vendor, built into the same platform that runs the assistant.
warm_transfer_instructions
to your handoff message.warm_transfer_acceptance
on the transfer tool by setting enabled
to true.end_user_target_context_mode
to shared
to keep the consult in the conversation record.
curl -L 'https://api.telnyx.com/v2/ai/assistants' \n -H 'Content-Type: application/json' \n -H 'Authorization: Bearer <TOKEN>' \n --data-raw '{
"name": "Support Agent",
"instructions": "You are a support agent. Transfer calls to the support team when the caller asks for a human.",
"model": "moonshotai/Kimi-K2.5",
"tools": [
{
"type": "transfer",
"transfer": {
"targets": [
{"name": "Support Team", "to": "+15551234567"}
],
"from": "+15553456789",
"warm_transfer_instructions": "Briefly summarize why the caller is being transferred and what they already tried. Then ask whether they can take the call.",
"warm_transfer_acceptance": {
"enabled": true
}
}
}
]
}'
Learn more in the Warm Transfer Acceptance docs or the Telnyx Voice AI Agents page.