ThunderPhone 2.0 正式上線。自助開通,每分鐘 2¢ 起。查看公告

Using the dashboard

外撥行銷活動

上傳聯絡人清單,讓智慧體依序處理——提供撥打時段、重試與即時進度。

活動會代你撥打聯絡人清單:選擇智慧體、上傳 CSV、設定允許撥號的時段,ThunderPhone 就會依序處理清單 ——依你選擇的排程重試未接聽和語音信箱。你可以在 互動 → 活動 (/dashboard/campaigns) 中找到它們。

如需一次性的程式化通話,請改用 撥出通話 API。

先決條件

  • 已部署的語音智慧體。
  • 已啟用外撥功能的電話號碼。客戶的 VoIP 號碼仍支援 活動。ThunderPhone 號碼一開始僅支援來電;組織管理員可以 從「電話號碼」頁面申請外撥通話。ThunderPhone 會人工審核 每項申請,核准的號碼即可執行活動。請參閱 連接 VoIP 供應商。
  • 以包含 phone 或 phone_number 欄位的 CSV 檔案(或貼上的 JSON)提供聯絡人。每次上傳最多 5,000 列,並採用 UTF-8 編碼。 新上傳的 JSON 必須為扁平結構:額外值可以是字串、數字、 布林值或 null。包含陣列或巢狀物件的列會個別遭拒, 並顯示驗證訊息;有效的列仍會匯入。CSV 儲存格皆為字串。接受的額外欄位會保留為活動 聯絡人紀錄中每位聯絡人的變數,並自動提供給每次撥號。ThunderPhone 也會 在每次外撥通話前對已儲存的智慧體提示詞進行分類,以決定 智慧體是否應操作電話選單。name 和 account_id 等標頭會對應到已儲存智慧體提示詞中的 {{name}} 和 {{account_id}}。名稱對應也可將多個欄位合併為 name。請參閱 每通通話變數,了解預設值、命名規則、 32 KB 物件限制,以及完成 Webhook 中傳回的值。

較早建立的聯絡人紀錄可能包含先前 JSON 上傳中的巢狀中繼資料。 這些中繼資料會保留在儲存的聯絡人中。每次撥號都會從 變數承載內容中略過非純量值,並記錄該次嘗試中被忽略的鍵名,但不會 記錄值。重試會使用相同的篩選方式。

建立活動

  1. 點選「新增行銷活動」

    為行銷活動命名,選擇 語音智慧體,並選取 撥出號碼 (你的其中一個已啟用撥出的號碼)。

  2. 上傳聯絡人的 CSV

    電話號碼或變數無效的資料列會個別遭到拒絕,並附上其資料列編號回報——其餘資料列仍可順利匯入。

  3. 設定撥打時段

    選擇 時區 與 每日開始/結束時間;行銷活動僅會在該時段內撥號。時區會以你的撥出號碼所在時區為預設 (在美國與加拿大依區域碼判定,其他地區則依國家判定);若號碼跨越多個時區,例如免付費號碼,則以你的 瀏覽器時區為預設。欄位下方的提示會說明使用的是哪一個時區。時段預設為上午 9:00 至下午 5:00。開始時間早於上午 8:00 或結束時間晚於晚上 9:00 的時段會顯示警告:在這些時段外撥打電話,可能違反 TCPA 等撥打時段規範。結束時間早於開始時間表示跨越午夜: 22:00 → 02:00 會從晚上 10:00 撥打至隔日凌晨 2:00,並顯示警告。時段依行銷活動的時區執行,而非各聯絡人的時區;因此,當聯絡人分布於不同時區時,請依時區分組。 你也可以設定 開始時間 來排定啟動時間,以及設定 結束時間,讓行銷活動在該時間後自動完成。

  4. 調整撥打頻率與重試
    • 同時通話數 —— 此行銷活動可同時進行的通話數量 (1–10,預設為 3)。當你的組織已有 10 通撥出電話進行中時,行銷活動不會開始新的通話,因此平行執行的 行銷活動會共用此額度。每通電話也會計入你組織的同時通話上限 (預設為 20,包含撥入、撥出、網路及測試通話)。 達到此上限時,或同一號碼在過去 10 秒內已被撥打過時,聯絡人只會等待下一次嘗試;其嘗試次數不會被扣除。
    • 最大嘗試次數 —— 每位聯絡人可被撥打的次數 (1–10,預設為 2)。
    • 重試退避時間(分鐘) —— 重試前的等待時間(至少 30, 預設為 60)。
    • 重試條件 —— 哪些結果會觸發重試:未接聽、 語音信箱、失敗(預設全部啟用)。

    需要更多嘗試次數或更短的間隔嗎?請聯絡支援團隊:支援人員可提高你組織的這兩項上限。

  5. 建立草稿,然後啟動

    行銷活動會以草稿形式建立——僅能在行銷活動為草稿時新增聯絡人。啟動行銷活動時,必須明確同意通話費用。 若設定未來的 開始時間,行銷活動會變為 已排程;否則會立即開始 執行中。

結果與重試的運作方式

每通電話結束後,聯絡人都會取得一個結果——成功的通話會 標記為已完成;若通話被判定為未接聽、偵測到語音信箱,或 失敗,且該結果位於你的重試條件清單中,並且聯絡人仍有剩餘嘗試次數, 系統就會重試。已用盡嘗試次數的聯絡人會標記為 已用盡;無法重試的失敗則會標記為失敗。

監控與控制

每張活動卡片都會顯示其狀態與進度(例如「248 通中已完成 173 通」)。開啟活動即可查看狀態明細、每位聯絡人的結果與 最近通話——每一通都會連結至通話紀錄中的完整逐字稿與 錄音。

  • 暫停/繼續——暫停會停止新的撥號;已在 進行中的通話會自然結束。已暫停的活動可以編輯並繼續執行。
  • 取消——永久停止活動。
  • 當每位聯絡人都達到最終 狀態,或超過結束時間時,活動會自行完成。

活動狀態:draft、scheduled、running、paused、 completed、cancelled。聯絡人狀態:pending、scheduled、 calling、completed、failed、exhausted。

後續步驟