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

# 狀態參考 (Status Reference)

> Pathors 系統中會出現的所有狀態值與含義。

Wire value 大小寫敏感，必須完全一致。

## Call Status

通話的最終狀態，會出現在 Dashboard、API、Webhook payload 上。

| 值                  | 意義                                         |
| ------------------ | ------------------------------------------ |
| `userHangup`       | 對方主動掛斷。                                    |
| `userRejected`     | 對方拒接。                                      |
| `agentHangup`      | Agent 主動結束通話。                              |
| `userNoAnswer`     | 使用者上線但在 timeout 前始終沒開口。                    |
| `agentNoAnswer`    | Agent 端始終沒接管 room。                         |
| `busy`             | 電話佔線。                                      |
| `invalidNumber`    | 目的號碼被判定為無效。                                |
| `voicemail`        | 外撥偵測到語音信箱，Agent 不發聲就掛斷。                    |
| `transferred`      | 成功轉接到真人或其他號碼。                              |
| `transferFailed`   | 嘗試轉接但失敗。                                   |
| `error`            | Agent 遇到無法恢復的錯誤。                           |
| `errorTransferred` | Agent 錯誤但已透過 fallback 號碼轉接救援。              |
| `sipTrunkFailure`  | SIP 層失敗（例如 provider 故障）。                   |
| `unknown`          | 結果無法分類 — 在 dashboard 將游標移到狀態 badge 上會顯示提示。 |

## Dispatch Status

活動裡每位聯絡人的狀態。

| 值           | 意義                        |
| ----------- | ------------------------- |
| `pending`   | 已匯入但還不能撥。                 |
| `queued`    | 已被選中要撥，等待容量。              |
| `running`   | 正在撥打中。                    |
| `completed` | 通話結束。                     |
| `failed`    | 沒撥成。`failedReason` 帶詳細原因。 |

## Number Pool Status

號碼池管理的號碼狀態。

| 值              | 意義                   |
| -------------- | -------------------- |
| `provisioning` | 正在向上游 provider 申請號碼。 |
| `pending`      | 已預留但還沒啟用。            |
| `active`       | 可撥可接。                |
| `suspended`    | 暫時停用。                |