CSV號段導入完全指南：用自訂前綴批量產生號碼的詳細步驟（KK-DATA 教學）

在出海獲客與社群營運中，批量取得指定號段的手機號碼是精細化行銷的第一步。無論你是需要針對特定國家/地區批量產生 Telegram 有效號碼，還是為 WhatsApp 行銷準備資料來源，CSV 號段導入功能都能幫你從零開始、按需定製號碼池。

本文將完整講解：什麼是 CSV 號段導入、CSV 檔案的標準格式規範、導入操作全流程，以及如何與篩號模組銜接形成「產生 → 篩選 → 匯出」的資料流水線。

什麼是 CSV 號段導入？為什麼適合批量獲客？

CSV 號段導入，是指透過上傳一個包含號碼前綴、國家代碼、起始號段等資訊的 CSV 檔案，由系統根據正則規則快速產生對應範圍內的全部號碼。與手動輸入或「隨機產生」相比，CSV 號段導入具備三大優勢：

• 靈活定製：你可以精確控制每一個前綴和號段範圍，覆蓋特定電信商或地區。
• 批量高效：一次上傳，系統自動批量產生數千甚至數十萬號碼，極大節省人工拼接時間。
• 無縫銜接篩號：產生完成後，結果可一鍵發送至 Telegram、WhatsApp、iMessage 等平台的篩號模組，無需匯出再導入。

對於需要定製化取得柬埔寨 +855 某號段、奈及利亞 +234 特定電信商號段的團隊而言，CSV 導入是最直接、可控的產生方式。

準備工作：CSV 檔案的格式要求與規範

正確準備 CSV 檔案是導入成功的前提。如果格式不對，系統會直接拒絕或產生空資料。

CSV 欄名與資料格式詳解

KK-DATA 系統要求 CSV 檔案必須包含以下幾欄（欄名不區分大小寫，但建議嚴格按以下命名）：

欄名	資料型態	說明	範例
prefix	字串/數字	號碼前綴，通常為國家代碼+電信商號段開頭	86138（中國移動138號段）
country	字串	國家代碼（數字形式）	86（中國）、1（美國）、44（英國）
start_number	數字	號段起始數值	1000（若 prefix=138，則後綴從1000開始）
end_number	數字	號段結束數值	9999（若 prefix=138，後綴到9999結束）

一行範例：

prefix,country,start_number,end_number
86138,86,1000,9999

這行會產生所有以 138 開頭、後綴從 1000 到 9999 的號碼，共 9000 個。

編碼、大小限制與重複處理

• 編碼：CSV 檔案必須儲存為 UTF-8 編碼。使用 Windows 系統時，建議用記事本或 VS Code 另存為 UTF-8，避免出現亂碼導致導入失敗。
• 單檔案行數限制：參考主控台內提示（目前支援單次最多約 100 萬條產生任務，但 CSV 行數不宜過萬，否則可能因前綴過多導致產生時間過長）。
• 避免重複導入：多次導入相同的號段會浪費資源並產生大量重複號碼。建議上傳前在本機去重，或利用 KK-DATA 的資料去重倉庫功能，在篩號前自動去重。

一步步教你導入 CSV 自訂前綴產生號碼

以下步驟以 KK-DATA 主控台為準，操作過程可在 5 分鐘內完成。

登入主控台並進入產生模組

1. 前往 應用主控台，使用帳號密碼或 Telegram 快捷登入。
2. 在左側導覽列找到 「號碼產生」 模組，點選進入。

上傳 CSV 檔案並配置產生參數

3. 在產生模組頁面，點選 「CSV 導入」 按鈕（注意不要點「隨機產生」）。
4. 選擇你已準備好的 CSV 檔案，系統會自動解析並預覽欄位對應。如果欄位名稱一致，對應狀態會顯示為綠色。
5. 可選配置：部分號段可指定「每個前綴產生號碼數量」。例如，如果 prefix 欄對應多個號段，你可以設定每個號段最多產生 100 個號碼，避免總數過多。預設按 start_number~end_number 全部產生。
6. 確認預覽中的「預計產生總數」是否合理。若不正確，檢查 CSV 行內 start_number 和 end_number 是否填寫錯誤。

提交任務與查看結果

7. 點選 「提交產生」 按鈕。產生免費，不消耗餘額。
8. 等待幾秒至幾分鐘（取決於號段數量），在任務列表中查看產生狀態。狀態變為「完成」後，即可看到產生的號碼列表。
9. 此時可以 「匯出」 產生結果，或直接點選 「發送到篩號」 按鈕，將這批號碼一鍵推送到篩號模組。

產生後如何快速篩選有效號碼？

產生號碼只完成了資料準備的第一步。要讓號碼真正可用，需要對其進行有效性檢測。

1. 在產生結果列表，勾選需要的號碼批次，點選 「發送到篩號」。
2. 在篩號模組中，選擇檢測平台（Telegram、WhatsApp、iMessage 等）、檢測類型（開通、有效、活躍、性別識別等）。
3. 配置完成後，確認預估扣費金額（詳見主控台即時價格），提交篩號任務。
4. 完成後，在篩號結果中查看狀態（如「Telegram 有效」、「Telegram 活躍」），支援按條件過濾並匯出為 CSV 或 TXT。

這樣就完成了「CSV 導入 → 產生 → 篩號 → 匯出」的閉環。

實戰場景：從 CSV 導入到篩號匯出全流程

假設你要為某菲律賓市場活動準備資料，目標：獲取全號段 Telegram 活躍用戶。

步驟1：準備 CSV

• 搜尋並收集菲律賓 +63 的主要號段前綴（如 63905、63906、63917 等）。
• 每個前綴指定後綴範圍：start_number=1000000, end_number=9999999。
• CSV 內容：

  prefix,country,start_number,end_number
  63905,63,1000000,9999999
  63906,63,1000000,9999999

步驟2：導入產生
在主控台產生模組上傳 CSV，預計產生約 2000 萬號碼（實際根據需求調整範圍）。產生免費，等待幾分鐘。

步驟3：發送篩號
將產生結果全選，點選「發送到篩號」。選擇平台「Telegram」，檢測類型「活躍（30 天內）」。

步驟4：匯出結果
篩號完成後，將活躍結果匯出為 CSV。這批號碼即可用於 Telegram 群組邀請或私訊推廣。

常見錯誤與避坑指南

• CSV 欄順序不對：系統依賴欄名而非欄順序，但建議按 prefix, country, start_number, end_number 排列，避免混淆。
• 未填寫國家代碼：缺少 country 欄會導致系統無法比對國際規則，產生失敗。
• start/end 值寫反：若 start_number > end_number，產生結果數量為 0。請保證 start ≤ end。
• 產生後直接篩號未去重：如果多次產生同一號段，結果中會有重複號碼。建議在篩號前用資料去重倉庫去重，節省篩號費用。
• 檔案編碼錯誤：CSV 必須為 UTF-8 無 BOM 格式，否則部分號碼可能亂碼。

常見問題

問：CSV 檔案中的前綴有長度限制嗎？

答： 前綴長度受系統限制，具體請參考使用文件中的說明。通常建議前綴長度在 2-6 位數字之間，過長可能導致產生號碼數量為 0（因為系統無法比對號碼結構）。

問：可以同時導入多個國家的號段到同一個 CSV 嗎？

答： 可以。CSV 中每行需指定國家代碼（如 86、1），系統會根據國家自動比對號段規則。建議按國家分行，避免混淆。不同國家號段互不影響。

問：透過 CSV 產生號碼是否收費？篩號費用怎麼算？

答： 號碼產生完全免費。篩號費用按檢測條數從餘額扣除，不同平台（Telegram、WhatsApp、iMessage 等）和檢測類型（開通、有效、活躍）的單價不同，具體詳見主控台即時價格或官網計費頁。

問：導入後號碼數量為 0 是什麼原因？

答： 常見原因包括：CSV 欄名不匹配（如拼寫錯誤）、start_number 大於 end_number、前綴格式有誤（如包含非數字字元）、或號段已被其他任務產生但未正確解析。請檢查這些點，並確認 CSV 檔案編碼為 UTF-8。

問：能否控制每個前綴產生的具體號碼數量（而非全部號段）？

答： 可以。在提交產生任務前，系統支援「每個前綴最大產生數量」的配置。如果不需要全部號段，可以設定此參數，避免產生過多號碼。

---

透過本指南，你應該已經掌握了 CSV 號段導入從檔案準備到篩號匯出的完整流程。如果需要更高階的自訂複用或自動化操作，歡迎查閱 KK-DATA 文件 或直接聯絡客服 Telegram @kkdata_robot。登入 應用主控台，開始高效搭建你的獲客資料流水線吧。