---
lang: en
---

# Escalations

When the assistant cannot answer, it hands the conversation to your team as an escalation. This page sets where escalations go: an email to every team member and to any addresses you add, and a Slack or Discord channel if you connect one.

> Verified against the product on 2026-11-21

## Add an address for escalations

1. In **Connect › Escalations**, type the address in the field under **Email**.
2. Select **Add**, or press `Enter`.

The address appears as a chip under the field. To remove it, select the close icon on its chip.

Any member of the team can add or remove an address.

Addresses are saved in lowercase. An address that does not look like `name@example.com` is refused with “Enter an email address, like name@example.com.”

Adding an address that is already on the list changes nothing.

## Who gets each escalation

Every escalation is emailed to each member of the team, the owner first, and then to the addresses added on this page, each address once.

Removing an added address does not stop team members from being emailed.

An escalation tested in the Messenger preview emails nobody and posts no card, though it still marks the escalation as open.

If nobody has replied two hours after an escalation, the team is emailed a reminder, once. The reminder stops when a teammate replies or when the escalation is no longer with the team.

A customer who left an email address in the Messenger or the help site gets a receipt when the escalation is passed on.

Replies go to the customer by email as one digest, after a 5-minute wait.

> **Note:** Replies are emailed only to a customer who left an email address. A customer with none gets no reply email.

## Send escalations to Slack or Discord

Slack or Discord gets a panel on this page only when Cactus offers that platform.

If the platform is not connected, its panel offers to connect it, and the install returns to this page.

Once connected, choose the channel in the picker labeled **Escalation channel** for Slack, or **Discord escalation channel** for Discord.

Or select **Create #cactus-escalations** and Cactus makes the channel and sets it for escalations.

Messages a teammate writes in that channel also tell Cactus which product they are about.

## Work an escalation

### In a chat channel

Each escalation becomes one card in the channel, with a thread under it and a link back to the conversation.

Only **Reply…** on the card, or asking Cactus to reply in the thread, reaches the customer. Cactus sends the reply in the Messenger and by email.

Everything else your team says in the thread stays private, kept on the conversation as a note.

If the customer left an email address on the card, the card does not appear in the channel when that address belongs to a member of the team.

### In the Inbox

Teammates act on an escalation in [Conversations](https://cactus.heycactus.ai/p9t3xt-conversations).

- Claim an escalated conversation, so one teammate holds it. Another teammate who tries sees that it is already claimed.
- Reply, which sends the words to the customer the same way **Reply…** on the card does.
- Resolve it. If the customer left an email address, they get a closing email.
- Reopen a resolved conversation. It goes back to escalated if the conversation had been escalated, and to open if it was not.
- Escalate an open conversation to the team.

## Where an escalation stands

An escalation stands in one of five states, and the Inbox and the card show the same words.

*The five states an escalation can stand in, and what moves it from one to the next.*

Escalated · Claimed · Answered by the team · Cancelled by the customer · Resolved

- Escalated › a teammate claims it › Claimed
- Escalated › a teammate replies › Answered by the team
- Escalated › the customer cancels › Cancelled by the customer
- Claimed › a teammate replies › Answered by the team
- Claimed › the customer cancels › Cancelled by the customer
- Claimed › a teammate resolves › Resolved
- Answered by the team › a teammate resolves › Resolved
- Resolved › a teammate reopens › Escalated

```mermaid
stateDiagram-v2
state "Escalated" as Escalated
state "Claimed" as Claimed
state "Answered by the team" as Answered
state "Cancelled by the customer" as Cancelled
state "Resolved" as Resolved
[*] --> Escalated
Escalated --> Claimed: a teammate claims it
Escalated --> Answered: a teammate replies
Escalated --> Cancelled: the customer cancels
Claimed --> Answered: a teammate replies
Claimed --> Cancelled: the customer cancels
Claimed --> Resolved: a teammate resolves
Answered --> Resolved: a teammate resolves
Resolved --> Escalated: a teammate reopens
```

From the customer’s card in the Messenger, the customer can cancel while the escalation waits, but only before a teammate has replied.

A cancelled escalation shows **Cancelled by the customer**, and Cactus carries on answering.

## If an escalation goes wrong

| What you see | What it means | What to do |
| --- | --- | --- |
| “Enter an email address, like name@example.com.” | The address you typed is not a valid email address. | Type the full address and add it again. |
| “Sending email isn’t available yet.” under **Email** | Escalation emails are not available, so the page warns before you type an address. | Nothing on this page fixes it. |
| “Couldn’t read where escalations go. Try again.” | This page could not load where escalations go. | Reload the page and try again. |
| “Couldn’t save that address. Try again.” | Saving an address failed for another reason. | Try adding the address again. |
| “Couldn’t reach the team. Try again in a moment.” | A customer’s request to reach a person did not hand the conversation to the team. | Try again in a moment. |
| “Cactus couldn’t escalate this conversation. Try again.” | Escalating from the Inbox failed. | Try escalating again. |
| “_The teammate’s name_ already claimed this conversation.” | Another teammate holds the conversation. | Leave it with that teammate. |
| “Only an escalated conversation can be claimed.” | The conversation is not escalated, or it is closed. | Claim only escalated conversations. |
| “Nothing was sent. Your reply is still in the box.” | The reply did not reach the customer. | Send the reply again. |
| The escalation channel is no longer set | Slack reports the channel archived or not found, so Cactus stops using it. | Choose a channel again in the picker on this page. |
