# Helpdesk

> Hand a conversation to a real person when the agent shouldn't handle it alone, and track it as a ticket until it's solved.

The Helpdesk is where your team steps in when a customer needs a person. The agent opens a ticket, a teammate picks it up, and they reply in the same chat the customer started, on the same channel.

**Where to find it:** open your agent and select **Helpdesk** in the sidebar. The sidebar switches to the Helpdesk menu: your ticket lists at the top, and settings under **Manage**.

![A Helpdesk ticket about a double charge](https://hourzero.dev/marketing/app/helpdesk-light.webp "Ticket #1042: the whole chat on the left with Maya's reply, and who owns the ticket on the right.")

## When to use it

Your agent handles most questions on its own. The Helpdesk is for the moments it shouldn't:

- **Money:** refunds, double charges, and billing mistakes.
- **Exceptions:** a return the policy doesn't cover, or an order that needs a manual change.
- **People who ask for a person:** some customers want a human, and that's fine.
- **Upset customers:** a calm human reply often does more than another automated answer.

You decide when the agent hands over. You describe those moments in the [Human escalation](https://hourzero.dev/docs/ai-agent-management/actions/human-escalation) action.

## How it works

1. **Customer asks**: A customer needs something the agent shouldn't handle alone.
2. **Agent escalates**: The agent collects the details and opens a ticket.
3. **Ticket opens**: The ticket lands in your inbox, and the AI stops replying in that chat.
4. **Teammate replies**: A teammate answers in the same chat, under their own name.
5. **Resolved**: You close the ticket, and the AI takes the conversation back.

Here's the same journey for Acme:

1. Jordan writes on Acme's website: "I was charged twice for order 48213."
2. The agent sees this is a billing problem and offers a short **Talk to a person** form.
3. Jordan fills it in. A ticket opens in the Helpdesk with the full chat attached.
4. Hourzero gives the ticket to someone on the team, or it waits for someone to pick it up.
5. Maya from billing reads the chat, refunds the charge, and replies. Jordan sees her answer in the same chat window.
6. Maya sets the ticket to **Closed**. If Jordan writes again, the agent answers as usual.

![The agent offering a Talk to a person form](https://hourzero.dev/marketing/app/widget-escalation-light.webp "The customer's view: the agent offers a short form so a teammate can help.")
![Maya's reply in the customer's chat](https://hourzero.dev/marketing/app/widget-takeover-light.webp "Later, Maya's reply from billing appears in the same chat, under her name.")

Replies reach customers where they started. On your website, they appear in the chat window. On messaging channels such as WhatsApp or Slack, they're sent through that app.

## Set up the Helpdesk

1. Open your agent and select **Helpdesk** in the sidebar.
2. While the Helpdesk is off, the inbox shows **Helpdesk is off**. Select **Turn on Helpdesk**. The first time, Hourzero also creates the standard ticket statuses and a team called **General**. You can turn it off and on again later with **Enable Helpdesk** under **Manage → General**.
3. Go back to your agent and add a **Human escalation** action under **Build → Actions**. Describe when the agent should hand over. See [Human escalation](https://hourzero.dev/docs/ai-agent-management/actions/human-escalation).
4. Optional: add teams and working hours so tickets go to the right people. See [Teams and assignment](https://hourzero.dev/docs/ai-agent-management/helpdesk/teams) and [Schedules](https://hourzero.dev/docs/ai-agent-management/helpdesk/schedules).

To leave the Helpdesk, select **Back to agent** at the top of the sidebar.

> [!IMPORTANT] The agent can only hand over while Helpdesk is on
> If **Enable Helpdesk** is off, the agent can't use the Human escalation action at all, and **Create ticket** is hidden in Conversations. Your existing tickets stay where they are, and you can still create and work on tickets in the inbox.
>
> Turning the Helpdesk on isn't enough by itself: the agent also needs a Human escalation action that's turned on in its published channels. Until then, the Helpdesk pages and **Manage → General** show **The agent can't hand chats to your team** (no action yet) or **Human escalation isn't live** (no published channel has it on), with a link to fix it.

> [!NOTE]
> Only workspace owners and admins can set up the Helpdesk and change its settings, statuses, teams, and schedules. Everyone in the workspace can work on tickets.

## Reply or note

Every ticket has two ways to write: **Reply** and **Note**. They look alike, but they go to very different people.

| | Reply | Note |
| --- | --- | --- |
| Who sees it | The customer, in their chat | Only your workspace team |
| Where it appears | In the conversation, under your Helpdesk display name | Under **Internal notes** in the ticket |
| AI must be paused | Yes | No |
| Changes the status | Yes, to **On customer** | No |

Use a **reply** to talk to the customer:

```text
Hi Jordan, I'm Maya from billing. I've refunded the duplicate charge, and you'll see it on your statement within 3–5 business days.
```

Use a **note** to talk to your team. Select **Mention** to bring in a teammate. They get a notification and the ticket shows up in their **Mentions** list.

```text
@Alex Rivera Can you confirm the second charge on order 48213 is a duplicate before I refund it?
```

> [!WARNING] Check the tab before you send
> **Reply** goes to the customer. **Note** stays inside your team. Look at which one is selected before you write anything private.

## What the AI does while a person helps

When the agent opens a ticket, it pauses itself in that chat. That way the customer doesn't get an automated answer while your teammate is working on it. This is the **Pause AI after escalation** setting in the Human escalation action, and it's on by default.

- The ticket's top-right button shows **Resume AI** while the AI is paused, and **Pause AI** while it's running.
- You can only reply as a person while the AI is paused. If it isn't, the ticket offers a **Pause AI** button first.
- When you set the ticket to **Closed** or **Cancelled**, the AI picks the chat back up on its own. You can also select **Resume AI** at any time.

You don't need a ticket to step in. You can pause the AI and reply in any chat from **Activity → Conversations**. See [Conversations](https://hourzero.dev/docs/ai-agent-management/conversations).

> [!TIP]
> Make the agent's handover message honest. "Thanks, I've passed this to our billing team. They usually reply within one business day." works well. Only promise response times your team can actually meet.

## How tickets move along

Hourzero updates the status as the conversation goes:

- A new ticket starts as **New**.
- When the customer writes, it moves to **On you**.
- When a teammate replies, it moves to **On customer**.
- You set **On hold**, **Closed**, and **Cancelled** yourself.

Read more in [Statuses and tags](https://hourzero.dev/docs/ai-agent-management/helpdesk/statuses-and-tags).

## What the customer sees

In your website chat (Chat Bubble, Center Stage, or Chat Iframe), the customer follows their ticket in the conversation itself. A short line appears between the messages when:

- the ticket is created, for example **Ticket created · Received**,
- its status changes, for example **Ticket updated · Waiting for your reply**. This includes the automatic moves to **On you** when the customer writes and to **On customer** when a teammate replies, which appear right after that message,
- the ticket is set to a **Closed** status, shown as **Ticket resolved · Resolved**,
- someone becomes the ticket's owner, shown as **Ticket assigned** with their name. That covers assigning by hand, a team's automatic assignment, and a teammate who replies to a ticket nobody owns.

In the customer's chat, status lines use the status's **customer-facing label**, so the customer never sees your internal wording. In Hourzero, the same lines show the status your team sees, such as **On you** or **On customer**, matching the ticket's **Details** panel. Assignment lines show the teammate's name, the same name the customer sees on their replies.

Each teammate chooses that name under **Account settings → Profile → Helpdesk display name**, for example `Maya from Support`. Without one, customers see the teammate's account name. See [Account settings](https://hourzero.dev/docs/security/account#update-your-profile). Unassigning a ticket, and changing its priority, team, or tags, stays internal. The lines appear in the conversation in **Activity → Conversations** and in the ticket too. The agent never reads them, so they don't change its answers.

### Ticket ratings

When a ticket is resolved, the chat asks the customer to **Rate your conversation** from 😠 (terrible) to 🤩 (amazing). After picking a face, they can add a comment. They can change their rating until the ticket is reopened.

The rating and comment appear under **Rating** in the ticket's **Details** panel and on the resolution in the conversation. **Feedback**, under **Insights** in the Helpdesk sidebar, collects every rating with a summary and filters. See [Feedback](https://hourzero.dev/docs/ai-agent-management/helpdesk/feedback). Ratings also go to [webhooks](https://hourzero.dev/docs/integrations/webhooks) as the ticket's `rating`.

To stop asking for ratings, turn off **Ticket ratings** under **Manage → General**. Tickets already rated keep their rating.

> [!NOTE]
> Messaging apps like Telegram and Discord don't show ticket updates or ask for ratings yet. The updates still appear in the conversation in Hourzero.

## Common questions

### What if the customer writes again after the ticket is closed?

In your website chat, they can't. Setting the conversation's ticket to **Closed** or **Cancelled** ends that conversation: the message box is replaced by **This conversation has ended.** and a **New chat** button. The customer can still rate the conversation. If they need more help, they start a new chat.

If a teammate reopens the ticket by setting an open status, the message box comes back and the customer can continue.

In messaging apps like Telegram and Discord, the closed ticket stays closed and the agent answers new messages as usual. If the customer needs a person again, the agent can open a new ticket.

### Can I create a ticket myself?

Yes. Select **New ticket** in the inbox, or **Create ticket** at the top of a conversation in **Conversations**. A ticket linked to a conversation follows the chat and you can reply from it. One without a conversation is useful for tracking something like a phone call, but you can't reply to the customer from it. See [Inbox](https://hourzero.dev/docs/ai-agent-management/helpdesk/inbox#create-a-ticket-by-hand).

### How do teammates know they have work?

Teammates get a notification (the bell next to their name at the bottom of the sidebar) when a ticket is assigned to them, when a customer replies on their ticket, and when someone mentions them in a note.

A ticket assigned to someone else also reaches them by email, with the ticket's subject, description, and a link to open it. That covers tickets a teammate assigns and tickets the team's assignment method hands out. Nobody gets an email for a ticket they assign to themselves. Each person can turn these emails off under **Account settings → Email notifications → Helpdesk**. See [Account settings](https://hourzero.dev/docs/security/account#choose-which-emails-you-get).

### Who gets each ticket?

That depends on the team. A team can hand out tickets by hand, or let Hourzero share them out among the people who are working. See [Teams and assignment](https://hourzero.dev/docs/ai-agent-management/helpdesk/teams).

## In this section

- [Inbox](https://hourzero.dev/docs/ai-agent-management/helpdesk/inbox): Find tickets, reply to customers, leave notes, and save views.
- [Statuses and tags](https://hourzero.dev/docs/ai-agent-management/helpdesk/statuses-and-tags): Track where each ticket stands and group tickets by topic.
- [Teams and assignment](https://hourzero.dev/docs/ai-agent-management/helpdesk/teams): Choose who gets which tickets, by hand or automatically.
- [Schedules](https://hourzero.dev/docs/ai-agent-management/helpdesk/schedules): Set working hours and time off so tickets go to people who are working.
- [Feedback](https://hourzero.dev/docs/ai-agent-management/helpdesk/feedback): See how customers rated their resolved tickets and read their comments.

## Next steps

- [Human escalation](https://hourzero.dev/docs/ai-agent-management/actions/human-escalation): Tell the agent when to hand a conversation to your team.
- [Conversations](https://hourzero.dev/docs/ai-agent-management/conversations): Read every chat and step in without a ticket.
