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

# 獲取小組件會話列表

> 分頁返回某個小組件的訪客會話，每個會話附帶一行預覽內容。

## 身份驗證

需要 Bearer 令牌（API 密鑰）或儀表盤會話。

## 路徑參數

<ParamField path="id" type="string" required>
  小組件配置的 UUID。
</ParamField>

## 查詢參數

<ParamField query="limit" type="number" default="50">
  每頁數量（最大 200）。
</ParamField>

<ParamField query="offset" type="number" default="0">
  要跳過的會話數量。
</ParamField>

<ParamField query="from" type="string">
  ISO 時間戳下限（含邊界值）。
</ParamField>

<ParamField query="to" type="string">
  ISO 時間戳上限（含邊界值）。
</ParamField>

<ParamField query="has_lead" type="string">
  `true` 或 `false` —— 按是否已捕獲潛在客戶進行過濾。
</ParamField>

<ParamField query="status" type="string">
  `active`、`completed` 或 `all`。
</ParamField>

## 響應

<ResponseField name="conversations" type="array">
  每個會話包含：`session_id`、`visitor_id`、`ip_country`、`city`、`page_url`、`started_at`、`ended_at`、`last_seen_at`、`message_count`、`lead_captured`、`lead_data`、`first_message`（預覽內容）、`duration_seconds`、`referrer_url`、`takeover_status`。
</ResponseField>

<ResponseField name="total" type="number">
  符合過濾條件的會話總數。
</ResponseField>

<ResponseField name="limit" type="number" />

<ResponseField name="offset" type="number" />

## 示例

```bash curl theme={null}
curl "https://www.hitheo.ai/api/v1/iframes/CONFIG_ID/conversations?status=active" \
  -H "Authorization: Bearer $THEO_API_KEY"
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.