WA有效號碼WSID匯出全流程指南：從檢測到欄位說明與API對接

在出海獲客過程中，WhatsApp號碼的有效性驗證與精準識別是提升觸達率的關鍵。很多團隊做完WA有效號碼檢測後，發現匯出的資料中除了手機號，還有一個重要的欄位——WSID（WhatsApp ID）。這個ID到底是什麼？怎麼導出來？如何對接API批量使用？今天這篇指南一次性講清楚。

如果你還沒用過篩號平台，可以邊讀邊登入 KK-DATA 應用控制台 跟著操作；如果想先看文件，請移步 使用文件。

什麼是WSID？為什麼WA有效號碼匯出WSID很重要？

WSID 是 WhatsApp 為每個帳戶分配的內部唯一識別符，類似於用戶的「數字身份證」。當一個人更換手機號（例如換卡或變更運營商）時，WhatsApp 往往仍會保留原來的 WSID，只要他登入同一個帳戶。因此，WSID 比手機號更穩定，能長期追蹤同一用戶。

WSID與手機號的區別

匯出WSID後能用在哪些場景

• 社群去重：合併多個管道取得的WhatsApp聯絡人時，以WSID為唯一鍵，避免重複添加。
• 用戶畫像匹配：將WSID與CRM中已有線索關聯，即使對方換號也能識別出歷史行為。
• API二次驗證：呼叫WhatsApp Business API發送訊息前，先檢查WSID是否仍有效，節省費用。
• 跨平台資料同步：WSID可作為識別標識，在自有系統與第三方工具間傳遞。

WA有效號碼檢測後，如何匯出WSID？

在KK-DATA平台上，匯出WSID非常簡單，無需開發能力。以下為完整流程。

第一步：提交WA有效號碼檢測任務

1. 登入 應用控制台，選擇「WA有效檢測」任務類型。
2. 上傳號碼列表（支援CSV/TXT，每行一個國際格式號碼），或使用「全球號碼生成」功能按國家、號段生成待測號碼。
3. 在檢測配置中，勾選「匯出WSID」 選項（預設可能未勾選，請手動確認）。
4. 系統會預估本次任務費用，確認後提交。

第二步：任務完成後下載WSID匯出檔案

• 任務完成後，頁面會收到通知（也可綁定Telegram接收提醒）。
• 在「任務詳情」中點擊「下載結果」，選擇匯出格式（CSV或TXT）。
• 檔案內包含手機號、WSID、檢測狀態等欄位（具體見下文字段說明）。

第三步：WSID欄位解讀與資料清洗

範例CSV開頭幾行（不含真實資料）：

phone,wsid,valid_status,detect_time
8613800138000,86abcXYZ123456,valid,2025-03-01 12:00:00
8613900139000,,invalid,2025-03-01 12:00:01
8613600136000,86def789012345,valid,2025-03-01 12:00:02

• phone：原始號碼（國際格式）。
• wsid：檢測到的WSID；若號碼無效或未檢測到，此欄位為空。
• valid_status：valid 表示該號碼為有效的WhatsApp帳戶；invalid 表示未註冊或已註銷。
• detect_time：檢測完成時間。

拿到資料後，建議用篩選工具只保留 valid_status == valid 且 wsid 非空的行，再匯入CRM或進行下一步操作。

匯出WSID時包含哪些欄位？欄位說明請收好

以下為KK-DATA WA有效號碼檢測結果中常見的匯出欄位（具體欄位以控制台實際配置為準）：

phone,wsid,valid_status,detect_time
8613800138000,86abcXYZ123456,valid,2025-03-01 12:00:00
8613900139000,,invalid,2025-03-01 12:00:01

這些欄位可以直接對接你的內部系統。例如在CRM中將 wsid 作為唯一識別，替代手機號進行去重和關聯。

透過API對接WSID匯出，你需要注意這幾點

對於有技術能力的團隊，KK-DATA提供了RESTful API，可以將檢測和匯出整合到自己的自動化流水線中。以下為基礎呼叫要點。

1. 取得API金鑰

登入控制台 → 個人設定 → API管理 → 生成Token。請妥善保管，不要將Token硬編碼在前端程式碼或公開倉庫中。

2. 呼叫檢測任務介面

• 端點：POST /api/v1/detect
• 請求體（JSON）：

  {
    "source_type": "whatsapp",
    "detect_type": "valid",
    "export_wsid": true,
    "numbers": ["8613800138000", "8613900139000"]
  }

• 回應：返回 task_id，可用於輪詢任務狀態。

3. 取得檢測結果（含WSID）

• 端點：GET /api/v1/tasks/{task_id}/results
• 回應格式（JSON）：

  [
    {
      "phone": "8613800138000",
      "wsid": "86abcXYZ123456",
      "valid_status": "valid",
      "detect_time": "2025-03-01T12:00:00Z"
    },
    ...
  ]

4. 常見錯誤碼

批量匯出WSID時，如何避免重複檢測浪費預算？

如果你經常處理大量號碼，不同任務間很可能包含相同號碼。KK-DATA內建的「資料去重倉庫」可以自動去重，防止對同一號碼重複扣費。

• 在建立任務時，勾選「啟用資料去重倉庫」。
• 系統會檢查當前號碼是否已在30天內檢測過（檢測類型相似），若存在則跳過該號碼，不扣費。
• 你可以在「資料去重倉庫」頁面查看歷史檢測記錄，支援按號碼、按任務、按平台篩選。

最佳實踐：建議將每次匯出WSID的結果回傳到自己的資料庫，同時在KK-DATA側也開啟去重倉庫。雙重保障，最大化節省預算。

使用WSID匯出功能，性價比如何？

• 無訂閱套餐：KK-DATA按條扣費，用多少付多少。不需要預付月費，適合小團隊和爆發性需求。
• WA有效檢測費用：單條價格請登入控制台查看即時報價，一般低於市場均價。WSID匯出不額外收費——它只是檢測結果中的一個欄位。
• 充值方式：僅支援USDT（TRC20），最低約50 USDT，到帳自動生效。
• 餘額不足時：無法提交新任務，需先充值。

想估算成本？在提交任務前，控制台會顯示預估費用。實際扣費在任務完成後執行。

常見問題

問：WSID匯出後是否支援匯入第三方CRM？
答：支援。CSV/TXT格式為通用結構化資料，可直接匯入大多數CRM系統，但建議先驗證欄位映射是否匹配（如phone對應手機號、wsid對應WhatsApp ID）。

問：WA有效號碼檢測與WSID匯出是分開收費的嗎？
答：不是。檢測費用按條扣除，WSID匯出屬於檢測結果附帶欄位，不額外收費。具體單價請以控制台即時價格為準。

問：如果任務結果中沒有WSID欄位，可能是什麼原因？
答：可能原因包括：①所選的檢測類型未包含WSID匯出（如僅選擇了「有效」而未勾選「匯出wsid」）；②號碼檢測失敗或無效，系統不生成WSID。建議在提交任務前確認配置。

問：透過API匯出WSID時，是否需要申請額外權限？
答：使用API需要先在控制台取得API金鑰（Token），無需額外審批。請妥善保管Token，並在呼叫時注意請求頻率，避免觸發限流。

問：同一號碼在不同任務中匯出WSID會重複扣費嗎？
答：如果啟用了「資料去重倉庫」，系統會自動識別已檢測過的號碼，跳過重複檢測，避免二次扣費。建議高頻使用者開啟此功能。

希望這篇指南能幫你順利掌握WA有效號碼及WSID匯出的全流程。如果還有疑問，歡迎聯絡客服 @kkdata_cc 或查閱官方 使用文件。立即登入 應用控制台 開始你的第一個檢測任務吧！