关于作者
KK-DATA 获客数据筛号平台官方内容团队。
如何匯出美國 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 匯出
- 登入控制台後,點擊左側選單「WhatsApp 篩號」。
- 點擊「建立任務」,上傳你準備好的號碼檔案。
- 在「篩選條件」區域,選擇檢測類型為「有效檢測」(也可同時勾選「活躍度」「性別識別」等,但注意部分檢測會增加單價)。
- 關鍵步驟:向下捲動至「匯出欄位」欄目,務必勾選「WSID」。其他可選欄位包括:
- 號碼(原始號碼,必選)
- 有效(布林值:true/false)
- 活躍度(如「7天活躍」「30天活躍」)
- 性別(透過頭像識別)
- 檢測時間
- 確認任務名稱、預估費用,然後點擊「提交任務」。
注意:平台支援單次最多約 100 萬條號碼的檢測,超過建議分批提交。提交前會顯示預估費用,確保餘額充足。
第三步:下載 CSV 檔案並解讀 WSID 資料
任務運行完成後(一般幾分鐘到幾小時內完成,取決於號碼數量),在「任務列表」中找到該任務,點擊「下載結果」即可獲得 CSV/TXT 檔案。打開 CSV 後,你會看到類似下圖的欄位表:
| 號碼 | wsid | 有效 | 活躍度 | 性別 | 檢測時間 |
|---|---|---|---|---|---|
| +14151234567 | 1987654321098765 | true | 7天活躍 | 男 | 2025-04-01 12:00 |
| +14151234568 | (空) | false | - | - | 2025-04-01 12:01 |
- 號碼:你提交的原始號碼。
- wsid:純數字 ID。若為空,表示該號碼未註冊 WhatsApp 或檢測失敗。
- 有效:true 表示該號碼已註冊 WhatsApp;false 表示無效。
- 其他欄位:僅當你在匯出欄位中勾選了對應項才會出現。
CSV 匯出結果中各欄位的含義是什麼?
典型 CSV 檔案會輸出以下欄位(部分可選):
| 欄位名 | 資料型別 | 含義 | 用途 |
|---|---|---|---|
number | 字串 | 原始手機號碼(含國際區號) | 基礎識別,用於回查 |
wsid | 數字或空 | WhatsApp 唯一 ID | API 新增聯絡人、去重、比對 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
更多操作細節可查閱使用文件。
Related Articles
如何評估美國WA號碼品質?四項關鍵指標與抽檢方法詳解
出海行銷必看:美國WA號碼品質怎麼評估?本文詳解有效號碼率、活躍率等核心指標,手把手教你抽檢方法與資料去重技巧,幫你高效篩選高價值WhatsApp聯絡人,提升獲客ROI。
美國WA號碼再行銷全攻略:用活躍篩選提升再觸達轉化率
美國WA號碼再行銷是提升復購與召回效率的關鍵。本文詳解基於活躍度的WhatsApp號碼篩選策略,介紹如何透過批量篩號避免無效觸達,結合再觸達時機與內容策略,幫助北美出海團隊提升轉化率。含真實場景對比與實施步驟,助力高效再行銷。
跨境電商美國WA號碼獲客:高效觸及北美客戶操作指南
本文為跨境電商詳細解析如何利用美國WA號碼進行北美私訊觸及,解決獨立站客服與行銷難題。涵蓋號碼驗證、活躍度篩選與安全合規要點,助你提升回覆率。