> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thunderphone.com/llms.txt
> Use this file to discover all available pages before exploring further.
# 外撥行銷活動
> 上傳聯絡人清單，讓智慧體依序處理——提供撥打時段、重試機制與即時進度。
外撥活動會代表你撥打聯絡人清單：選擇智慧體、上傳
CSV、設定允許撥打的時間，ThunderPhone 就會依序處理清單
——依照你選擇的排程重試未接聽與語音信箱。你可以在 **互動 → 活動**（`/dashboard/campaigns`）中找到它們。
如需一次性的程式化通話，請改用
[外撥通話 API](/zh-Hant/guides/place-outbound-calls)。
## 先決條件
* 已部署的語音智慧體。
* 已連線至你組織、用於撥出的 **VoIP 電話號碼**——
示範號碼僅限接聽來電，無法撥打活動通話。請參閱
[連線 VoIP 供應商](/zh-Hant/guides/voip-providers)。
* 包含 `phone` 或 `phone_number` 欄位的 CSV 檔案（或貼上的 JSON）。
**每次上傳最多 5,000 列**，並須使用 UTF-8 編碼。
任何額外欄位都會保留為活動聯絡人紀錄中的個別聯絡人變數。
## 建立外撥活動
為活動命名、選擇 **語音智慧體**，並選擇 **撥出號碼**
（你的其中一個 VoIP 號碼）。
電話號碼無效的列會個別遭到拒絕，並回報其列號——其餘資料仍可正常匯入。
選擇 **時區** 與每日的 **開始／結束** 時段；活動僅會在該時段內撥號。
時段可跨越午夜（例如 22:00 → 02:00）。
你也可以設定 **開始時間** 以排程啟動，以及設定 **結束時間**，
活動將在該時間後自動完成。
* **並行通話數** —— 此活動同時執行的通話數量
（1–10，預設為 3）。你的組織在所有項目中也上限為 **10
通並行外撥通話**，因此平行執行的活動會共用此額度。
* **最多嘗試次數** —— 每位聯絡人可撥打的次數
（預設為 2）。
* **重試間隔（分鐘）** —— 重試前的等待時間（預設為 60）。
* **重試條件** —— 哪些結果會觸發重試：**未接聽**、
**語音信箱**、**失敗**（預設全部啟用）。
活動會以草稿形式建立——只有在活動為草稿時才能新增聯絡人。
啟動活動需要明確同意通話費用。若設定未來的 **開始時間**，
活動會變為*已排程*；否則會立即開始*執行中*。
## 結果與重試的運作方式
每通電話結束後，聯絡人都會獲得一項結果——成功的通話會標示為已完成；
若通話被判定為未接聽、偵測為語音信箱或失敗，只要該結果列於你的
**重試條件** 清單中，且聯絡人仍有剩餘嘗試次數，就會進行重試。
已用盡嘗試次數的聯絡人會標示為*已用盡*；不可重試的失敗會標示為*失敗*。
當你的帳戶餘額狀態未維持正常時，撥號會自動暫停，並在恢復正常後繼續。
對於長時間執行的活動，請保持啟用
[自動儲值](/zh-Hant/guides/billing-and-topups)。
## 監控與控制
每張活動卡片都會顯示其狀態與進度（例如「248 通中已完成 173 通」）。
開啟活動即可查看狀態明細、各聯絡人的結果與最近通話——每通電話都會連結至通話紀錄中的完整逐字稿與錄音。
* **暫停／繼續** —— 暫停會停止新的撥號；已在進行中的通話會自然結束。
已暫停的活動可以編輯並繼續執行。
* **取消** —— 永久停止活動。
* 當每位聯絡人都達到終態，或超過 **結束時間** 時，活動會自行完成。
活動狀態：`draft`、`scheduled`、`running`、`paused`、
`completed`、`cancelled`。聯絡人狀態：`pending`、`scheduled`、
`calling`、`completed`、`failed`、`exhausted`。
## 後續步驟
在行銷活動通話進行時旁聽。
以程式方式撥打個別通話。