> ## Documentation Index
> Fetch the complete documentation index at: https://agent-docs.magicwebs.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Escalations

> Handle conversations your agents hand to a person, and set rules for who gets them.

An agent **escalates** a conversation when it needs a person: an upset customer, a complaint, a request to speak to a manager, or anything its escalation policy says to pass on. Escalated conversations wait in **Escalations** until someone sets them back to open or resolves them.

Open them from **Escalations** in the sidebar. The red number shows how many are waiting.

![Escalations: Pooja asked to speak to a manager and the front desk passed her on](https://mintcdn.com/magicwebs/lXS3DuVdQz1WpiFT/images/console/escalations.png?fit=max\&auto=format\&n=lXS3DuVdQz1WpiFT\&q=85\&s=ef62457f61cc0ebe9935d3d270deab7d)

## Handle an escalation

1. Open the conversation and read what happened.
2. Reply. Your reply [takes over](https://agent-docs.magicwebs.ai/inbox/conversations.md#take-over-a-conversation) the thread and pauses the agent.
3. When it's sorted, set the status to **Resolved**, or back to **Open** to let the agent carry on.

> [!TIP]
>
> Escalations also reach you away from your desk: as push notifications in the [mobile app](https://agent-docs.magicwebs.ai/app/home.md), and as WhatsApp or email [alerts](https://agent-docs.magicwebs.ai/automation/alerts.md) if you set one up for the *Escalation* event.

## Handover rules

Handover rules decide **who** gets an escalated conversation. Without rules, escalations stay unassigned until someone picks them up.

Open them from **Team → Handover rules**. The first rule that matches wins.

| Setting | What it does |
| - | - |
| **When this agent escalates** | Any agent, or one specific agent |
| **To the department** | Any, Sales, Support, Accounts or Other |
| **Assign to** | One or more people. With several, they take turns. Anyone set to *Away* is skipped |
| **Pause the agent** | The agent stops replying so the person can take over |
| **Hand back to the agent after** | From 15 minutes to 24 hours |
| **Rule is on** | Switch a rule off without deleting it |

Use **Move up** and **Move down** to change the order.

## The escalations desk for team members

Team members can work from a focused view at `/desk`. It shows only escalations, with **All**, **Unread** and **Assigned to me**. Replies are signed with the member's own name, and **Resolve** hands the conversation back to the agent. **Open the dashboard** goes to the full console.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.