Open in
外撥推廣活動
上載聯絡人名單,讓智能體按序處理——支援通話時段、重試及即時進度。
Campaign 會代表你致電聯絡人名單:選擇智能體、上載
CSV、設定允許致電的時段,ThunderPhone 便會按名單逐一處理
——並按照你選擇的時間表,重試未接來電及留言信箱。你可在 互動 → Campaigns(/dashboard/campaigns)找到此功能。
如需進行一次性的程式化通話,請改用 外撥通話 API。
先決條件
- 已部署的語音智能體。
- 已啟用外撥功能的電話號碼。客戶的 VoIP 號碼仍然支援外撥活動。ThunderPhone 號碼初始僅支援來電;組織管理員可於「電話號碼」頁面申請啟用外撥通話。ThunderPhone 會手動審核每項申請,獲批的號碼即可執行外撥活動。參閱 連接 VoIP 供應商。
- CSV 檔案(或貼上的 JSON)格式的聯絡人資料,並須包含
phone或phone_number欄位。每次上載最多 5,000 列,並須採用 UTF-8 編碼。新的 JSON 上載必須為扁平結構:額外值可以是字串、數字、布林值或null。包含陣列或巢狀物件的列會個別被拒絕,並顯示驗證訊息;有效列仍會匯入。CSV 儲存格均為字串。已接受的額外欄位會以每位聯絡人的變數形式保留在活動的聯絡人記錄中,並自動提供予每次撥號。ThunderPhone 亦會在每次外撥通話前分類已儲存的智能體提示,以決定智能體是否應導航電話選單。無論欄位標題如何拼寫,name和account_id等標題均會對應至已儲存智能體提示中的{{name}}和{{account_id}}。名稱對應亦可將多個欄位合併為name。有關預設值、命名規則、32 KB 物件限制,以及完成 webhook 回傳的值,參閱每次通話變數。
較舊的聯絡人記錄可能包含早期 JSON 上載的巢狀中繼資料。 該中繼資料會保留在已儲存的聯絡人資料中。每次撥號會從其變數 payload 中略過非純量值, 並記錄該次嘗試中被忽略的鍵名,但不會記錄值。 重試時亦會採用相同篩選方式。
建立 Campaign
- 按一下「新增推廣活動」
為推廣活動命名、選擇 語音智能體,並選擇 撥出號碼: 即一個或多個已啟用撥出功能的號碼。將通話分配至多個本地號碼, 可讓每個號碼維持在電訊商的垃圾來電門檻以下, 並向接聽者顯示本地區號。請參閱 號碼集區。
- 上載聯絡人 CSV
含有無效電話號碼或無效變數的資料列會被個別拒絕, 並連同其列號回報——其餘資料列仍會正常匯入。
- 設定撥打時段
選擇 時區 及 每日開始/結束時間;推廣活動 只會在該時段內撥號。時區預設採用你的第一個撥出號碼所屬時區 (美國及加拿大按其區號,其他地區按其國家),如沒有任何 撥出號碼可提供時區,則採用你的智能體時區。對於跨越多個 時區的號碼,例如免費電話號碼,系統會採用你的智能體時區; 如智能體未設定時區,則採用你的瀏覽器時區。欄位下方的提示會說明 所採用的時區。時段預設為 上午 9 時至下午 5 時。如開始時間早於上午 8 時,或結束時間晚於晚上 9 時, 系統會顯示警告:在該等時段以外撥打電話,可能違反撥打時段規則, 例如 TCPA 的規定。結束時間早於開始時間代表跨越午夜:22:00 → 02:00 會由晚上 10 時撥打至翌日凌晨 2 時,並顯示警告。 按各聯絡人的本地時間撥打(預設啟用)會按各聯絡人所在位置及其區號 套用時段:上午 9 時對紐約聯絡人而言是紐約時間上午 9 時, 對洛杉磯聯絡人而言則是洛杉磯時間上午 9 時。 沒有美國或加拿大區號的聯絡人會使用上述時區, 而跨越兩個時區的區號,只有在兩個時區均處於時段內時才會撥打。 關閉此選項,即可按推廣活動的時區為所有人套用時段。 你亦可設定 開始時間 以排程啟動,並設定 結束時間, 推廣活動會在該時間後自動完成。
- 調整撥打節奏及重試
- 同時通話數目 —— 此推廣活動可同時進行的通話數目 (1–10,預設為 3)。當你的機構已有 10 個撥出通話進行中時, 推廣活動不會開始新的通話,因此並行推廣活動會共用 此額度。每通電話亦會計入你機構的 同時通話上限 (預設為 20,涵蓋撥入、撥出、網頁及測試通話)。 達到該上限時,或同一號碼在過去 10 秒內曾被撥打, 聯絡人只會等待下一輪處理;其嘗試次數不會被扣除。
- 每個號碼每日通話數目 —— 每個撥出號碼在任何 24 小時內 最多可撥出的電話數目(1–500,預設為 75)。清除此設定即可 不設上限。如集區中的號碼目前被標記為中度或高度垃圾來電 風險,推廣活動會略過該號碼,直至標記解除。
- 最多嘗試次數 —— 每位聯絡人最多可被撥打的次數 (1–10,預設為 2)。
- 重試間隔(分鐘) —— 重試前的最短等候時間(至少 30 分鐘,預設為 60 分鐘)。
- 重試時間安排 —— 分散於不同日子及時段(預設) 會將每次重試安排至較後的日子,以及聯絡人一天中的不同時段: 上午,然後中午,再到傍晚。 等待間隔後 會在恰好相隔設定間隔後重試。
- 無人接聽時撥打兩次 —— 如電話響鈴至結束仍無人接聽, 會在 30–60 秒後使用同一號碼再撥一次。這不會消耗 一次嘗試。在 iPhone 上,如已啟用「允許重複來電」, 三分鐘內的第二通來電可在「勿擾模式」下仍然響鈴。重新撥號需要 撥號時間,因此啟用此選項後,如大部分電話均無人接聽, 推廣活動接觸新聯絡人的速度會較慢。
- 重試條件 —— 會觸發重試的結果:無人接聽、 語音信箱、失敗(全部預設啟用)。
需要更多嘗試次數或更短的間隔?請聯絡支援團隊:工作人員可 為你的組織提高這兩項限額。
- 建立草稿,然後啟動
推廣活動會以草稿形式建立——只有在推廣活動為草稿時才可新增聯絡人。 啟動推廣活動前,必須明確同意支付通話費用。如設定未來的 開始時間, 活動會變為 已排程;否則會立即開始 運行中。
號碼池及每日上限
電訊商會將每日撥出大量電話或短時間內密集撥號的號碼標記為垃圾電話,而客戶看到本地區號時亦較常接聽。使用多個撥出號碼(即號碼池)的推廣活動,會將通話分配至各個號碼:
- 每位聯絡人都會由上次致電所用的號碼再次聯絡,因此重試時會使用相同的來電顯示。新聯絡人會獲分配一個與其區號相同的號碼;如沒有,則分配相同時區的號碼;再沒有則使用過去24小時內使用次數最少的號碼。聯絡人列表會顯示致電各聯絡人的號碼。啟用 致電前傳送短訊 後,號碼會為已傳送短訊的聯絡人保留容量;當該容量已用盡時,重試可能會改由另一個號碼池中的號碼撥出。
- 每個號碼每日通話次數 會計算你的機構在過去24小時內由該號碼撥出的所有電話,包括其他推廣活動及 API 呼叫。
- 撥出通話不足一星期的 ThunderPhone 號碼會進行預熱:首日最多撥出20通電話,並於第7日平均提升至完整上限。使用你自有電訊商的號碼則毋須預熱。
- 當所有號碼均已達到上限,聯絡人會等待。系統不會失敗,亦不會扣除任何嘗試次數;推廣活動頁面會說明等待原因,而隨著前一天的通話不再計入,撥號會自動恢復。如要加快進度,請暫停推廣活動並新增號碼或提高上限。
- 如某個號碼在推廣活動進行期間停止運作,推廣活動會繼續使用其他號碼撥號,只有在沒有任何可用號碼時才會暫停。
一般而言,號碼池的規模應令名單的每日通話量除以號碼數量後低於上限。號碼池用於控制撥號節奏及維持本地識別度:如某個號碼被標記為垃圾電話,應停用該號碼,而非新增號碼以掩飾問題。
致電前發送短訊
預先得知會接到來電的號碼,聯絡人較有可能接聽。廣告活動可在首次致電前數分鐘向每位聯絡人發送短訊,說明來電者身分及來電號碼。
在廣告活動的建立或編輯表單中,於 致電前發送短訊 下啟用此功能:開啟選項,在 發送短訊號碼 下選擇號碼,編輯 訊息,並設定 致電前分鐘數(1–60,預設為 2)。透過 API,請在 campaign 設定 pre_call_sms_* 欄位。
-
短訊會透過你自己的 Twilio 或 Telnyx 號碼發送。ThunderPhone 號碼不能發送短訊。
-
訊息可使用聯絡人的變數,以及
{{org_name}}、{{agent_name}}和{{call_from_number}}(將致電此聯絡人的號碼池號碼;通話會由此號碼撥出)。缺少的變數會被略過,因此沒有名字的聯絡人會收到「Hi, this is …」。預設訊息:Hi {{first_name}}, this is {{org_name}}. We'll call you in a few minutes from {{call_from_number}}. Reply STOP to opt out of texts. -
只有首次致電會發送短訊;重試不會發送。廣告活動每 5 分鐘分批致電一次,因此使用預設的 2 分鐘設定時,通話約會在短訊發出後 5 分鐘進行。
-
致電前的分鐘數應保持較短。已發送短訊的聯絡人會保留其通話名額,直至完成致電,因此過長的提前時間會拖慢廣告活動:如同時進行 3 通電話並設定 30 分鐘,系統會先向 3 人發送短訊,然後等待半小時才致電。已發送短訊的聯絡人會優先於到期重試的聯絡人獲得致電。
-
只有在致電時段已開放,且在通話進行時仍會開放並預留 5 分鐘的情況下,才會發送短訊。啟用 按每位聯絡人的本地時間致電 時,將使用聯絡人本身的時段。否則,聯絡人會等待下一個時段。致電時段必須至少比致電前分鐘數長 12 分鐘。
-
發送失敗或被略過的短訊絕不會延誤致電:系統會立即撥打聯絡人。固網電話會被略過。發送失敗的短訊不會再次發送。
開啟廣告活動,即可在 短訊 欄查看每位聯絡人的短訊結果:已送達或已發送、未發送(附原因)、已略過或未知。透過 API,這是聯絡人的 pre_call_sms,而每則短訊亦會以 source: "pre_call" 顯示於 GET /v1/sms。
略過流動電話號碼
根據 TCPA,向流動電話號碼撥打 AI 語音電話前,必須先取得對方明確同意。如你致電商戶或固網電話,而名單中的流動電話號碼未取得有關同意,可要求 Zeus 讓推廣活動略過流動電話號碼,或透過 API 將 line_type_filter 設為 skip_mobile。
- 系統會在每名聯絡人的首次通話前查詢其電話號碼。系統會致電固網、VoIP 及免費電話號碼;不會致電流動電話號碼,以及查詢無法分類的號碼。
skip_landline則相反,只會略過固網電話號碼。 - 每次查詢的費用為不足一美仙,並從你的餘額扣除(請參閱收費)。如你的機構曾在過去 90 日內查詢該號碼,即可免費查詢;而從未致電的聯絡人亦不會被查詢。Zeus 會在啟用前先徵詢你的確認。
- 被略過的聯絡人會以 failed 結束,結果為
skipped_mobile(或skipped_landline、skipped_unknown_line_type),系統不會致電,並會在推廣活動結果中計為已略過。 - 如查詢失敗,聯絡人會等待下一輪處理;連續三輪失敗後,將以
line_type_check_failed結束,且不會被致電。
此篩選功能不能取代對已致電號碼所需取得的同意。
結果與重試機制
每次通話後,聯絡人都會獲得一個結果——成功通話會標示為完成;如通話被評定為無人接聽、偵測到語音信箱,或通話失敗,而該結果列於你的 重試條件 清單中,且聯絡人尚餘嘗試次數,系統便會重試。已用盡嘗試次數的聯絡人會標示為 已耗盡;不可重試的失敗會標示為 失敗。
監察與控制
每張活動卡均會顯示其狀態及進度(例如「248 個之中已完成 173 個」)。開啟活動即可查看狀態細分、各聯絡人的結果及最近通話——每項均連結至通話記錄中的完整逐字稿及錄音。
- 暫停/繼續 —— 暫停會停止新的撥號;正在進行的通話會自然完成。已暫停的活動可以編輯及繼續。
- 取消 —— 永久停止活動。
- 當每位聯絡人均達到最終狀態,或超過 結束時間,活動會自動完成。
活動狀態:draft、scheduled、running、paused、
completed、cancelled。聯絡人狀態:pending、scheduled、
calling、completed、failed、exhausted。