ElevenLabs Agents

Usage Instructions

Have an ElevenLabs voice agent call a phone number through Twilio or a SIP trunk, pass the call its details as dynamic variables, and get back the transcript, summary, and extracted data when the call ends. Also saves call recordings as MP3 files, reads past conversations, and lists the account phone numbers.

Tools

`elevenlabs_agents_outbound_call`

Have an ElevenLabs agent place a phone call through Twilio or a SIP trunk, and optionally wait for the transcript and extracted data.

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	ElevenLabs API key
`agentId`	string	Yes	ID of the ElevenLabs agent that handles the call
`agentPhoneNumberId`	string	Yes	ID of the ElevenLabs phone number the call is placed from
`toNumber`	string	Yes	Number to call in E.164 format (e.g. +14155551234)
`provider`	string	No	Telephony provider of the phone number: twilio (default) or sip_trunk
`dynamicVariables`	json	No	Values for the {{variables}} in the agent prompt, first message, and tools, as a JSON object
`waitForCompletion`	boolean	No	Wait for the call to end and return the transcript and analysis. Defaults to true.
`maxWaitSeconds`	number	No	Longest time to wait for the call to finish, 30 to 3600 seconds. Defaults to 900.

Output

Parameter	Type	Description
`conversationId`	string	ElevenLabs conversation ID for the call
`callSid`	string	Twilio call SID, or the SIP call ID for SIP trunk calls
`message`	string	Message ElevenLabs returned when placing the call
`completed`	boolean	Whether the call finished before the block returned
`conversation`	object	The finished conversation: transcript, summary, and extracted data

`elevenlabs_agents_get_conversation`

Get an ElevenLabs agent conversation: status, transcript, summary, and extracted data.

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	ElevenLabs API key
`conversationId`	string	Yes	ElevenLabs conversation ID

Output

This tool does not produce any outputs.

`elevenlabs_agents_get_recording`

Save the recording of an ElevenLabs agent conversation as an MP3 file.

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	ElevenLabs API key
`conversationId`	string	Yes	ElevenLabs conversation ID

Output

Parameter	Type	Description
`recording`	file	Conversation recording (MP3)
`recordingUrl`	string	URL of the saved recording

`elevenlabs_agents_list_conversations`

List ElevenLabs agent conversations, newest first, optionally for one agent.

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	ElevenLabs API key
`agentId`	string	No	Only list conversations handled by this agent
`callSuccessful`	string	No	Only list conversations with this evaluation: success, failure, or unknown
`pageSize`	number	No	Conversations per page, 1 to 100. Defaults to 30.
`cursor`	string	No	Cursor from a previous page to read the next one

Output

Parameter	Type	Description
`conversations`	array	Conversations, newest first
↳ `conversationId`	string	Conversation ID
↳ `agentId`	string	Agent ID
↳ `agentName`	string	Agent name
↳ `status`	string	Conversation status
↳ `callSuccessful`	string	success, failure, or unknown
↳ `startTimeUnixSecs`	number	Start time in Unix seconds
↳ `durationSecs`	number	Length in seconds
↳ `messageCount`	number	Number of messages
↳ `summaryTitle`	string	Short title
↳ `direction`	string	inbound or outbound
`nextCursor`	string	Cursor for the next page
`hasMore`	boolean	Whether more conversations exist

`elevenlabs_agents_list_phone_numbers`

List the phone numbers in the ElevenLabs account with their IDs and assigned agents.

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	ElevenLabs API key

Output

Parameter	Type	Description
`phoneNumbers`	array	Phone numbers in the account
↳ `phoneNumberId`	string	ID to use as the agent phone number
↳ `phoneNumber`	string	Number in E.164 format
↳ `label`	string	Label set in ElevenLabs
↳ `provider`	string	twilio or sip_trunk
↳ `agentId`	string	Agent assigned to inbound calls
↳ `agentName`	string	Name of the assigned agent

ElevenLabs Agents

On this page