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:
A conversation’s id starts with
thr_. A closed conversation reopens when the customer writes in it, or when you reopen it.
Messages
A message is one entry in a conversation. Every message has asenderType:
The
from field is the simple version: customer for the customer’s messages and agent for everything else.
How they fit together
- Create the customer once.
- Start a conversation with their first message.
- Add messages as the customer writes. Read the replies from the same list.
Conventions
Timestamps
ISO 8601 in UTC, for example
2026-11-20T09:14:03.000Z.Ids
Opaque strings. Store them as given and do not parse them.
Empty values
A field with no value is
null, not missing.Envelope
Responses carry
message, status, data and, on lists, meta.