KK-DATA avatar KK-DATA

如何匯出美國 WA 號碼的 WSID?完整教學與欄位說明

美国wa号码 wsid kkdata WhatsApp营销

如何匯出美國 WA 號碼的 WSID?完整教學與欄位說明

在北美市場的 WhatsApp 行銷中,美國 WA 號碼 WSID 匯出 是資料營運的關鍵環節。WSID(WhatsApp ID)是每個 WhatsApp 帳號的唯一數位識別碼,相比手機號碼更穩定、更適合做客戶身分識別。無論你是透過篩號平台驗證了美國號碼的有效性,還是從自有用戶表中擷取號碼,學會匯出並正確使用 WSID,能顯著提升 CRM 比對精準度、自動化訊息送達率以及跨系統去重效率。

本文將以 KK-DATA 平台為例,從 WSID 的定義、匯出步驟、CSV 欄位含義到實際應用場景,為你提供一套可落地的操作指南。


什麼是 WSID?為什麼匯出美國 WA 號碼的 WSID 很重要

WSID(WhatsApp ID)是 WhatsApp 分配給每個註冊帳號的內部唯一識別碼,格式為純數字串(例如 1234567890123456)。它不隨 SIM 卡變更、號碼註銷或手機換機而改變(除非用戶主動註銷帳號),因此在海外行銷中被視為比手機號碼更可靠的客戶身分錨點。

對於拓展美國市場的團隊而言,匯出美國 WA 號碼的 WSID 有三大核心價值:

  • 精準比對 WhatsApp Business API:API 新增聯絡人時支援透過 WSID 或手機號,但 WSID 可避免因號碼格式不一致導致的失敗。
  • 跨系統資料去重:同一用戶可能在不同時期留下多個號碼,WSID 唯一性可合併重複記錄。
  • 避免號碼回收帶來的客戶流失:美國手機號經常被電信商回收再分配,而 WSID 只要用戶未註銷 WhatsApp 就保持不變。

WSID 與手機號碼的區別

對比維度WSID手機號碼
穩定性極穩定,除非用戶註銷帳戶可能因換號、轉移、回收而變化
可用性僅限 WhatsApp 生態內跨平台通用(但號碼狀態不確定)
隱私保護用戶不可見,僅透過 API 或篩號取得用戶可見,易被洩漏
行銷應用適合長期客戶關係管理適合一次性觸及(如簡訊)

WSID 在 CRM 和自動化工具中的典型應用

  • 載入歷史對話:在 WhatsApp Business 用戶端中,用 WSID 可直接拉取與該用戶的聊天紀錄,識別老客戶。
  • 避免重複新增:當多個資料來源匯入聯絡人時,透過 WSID 去重可防止向同一用戶重複推送訊息。
  • 客戶身分識別:將 WSID 與 CRM 中的客戶 ID 綁定,即使對方更換號碼,也能透過 WSID 比對到歷史紀錄。

如何在美國 WA 號碼篩號後匯出 WSID?分步操作指南

以下步驟基於 KK-DATA 控制台(https://app.kkdata.cc/)的實際介面,其他平台流程類似,但欄位名稱可能不同。

開始前請確認餘額充足

篩號任務按條扣費,建議提前儲值並確保帳戶餘額大於 0。可在控制台「餘額明細」查看當前可用額度。儲值及計費詳情請見官網計費頁

第一步:準備美國號碼列表

你需要一份待檢測的美國號碼 CSV 或 TXT 檔案,格式要求:

  • 每行一個號碼,包含國際區號 +1(例如 +14151234567)。
  • 號碼中不應包含空格、括號或短橫線。
  • 建議先執行基礎清洗:去除重複項、確保格式統一。

如果手邊沒有現成的美國號碼,可以使用平台的「全球號碼產生」模組,選定國家「美國」後產生號段列表,或匯入自訂號段。產生的號碼免費,僅篩號時按條扣費。

第二步:建立 WhatsApp 篩號任務並勾選 WSID 匯出

  1. 登入控制台後,點擊左側選單「WhatsApp 篩號」。
  2. 點擊「建立任務」,上傳你準備好的號碼檔案。
  3. 在「篩選條件」區域,選擇檢測類型為「有效檢測」(也可同時勾選「活躍度」「性別識別」等,但注意部分檢測會增加單價)。
  4. 關鍵步驟:向下捲動至「匯出欄位」欄目,務必勾選「WSID」。其他可選欄位包括:
    • 號碼(原始號碼,必選)
    • 有效(布林值:true/false)
    • 活躍度(如「7天活躍」「30天活躍」)
    • 性別(透過頭像識別)
    • 檢測時間
  5. 確認任務名稱、預估費用,然後點擊「提交任務」。

注意:平台支援單次最多約 100 萬條號碼的檢測,超過建議分批提交。提交前會顯示預估費用,確保餘額充足。

第三步:下載 CSV 檔案並解讀 WSID 資料

任務運行完成後(一般幾分鐘到幾小時內完成,取決於號碼數量),在「任務列表」中找到該任務,點擊「下載結果」即可獲得 CSV/TXT 檔案。打開 CSV 後,你會看到類似下圖的欄位表:

號碼wsid有效活躍度性別檢測時間
+141512345671987654321098765true7天活躍2025-04-01 12:00
+14151234568(空)false--2025-04-01 12:01
  • 號碼:你提交的原始號碼。
  • wsid:純數字 ID。若為空,表示該號碼未註冊 WhatsApp 或檢測失敗。
  • 有效:true 表示該號碼已註冊 WhatsApp;false 表示無效。
  • 其他欄位:僅當你在匯出欄位中勾選了對應項才會出現。

CSV 匯出結果中各欄位的含義是什麼?

典型 CSV 檔案會輸出以下欄位(部分可選):

欄位名資料型別含義用途
number字串原始手機號碼(含國際區號)基礎識別,用於回查
wsid數字或空WhatsApp 唯一 IDAPI 新增聯絡人、去重、比對 CRM
valid布林值(true/false)是否註冊 WhatsApp篩選有效客戶池
active字串(如「7d」「30d」)最近活躍時間視窗判斷用戶活躍度,高活躍優先觸及
gender字串(男/女/未知)透過頭像識別的性別廣告興趣定向或個人化文案
detect_time時間戳檢測完成時間資料時效性參考

WSID 為空時的常見原因

  • 號碼未註冊 WhatsApp。
  • 號碼為空號、停機或無效。
  • 檢測過程中網路異常,導致部分號碼未能取得 WSID。
  • WhatsApp 因隱私限制暫不回傳該帳號的 ID(極少見)。

建議對 WSID 為空的行進行二次篩查:僅保留 valid = true 但 WSID 為空的行,可以嘗試重新提交檢測一次。


匯出 WSID 後如何用於 WhatsApp 行銷?

獲得美國 WA 號碼的 WSID 後,你可以將它應用於以下典型場景:

透過 WSID 匯入 WhatsApp Business Manager

WhatsApp Business API(Cloud API / On-Premises API)支援透過 contacts 介面上傳聯絡人。上傳時既可用手機號碼,也可用 WSID。利用 WSID 的優點:

  • 避免因號碼格式問題(如缺少區號)導致新增失敗。
  • 快速比對已存在的聯絡人(WSID 不變)。
  • 批次匯入後,可直接傳送範本訊息。

操作範例(虛擬碼):

POST /v1/contacts
{
  "contacts": [
    {"wa_id": "1987654321098765"},
    {"wa_id": "1987654321098766"}
  ]
}

使用 WSID 進行客戶去重與標籤管理

在 CRM 或 CDP 系統中,將 WSID 作為客戶主鍵:

  • 合併不同來源的重複紀錄:同一 WSID 對應多個手機號時,合併為一個客戶。
  • 關聯標籤:例如將「7天活躍」的 WSID 打上「高意向」標籤,後續自動化流程優先發送優惠資訊。

最佳實踐:建一個 WSID 對應表

每次篩號後,將 WSID 與號碼、檢測日期存入資料庫。定期比對去重,避免重複觸及同一用戶。對於已確認註銷的 WSID,及時從發送列表中剔除,減少 API 錯誤率。


匯出 WSID 時需要注意哪些事項?

確保合規:美國市場隱私與出口管制

  • TCPA(電話消費者保護法):禁止未經事先同意向消費者發送自動商業訊息。取得 WSID 本身不違法,但後續使用 WSID 發送行銷訊息必須基於用戶明確 opt-in(例如透過網站、購買紀錄等)。
  • CCPA(加州消費者隱私法案):如涉及加州居民資料,需提供資料查詢與刪除管道。
  • 出口管制:美國號碼資料儲存或處理可能受 EAR(出口管理條例)限制,建議將資料保留在美國境內伺服器(KK-DATA 資料中心位於北美)。

建議:僅在你有合法業務關係(如用戶主動註冊、購買產品後允許聯繫)的用戶清單中使用 WSID 進行行銷。

WSID 可能因隱私政策變化而失效

WSID 可能因隱私政策變化而失效

WhatsApp 會不定期調整用戶識別策略,長時間未活動的帳號 WSID 可能被回收。建議定期更新資料(例如每 30 天重新檢測一次),避免使用過期的 WSID 進行關聯。

餘額與任務限制

  • 單次任務最大支援約 100 萬條號碼,超過需分批提交。
  • WSID 匯出不額外計費,費用僅按檢測條數扣除(不同平台檢測類型單價不同,詳見控制台即時價格或官網計費頁)。
  • 任務提交前務必核對預估費用,餘額不足時無法提交。

常見問題

問:WSID 是什麼?匯出後怎麼用?
答:WSID 是 WhatsApp 分配給每個帳號的唯一數字識別碼,類似用戶 ID。匯出後可用於 WhatsApp Business API 批次新增聯絡人、CRM 資料去重以及跨系統比對。

問:CSV 匯出的 WSID 欄位為空,可能是什麼原因?
答:常見原因包括:號碼未註冊 WhatsApp、號碼無效(空號/停機)、網路波動導致檢測未完成、或該帳號因隱私設定限制了識別碼取得。建議檢查號碼有效性並重新提交檢測。

問:單次任務最多可以匯出多少條美國 WA 號碼的 WSID?
答:平台支援單次最多約 100 萬條號碼的檢測結果匯出,具體條數可在任務提交時查看預估。超過建議分批處理。

問:WSID 會變化嗎?篩選後的 WSID 可以長期使用嗎?
答:WSID 相對穩定,但如果用戶註銷帳號、長時間未使用或被 WhatsApp 回收,WSID 可能會失效。建議每 1–3 個月重新檢測更新一次清單,確保資料有效性。

問:匯出 WSID 是否需要額外付費?
答:不需要。WSID 匯出僅是篩號結果中的一個可選欄位,費用按檢測條數一次性扣除,不另收匯出費。不同檢測類型單價不同,詳情請見控制台即時價格。


如需快速開始匯出美國 WA 號碼的 WSID,請直接登入控制台建立任務:

👉 登入控制台開始篩號
雙向聯繫客服:https://t.me/kkdata_robot
更多操作細節可查閱使用文件