# Messages

The `messages` array in an Exchange contains the conversation transcript between the user and the Assistant.

## Message structure

Each message has these fields:

| Field     | Type     | Description                                     |
| --------- | -------- | ----------------------------------------------- |
| `message` | `string` | The text content of the message                 |
| `from`    | `string` | The emitter: `"assistant"` or `"user"`          |
| `time`    | `string` | ISO 8601 timestamp of the message |
| `metadata` | `object` | Timing, interruption, language, and Assistant information when available |

## Example: technical support conversation

This transcript records a technical support call about connection timeouts. Tool calls appear in [Events](/docs/events).

```json
[
  {
    "message": "Hi, welcome to the technical support, how may I assist you today?",
    "from": "assistant",
    "time": "2025-12-15T16:04:51.002484"
  },
  {
    "message": "Hi, I'm having technical difficulties connecting to your service this morning and I'd like to report a bug.",
    "from": "user",
    "time": "2025-12-15T16:04:58.229180"
  },
  {
    "message": "I'm sorry to hear that you're experiencing issues. Could you please describe the problem in more detail? What exactly happens when you try to connect?",
    "from": "assistant",
    "time": "2025-12-15T16:05:06.000673"
  },
  {
    "message": "Well, I just get this timeout error after 30 seconds of trying to connect.",
    "from": "user",
    "time": "2025-12-15T16:05:23.036069"
  },
  {
    "message": "I see. Let me check the current system status. One moment please.",
    "from": "assistant",
    "time": "2025-12-15T16:05:29.072161"
  },
  {
    "message": "The system status appears to be normal. Let's try a few troubleshooting steps. Could you please check your internet connection? Maybe try restarting your router?",
    "from": "assistant",
    "time": "2025-12-15T16:05:38.046120"
  },
  {
    "message": "Oh yeah, okay, I checked and actually it's on my end. Sorry. Thank you.",
    "from": "user",
    "time": "2025-12-15T16:05:46.068351"
  },
  {
    "message": "You're welcome. If you have any other questions or need further assistance, feel free to ask. Have a great day!",
    "from": "assistant",
    "time": "2025-12-15T16:05:51.862629"
  }
]
```

## Usage notes

* Messages are ordered chronologically by their `time` field
* Timestamps use ISO 8601 and may include fractional seconds
* If transcript post-processing is enabled, `messages` contains its output and `rawMessages`, when present, retains the live transcript.
* Message metadata can include `start` and `end` offsets in seconds, `interrupted`, `language`, and `assistant_id`.
* Tool invocations by the Assistant are recorded in the [Events](/docs/events) array, not in messages

## What's next

- [Events](/docs/events)
