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

# Core concepts

> The three resources you work with, and how they relate.

## Customers

A **customer** is a person you support. You create one for each of your users, and give it your own id for them (`externalId`) so you can find it again.

Cerium gives every customer its own `id`, starting with `prt_`. Use that id when you start a conversation.

## Conversations

A **conversation** is the thread between a customer and your team. It belongs to one customer and has a status:

| Status | Meaning |
| - | - |
| `open` | Being handled, or waiting for a reply. |
| `closed` | Finished. |

A conversation's id starts with `thr_`. A closed conversation reopens when the customer writes in it, or when you [reopen it](/api-reference/conversations/close-or-reopen-a-conversation.md).

## Messages

A **message** is one entry in a conversation. Every message has a `senderType`:

| `senderType` | Written by |
| - | - |
| `customer` | The customer. This is what you send through the API. |
| `agent` | A member of your support team. |
| `ai` | Your AI agent. |
| `system` | Cerium, for example a notice that the conversation moved to a team member. |

The `from` field is the simple version: `customer` for the customer's messages and `agent` for everything else.

## How they fit together

```mermaid
flowchart LR
  C[Customer] -->|has many| V[Conversations]
  V -->|has many| M[Messages]
```

1. Create the **customer** once.
2. Start a **conversation** with their first message.
3. Add **messages** as the customer writes. Read the replies from the same list.

## Conventions

> [card] Timestamps
>
> ISO 8601 in UTC, for example `2026-11-20T09:14:03.000Z`.

> [card] Ids
>
> Opaque strings. Store them as given and do not parse them.

> [card] Empty values
>
> A field with no value is `null`, not missing.

> [card] Envelope
>
> Responses carry `message`, `status`, `data` and, on lists, `meta`.
