# Understanding tickets

### What is a Ticket?

A Ticket is a single customer support session. It contains the messages exchanged between a customer and your team (or AI Agent) on one channel, from the moment the session starts to the moment it's resolved.

Tickets are the unit of work in Zaapi. Everything in the platform — assignment, labels, notes, automations, analytics — happens at the Ticket level.

A Ticket has:

* A **status**: Open, Closed, or Spam.
* An **assignee** (an agent or team), or no assignee if unassigned.
* A **conversation**.
* A set of **Ticket Fields** with custom data (see the **Ticket Fields** section).

### Contacts, Conversations & Tickets

```
Contact
 └── Conversation (one per channel — e.g. Facebook Messenger, LINE, Shopee Chat)
      └── Ticket (one per support session within a conversation)
      └── Ticket (next session, opened later)
      └── Ticket ...
```

A **Contact** represents a single customer. One customer, one Contact record — regardless of how many channels they use to reach you.

A **Conversation** is the ongoing thread between a Contact and your store on a specific channel. If the same customer messages you on both LINE and Facebook, they have one Contact but two Conversations.

A **Ticket** is a discrete support session within a Conversation. A Conversation can have many Tickets over time — each time a resolved Ticket is reopened (or a new one is created), it becomes a separate Ticket.

### How Tickets are created

A new Ticket is created automatically when:

* A customer sends a message to one of your connected channels and there is no Open Ticket for that Conversation.
* An agent **manually** opens a Ticket on a Contact.

When a Ticket is created, it starts in **Open** status and is unassigned by default (unless an assignment automation routes it).

### Ticket statuses: Open & Closed

Every Ticket sits in one of three states:

* **Open** — the Ticket is active. New customer messages are appended to this Ticket. Open Tickets show up in the default Inbox views.
* **Closed** — the Ticket has been closed by an agent or by an automation. No new messages will be appended unless the Ticket is reopened (see *The Ticket Lifecycle*).

### The difference between Tickets, Comments, and Reviews

Zaapi handles three separate types of customer interaction:

* **Tickets** are direct messages — the customer is messaging you privately on a channel like Messenger, WhatsApp, LINE, or Shopee Chat.
* **Comments** are public posts on your Facebook or Instagram page (see the **Comments** section).
* **Reviews** are public product reviews on Shopee or Lazada (see the **Reviews** section).

Each lives in its own area of Zaapi but can optionally be converted into a Ticket — for example, replying privately to a public comment opens a DM Ticket.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.zaapi.com/ticket-inbox/understanding-tickets.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.