End call

Let your agent automatically hang up on the user.

The End Call tool is added to agents created in the ElevenLabs dashboard by default. For agents created via API or SDK, if you would like to enable the End Call tool, you must add it manually as a system tool in your agent configuration. See API Implementation below for details.

End call

Overview

The End Call tool allows your conversational agent to terminate a call with the user. This is a system tool that provides flexibility in how and when calls are ended.

Functionality

  • Default behavior: The tool can operate without any user-defined prompts, ending the call when the conversation naturally concludes.
  • Custom prompts: Users can specify conditions under which the call should end. For example:
    • End the call if the user says “goodbye.”
    • Conclude the call when a specific task is completed.

API Implementation

When creating an agent via API, you can add the End Call tool to your agent configuration. It should be defined as a system tool:

1from elevenlabs import (
2    ConversationalConfig,
3    ElevenLabs,
4    AgentConfig,
5    PromptAgent,
6    PromptAgentToolsItem_System
7)
8
9# Initialize the client
10client = ElevenLabs(api_key="YOUR_API_KEY")
11
12# Create the end call tool
13end_call_tool = PromptAgentToolsItem_System(
14    name="end_call",
15    description=""  # Optional: Customize when the tool should be triggered
16)
17
18# Create the agent configuration
19conversation_config = ConversationalConfig(
20    agent=AgentConfig(
21        prompt=PromptAgent(
22            tools=[end_call_tool]
23        )
24    )
25)
26
27# Create the agent
28response = client.conversational_ai.create_agent(
29    conversation_config=conversation_config
30)
Leave the description blank to use the default end call prompt.

Example prompts

Example 1: Basic End Call

End the call when the user says goodbye, thank you, or indicates they have no more questions.

Example 2: End Call with Custom Prompt

End the call when the user says goodbye, thank you, or indicates they have no more questions. You can only end the call after all their questions have been answered. Please end the call only after confirming that the user doesn't need any additional assistance.
Built with