End Call

The End Call tool allows your AI agent to terminate an active call programmatically — cleanly, professionally, and at exactly the right moment. Instead of leaving the call open indefinitely or relying on the customer to hang up, your agent can close the conversation gracefully once its job is done.

---

Steps to Add

1. Open the Agent Builder
2. Click + Add Tool
3. Select End Call
4. Fill in the Instruction field (described below)
5. Click Add to Agent

---

Configuration Field

Instruction (When this tool should be invoked)

This is the only configuration field for End Call — and it is the most important one.

The Instruction tells the AI agent exactly when it should hang up and terminate the call. The agent reads this instruction alongside the conversation context and decides at each turn whether the end condition has been met.

Enter instruction on when should AI invoke this tool

Write this as a clear, specific trigger condition — not a vague directive. The agent follows the instruction literally, so precision matters.

---

Why the Instruction Field Matters

Without a well-written instruction, the agent either:

• Ends calls too early — cutting off a customer mid-sentence because a vague condition matched prematurely
• Leaves calls open too long — the conversation is finished but the agent keeps listening, wasting time and creating an awkward silence

A good instruction defines the exact state of the conversation at which hanging up is the right action.

---

Instruction Writing Guide

1. End after task completion

Use this when the agent’s primary goal has been accomplished and there is nothing left to do.

Call voice_end_call after the customer confirms their policy renewal and you have
provided the confirmation number.

End the call once the appointment has been successfully booked and the customer
has acknowledged the date and time.

Hang up after the customer confirms they have received the OTP and no further
assistance is needed.

---

2. End when the customer declines or is not interested

Use this for outbound calling scenarios — insurance renewals, campaigns, sales calls — where customers may not want to continue.

End the call if the customer says they are not interested, asks to be removed
from the list, or says "no thanks", "not now", "don't call again", or similar.

Call voice_end_call when the customer declines the renewal offer or says they
will call back later.

This prevents the agent from continuing to pitch or ask follow-up questions after a clear rejection, which would feel pushy and damage the customer experience.

---

3. End when the customer says goodbye

The most natural trigger — the customer signals the conversation is over.

End the call when the customer says goodbye, "thank you", "that's all",
"I'm done", or any other closing phrase that signals they are finished.

Hang up when the customer thanks you and there are no remaining open questions
or pending actions.

---

4. End when the customer is frustrated or unresponsive

Continuing a conversation with an angry or silent customer makes things worse. A graceful exit is the better outcome.

End the call if the customer becomes abusive, repeatedly asks to be left alone,
or is clearly not willing to continue the conversation.

Call voice_end_call if there is no response from the customer for more than
10 seconds after asking a question twice.

---

5. End after a successful transfer

Once a transfer has been initiated, the AI has completed its role. You can optionally add a closing line before terminating.

After successfully transferring the call to a human agent, end this AI session.

Note: When using Warm Transfer, the AI drops off automatically once the bridge is established. Use voice_end_call for Cold Transfer scenarios or when the transfer fails and the AI needs to close out cleanly.

---

6. End on specific call outcomes (outbound campaigns)

For outbound calls — renewals, reminders, collections — combine end conditions into a single instruction:

End the call in any of the following situations:
- The customer confirms the renewal
- The customer declines the offer
- The customer asks to call back and you have logged the callback request
- The customer is not reachable (voicemail, no answer after greeting)
- The customer has provided all required information

---

Combining Instruction with a Farewell

The voice_end_call tool terminates the call. To make the ending feel natural, write your agent’s closing line in the main system prompt — not in the End Call instruction itself.

In your main agent prompt:

Before ending the call, always say a closing message such as:
"Thank you for your time. Have a great day!" or
"Your renewal is confirmed. We'll send a confirmation to your email. Goodbye!"

In the End Call instruction:

Call voice_end_call after delivering the closing message and the customer
acknowledges or the conversation reaches a natural stopping point.

This separation keeps the agent prompt responsible for what to say and the End Call tool responsible for when to hang up.

---

Real-World Examples by Use Case

Insurance Renewal Bot

Call voice_end_call in the following situations:
- The customer confirms the renewal and you have shared the confirmation details
- The customer declines the renewal offer
- The customer says they will call back or need more time
- The customer asks to be removed from the call list
- The customer says goodbye or thanks you and ends the conversation

Appointment Booking Agent

End the call after:
- The appointment has been confirmed and the customer has acknowledged the slot
- The customer cancels and no rebooking is requested
- The customer says "that's all" or "I'm done"

Collections / Payment Reminder Agent

Call voice_end_call when:
- The customer confirms the payment has been made
- The customer requests a callback and you have recorded the preferred time
- The customer disputes the amount and has been transferred to the billing team
- The customer refuses to engage and asks to end the call

Outbound Survey Agent

End the call after the customer completes all survey questions and you have
confirmed their responses. Also end the call if the customer refuses to
participate or asks to opt out at any point.

---

Common Mistakes to Avoid

Mistake	Why It’s a Problem	Better Approach
"End the call when done"	Too vague — agent doesn’t know what “done” means	Define the specific completion state
"End after silence"	Silence can happen mid-sentence or during thinking	Specify duration: "no response for 10+ seconds after two prompts"
"End after saying goodbye"	Agent may say goodbye before tasks are completed	Add: "only after all tasks are complete and customer acknowledges"
Not adding End Call at all	Call stays open indefinitely after conversation ends	Always add voice_end_call to every agent
Multiple conflicting end conditions	Agent may end calls at wrong moments	Order conditions by priority or use clear “any of the following” framing

---

Best Practices

• Always add voice_end_call to every agent — without it, the call will not terminate automatically after the conversation ends
• Write specific, observable trigger conditions — the agent needs to match language or conversation state, not guess intent
• Separate farewell language from the end trigger — put closing messages in the main prompt, not in this instruction
• For outbound agents, list multiple end conditions — customers can end calls in many different ways
• Combine with voice_transfer_call — if a transfer is attempted and fails, voice_end_call ensures the call doesn’t stay open in a broken state
• Test end-of-call behavior in the Test Voice playground to confirm the agent terminates correctly across different conversation paths

---

Example Configuration

Field	Value
Tool	voice_end_call
Instruction	End the call after the customer confirms their renewal, declines the offer, says goodbye, or asks to be removed from the call list.

---

Troubleshooting

Issue	Fix
Call never ends automatically	Confirm voice_end_call is added to the agent and the instruction is filled in
Agent ends call too early	Make the instruction more specific — add conditions that must all be true before ending
Agent ends call mid-sentence	Loosen the trigger — the current instruction may be matching too broadly
Awkward silence before hangup	Add a farewell message in the main agent prompt before the end condition is checked
Agent keeps talking after goodbye	Add "customer says goodbye" explicitly to the end condition list

---