Documentation

End Call

Allow your AI agent to terminate calls when conversations reach a natural conclusion or specific conditions are met.

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

Agent Usage#

Your AI agent can end calls during conversations:

text
end_call(message="Thank you for calling. Have a great day!", reason="conversation_complete")

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

When to use this tool#

Use the End Call tool when the agent should be able to terminate a live conversation based on runtime context, such as task completion, caller request, repeated no-match behavior, or another workflow rule.

Configuration guidance#

  • Give the agent clear instructions for when ending the call is allowed.
  • Use an optional closing message when the caller should hear a final confirmation before disconnect.
  • Avoid ending the call immediately after ambiguous phrases unless the caller clearly wants to stop.

Node versus tool#

The End Call node is a designed final stage in the workflow. The End Call tool is an action the agent can invoke during a conversation when the configured conditions are met.