--- title: "外撥行銷活動" description: "上傳聯絡人清單，讓智慧體依序處理——提供撥打時段、重試與即時進度。" --- 活動會代你撥打聯絡人清單：選擇智慧體、上傳 CSV、設定允許撥號的時段，ThunderPhone 就會依序處理清單 ——依你選擇的排程重試未接聽和語音信箱。你可以在 **互動 → 活動** (`/dashboard/campaigns`) 中找到它們。 如需一次性的程式化通話，請改用 [撥出通話 API](/zh-Hant/guides/place-outbound-calls)。 ## 先決條件 - 已部署的語音智慧體。 - 已啟用外撥功能的電話號碼。客戶的 VoIP 號碼仍支援 活動。ThunderPhone 號碼一開始僅支援來電；組織管理員可以 從「電話號碼」頁面申請外撥通話。ThunderPhone 會人工審核 每項申請，核准的號碼即可執行活動。請參閱 [連接 VoIP 供應商](/zh-Hant/guides/voip-providers)。 - 以包含 `phone` 或 `phone_number` 欄位的 CSV 檔案（或貼上的 JSON）提供聯絡人。**每次上傳最多 5,000 列**，並採用 UTF-8 編碼。 新上傳的 JSON 必須為扁平結構：額外值可以是字串、數字、 布林值或 `null`。包含陣列或巢狀物件的列會個別遭拒， 並顯示驗證訊息；有效的列仍會匯入。CSV 儲存格皆為字串。接受的額外欄位會保留為活動 聯絡人紀錄中每位聯絡人的變數，並自動提供給每次撥號。ThunderPhone 也會 在每次外撥通話前對已儲存的智慧體提示詞進行分類，以決定 智慧體是否應操作電話選單。`name` 和 `account_id` 等標頭會對應到已儲存智慧體提示詞中的 `{{name}}` 和 `{{account_id}}`。名稱對應也可將多個欄位合併為 `name`。請參閱 [每通通話變數](/zh-Hant/guides/call-variables)，了解預設值、命名規則、 32 KB 物件限制，以及完成 Webhook 中傳回的值。 較早建立的聯絡人紀錄可能包含先前 JSON 上傳中的巢狀中繼資料。 這些中繼資料會保留在儲存的聯絡人中。每次撥號都會從 變數承載內容中略過非純量值，並記錄該次嘗試中被忽略的鍵名，但不會 記錄值。重試會使用相同的篩選方式。 ## 建立活動 為行銷活動命名，選擇 **語音智慧體**，並選取 **撥出號碼** （你的其中一個已啟用撥出的號碼）。 電話號碼或變數無效的資料列會個別遭到拒絕，並附上其資料列編號回報——其餘資料列仍可順利匯入。 選擇 **時區** 與 **每日開始／結束時間**；行銷活動僅會在該時段內撥號。時區會以你的撥出號碼所在時區為預設 （在美國與加拿大依區域碼判定，其他地區則依國家判定）；若號碼跨越多個時區，例如免付費號碼，則以你的 瀏覽器時區為預設。欄位下方的提示會說明使用的是哪一個時區。時段預設為上午 9:00 至下午 5:00。開始時間早於上午 8:00 或結束時間晚於晚上 9:00 的時段會顯示警告：在這些時段外撥打電話，可能違反 TCPA 等撥打時段規範。結束時間早於開始時間表示跨越午夜： 22:00 → 02:00 會從晚上 10:00 撥打至隔日凌晨 2:00，並顯示警告。時段依行銷活動的時區執行，而非各聯絡人的時區；因此，當聯絡人分布於不同時區時，請依時區分組。 你也可以設定 **開始時間** 來排定啟動時間，以及設定 **結束時間**，讓行銷活動在該時間後自動完成。 - **同時通話數** —— 此行銷活動可同時進行的通話數量 （1–10，預設為 3）。當你的組織已有 10 通撥出電話進行中時，行銷活動不會開始新的通話，因此平行執行的 行銷活動會共用此額度。每通電話也會計入你組織的[同時通話上限](/api-reference/introduction#call-limits) （預設為 20，包含撥入、撥出、網路及測試通話）。 達到此上限時，或同一號碼在過去 10 秒內已被撥打過時，聯絡人只會等待下一次嘗試；其嘗試次數不會被扣除。 - **最大嘗試次數** —— 每位聯絡人可被撥打的次數 （1–10，預設為 2）。 - **重試退避時間（分鐘）** —— 重試前的等待時間（至少 30， 預設為 60）。 - **重試條件** —— 哪些結果會觸發重試：**未接聽**、 **語音信箱**、**失敗**（預設全部啟用）。 需要更多嘗試次數或更短的間隔嗎？請聯絡支援團隊：支援人員可提高你組織的這兩項上限。 行銷活動會以草稿形式建立——僅能在行銷活動為草稿時新增聯絡人。啟動行銷活動時，必須明確同意通話費用。 若設定未來的 **開始時間**，行銷活動會變為 *已排程*；否則會立即開始 *執行中*。 在這些限制生效前儲存的行銷活動，仍會完全依照已儲存的設定執行。 即使進行其他編輯，其嘗試次數與間隔仍會維持儲存時的設定。 ## 結果與重試的運作方式 每通電話結束後，聯絡人都會取得一個結果——成功的通話會 標記為已完成；若通話被判定為未接聽、偵測到語音信箱，或 失敗，且該結果位於你的**重試條件**清單中，並且聯絡人仍有剩餘嘗試次數， 系統就會重試。已用盡嘗試次數的聯絡人會標記為 *已用盡*；無法重試的失敗則會標記為*失敗*。 當你的帳戶餘額不足時，撥號會自動暫停，並會在餘額恢復正常後繼續。 若是長期活動，請保持啟用 [自動加值](/zh-Hant/guides/billing-and-topups)。 ## 監控與控制 每張活動卡片都會顯示其狀態與進度（例如「248 通中已完成 173 通」）。開啟活動即可查看狀態明細、每位聯絡人的結果與 最近通話——每一通都會連結至通話紀錄中的完整逐字稿與 錄音。 - **暫停／繼續**——暫停會停止新的撥號；已在 進行中的通話會自然結束。已暫停的活動可以編輯並繼續執行。 - **取消**——永久停止活動。 - 當每位聯絡人都達到最終 狀態，或超過**結束時間**時，活動會自行完成。 活動狀態：`draft`、`scheduled`、`running`、`paused`、 `completed`、`cancelled`。聯絡人狀態：`pending`、`scheduled`、 `calling`、`completed`、`failed`、`exhausted`。 ## 後續步驟 即時旁聽活動通話。 以程式方式撥打個別電話。