--- title: "外撥活動" description: "上載聯絡人清單，讓智能體逐一跟進——支援通話時段、重試及即時進度。" --- 推廣活動會代你撥打聯絡人清單：選擇智能體、上載 CSV、設定允許撥號的時間，ThunderPhone 便會依序處理清單——按照你選擇的排程重試未接聽及語音留言。你可於 **互動 → 推廣活動**（`/dashboard/campaigns`）找到相關功能。 如要進行單次的程式化通話，請改用 [撥出通話 API](/yue/guides/place-outbound-calls)。 ## 先決條件 - 已部署的語音智能體。 - 已連接至你機構、可用作撥出的 **VoIP 電話號碼**——ThunderPhone 號碼僅支援撥入，不能用於推廣活動撥號。請參閱 [連接 VoIP 供應商](/yue/guides/voip-providers)。 - 包含 `phone` 或 `phone_number` 欄位的 CSV 檔案（或貼上的 JSON）。每次上載**最多 5,000 列**，並須使用 UTF-8 編碼。 新增的 JSON 上載必須採用扁平結構：額外值可為字串、數字、 布林值或 `null`。包含陣列或巢狀物件的列會個別被拒絕， 並顯示驗證訊息；有效列仍會匯入。CSV 儲存格均為字串。 已接受的額外欄位會保留為推廣活動聯絡人記錄中的每位聯絡人變數， 並於每次撥號時自動提供。`name` 和 `account_id` 等標題會對應至已儲存 智能體提示詞中的 `{{name}}` 和 `{{account_id}}`。名稱對應亦可將多個欄位合併為 `name`。有關預設值、命名規則、32 KB 物件限制，以及完成 Webhook 所傳回的值，請參閱[每次通話變數](/yue/guides/call-variables)。 較早期的聯絡人記錄可能包含先前 JSON 上載中的巢狀中繼資料。 該中繼資料會保留於已儲存的聯絡人記錄中。每次撥號都會從其變數資料中略過非純量值， 並記錄該次嘗試中被忽略的鍵名稱，但不會記錄其值。 重試時會採用相同的篩選方式。 ## 建立推廣活動 為推廣活動命名，選擇**語音智能體**，並選擇**撥出號碼** （你的其中一個 VoIP 號碼）。 電話號碼或變數無效的列會個別被拒絕，並 連同列號回報——其餘列仍可正常匯入。 選擇**時區**及每日的**開始／結束**時段；推廣活動 只會在該時段內撥號。時段可跨越午夜（例如 22:00 → 02:00）。 你亦可選擇設定**開始時間**以排程啟動，以及設定 **結束時間**，推廣活動會在該時間後自動完成。 - **同時通話**——此推廣活動可同時進行的通話數量 （1–10，預設為 3）。你的機構在所有項目中亦設有 **10 個 同時撥出通話**的上限，因此平行進行的 推廣活動會共用此配額。 - **最大嘗試次數**——每位聯絡人最多可被撥打的次數 （預設為 2）。 - **重試延遲（分鐘）**——重試前的等待時間（預設為 60）。 - **重試條件**——會觸發重試的結果：**未接聽**、 **語音留言**、**失敗**（預設全部啟用）。 推廣活動會以草稿形式建立——只有在推廣活動為草稿時才可新增聯絡人。 開始推廣活動前，必須明確同意通話費用。如設定未來的**開始時間**，活動會變為 *已排程*；否則會立即以*執行中*狀態開始。 ## 結果與重試的運作方式 每次通話後，聯絡人都會獲得一個結果——成功通話會 標記為已完成；如通話被判定為未接聽、偵測為語音留言，或 失敗，而該結果已列入你的**重試條件**清單，且聯絡人尚有剩餘 嘗試次數，系統便會重試。已用盡嘗試次數的聯絡人會標記為 *已耗盡*；不可重試的失敗則會標記為*失敗*。 當你的帳戶餘額不足時，撥號會自動暫停， 餘額恢復正常後便會繼續。進行長期推廣活動時，請保持啟用 [自動增值](/yue/guides/billing-and-topups)。 ## 監察及控制 每張推廣活動卡片均顯示其狀態及進度（例如「248 個之中已完成 173 個」）。開啟推廣活動即可查看狀態明細、每位聯絡人的 結果及最近通話——每項均連結至通話記錄中的完整逐字稿及 錄音。 - **暫停／繼續** —— 暫停會停止撥打新電話；進行中的 通話會自然結束。已暫停的推廣活動可予以編輯及繼續。 - **取消** —— 永久停止推廣活動。 - 當每位聯絡人均達到最終 狀態，或超過 **結束時間** 後，推廣活動會自動完成。 推廣活動狀態：`draft`、`scheduled`、`running`、`paused`、 `completed`、`cancelled`。聯絡人狀態：`pending`、`scheduled`、 `calling`、`completed`、`failed`、`exhausted`。 ## 下一步 在推廣活動通話進行期間即時旁聽。 以程式方式撥打個別電話。