#HeyIs there a way to specify agent_message and client_message when use transfer to phone tool? Doc
1 messages · Page 1 of 1 (latest)
Short answer: Yes, but you don’t preconfigure them in the UI or in the agent creation payload. client_message and agent_message are arguments the LLM must supply at runtime when it calls the transfer_to_number system tool.
Key points
- The transfer_to_number tool requires these arguments when invoked:
- client_message (string): what the caller hears during the handoff
- agent_message (string): the warm-transfer briefing for the human recipient
- These are not part of the tool’s static configuration; they’re passed in the function call by the model. (elevenlabs.io)
- Limitations:
- agent_message (warm transfer) is only delivered when using the native Twilio integration and the Conference transfer type; it’s not used for SIP REFER or blind transfers. (elevenlabs.io)
- The transfer_to_number tool is available for phone calls only (not the chat widget). (elevenlabs.io)
How to control the messages
- Guide the model via your agent’s system prompt and the tool’s description to populate client_message and agent_message with the exact structure/phrasing you need (e.g., what context to include for the human). The docs show the required function-call shape and parameters. (elevenlabs.io)
- You can inject runtime data into these messages using Dynamic Variables (e.g., {{user_name}}, {{customer_id}}) since dynamic variables are supported in tools’ parameters. (elevenlabs.io)
Docs
- Transfer to number (system tool), parameters and example function call including client_message and agent_message. (elevenlabs.io)
- Dynamic variables for injecting runtime values into tool parameters. (elevenlabs.io)
If you need fixed wording every time, put a clear template in the agent/system prompt and tool description so the LLM consistently fills those two fields accordingly.
Sources:
Transfer to number | ElevenLabs Documentation
Transfer to number | ElevenLabs Documentation
Transfer to number | ElevenLabs Documentation
Transfer to number | ElevenLabs Documentation
Dynamic variables | ElevenLabs Documentation
Transfer to number | ElevenLabs Documentation
Dynamic variables | ElevenLabs Documentation
Docs says for transfer to phone tool:
Implementation: Configure transfer phone numbers and conditions. Define messages for both customer and receiving human operator. Works with both Twilio and SIP trunking.
Where and how I can configure messages for both customer and receiving humna operator??? UI doesn't support that, only 'Condition' for Conference transfer type. API CreateAgent doesn't support it, 'transfer_to_number' tool has no parameter regarding client_message or agent_message...