Skip to main content
The End Call tool enables your AI agent to terminate calls programmatically when conversations reach a natural conclusion, specific conditions are met, or when instructed by the caller.

​
How It Works

The End Call tool provides a clean way to terminate conversations:
  1. Agent Decision: Your AI agent determines the call should end based on conversation context
  2. Optional Message: Agent can provide a closing message before ending the call
  3. Clean Termination: Call is terminated gracefully through the telephony provider
  4. Call Disposition: Call disposition is updated in the system

​
Configuration

​
Basic Settings

  • End Message: Optional closing message played before termination
  • Reason: Optional reason code for call termination tracking
The closing message is stored in definition.messages as one entry with event: "start". Use type: "text" with text, or type: "audio" with a numeric recording_id. An empty array disables it. End Call supports one message and waits for its playback before hanging up.

​
Agent Usage

Your AI agent can end calls during conversations:
The reason argument is available when reason tracking is enabled. Set the closing message in the tool configuration. Common scenarios:
  • Conversation has reached natural conclusion
  • User explicitly requests to end the call
  • Agent has completed all requested tasks
  • Call timeout or error conditions