meta-whatsapp-cloud-api 是做什麼的？
此程序最後一次對照真實的 Meta Business Suite 和開發人員主控台進行演練是在 2026-11-08。Meta 經常在沒有預先通知的情況下更改這些畫面、欄位名稱和精靈流程——如果下列步驟與您所見不符，請在此儲存庫中開啟一個 issue，而不是猜測，如果您找到修正，請發送包含更正的 PR。
切勿
- 在拒絕驗證的當天重新提交。修正實際問題，等待 24 小時，然後再提交。當天重試通常會被標記，導致更長時間的審查。
- 猜測或「清理」在商業資訊中輸入的法律名稱、地址或電話號碼。從將上傳以證明這些資訊的文件中逐字複製它們。
- 未重新檢查實際狀態欄位（請參閱第 2 節）就將長時間的
pending狀態視為「Meta 只是比較慢」。它可能會悄然變為「需要更多資訊」，而通知電子郵件往往會落入沒有人積極監控的收件匣。 - 提供獨資經營者的稅務登記證書作為法律名稱或地址的證明，如果當地管轄區的等效文件不在 Meta 為此目的接受的清單上——請參閱第 1 節中的範例。Meta 明確說明何時文件「不是接受的類型」；請閱讀該訊息，而不是假設一個知名的當地文件會因為是官方文件而被接受。
- 在網站的實際首頁上缺少法律商業名稱的情況下提交。Meta 會擷取
/，而不是「關於」或「條款」頁面，如果名稱不在那裡，則會特別因此導致驗證失敗。 - 僅為獲得任務幫助就將外部協作者新增為完整的組合使用者。這是 Meta 自己清單中的一個明確拒絕原因——請改用權限較低的合作夥伴/協作者存取層級。
- 在任何非 Meta 自己主控台的介面中輸入驗證碼、雙步驟 PIN 碼或任何密碼，且必須由帳戶持有人親自輸入。
1. 商業驗證
驗證是什麼，以及不是什麼
Meta Business Suite 中的商業驗證與付費的 Meta Verified 訂閱是不同的事物，並且不會產生驗證徽章。Meta 直接說明：「在 Meta Business Suite 中驗證您的商業帳號與企業的 Meta Verified 不同，不會為您提供驗證徽章。」（Meta Business 說明中心，「如何驗證您在 Meta Business Suite 中的商業帳號」，https://www.facebook.com/business/help/2058515294227817，查閱於 2026-11-09——相同的句子在 https://www.facebook.com/business/help/2342133782492969 中重申，查閱於 2026-11-09）。驗證徽章是 Meta Verified 的特定權益：「企業的 Meta Verified 是一項付費訂閱，提供工具幫助您在新的受眾中建立更多信心並保護您的品牌。此訂閱附帶多項權益，例如驗證徽章、增強支援、假冒保護等。」（https://www.facebook.com/business/help/308979828303560，查閱於 2026-11-09）。Meta Verified 會定期計費，是與此技巧涵蓋的免費驗證程序分開的單獨購買項目。
商業驗證實際解鎖的內容，用 Meta 自己的話來說：「需要商業驗證才能存取某些廣告、開發人員、帳單和支出功能。」（https://www.facebook.com/business/help/2058515294227817，查閱於 2026-11-09）。在 https://www.facebook.com/business/help/1095661473946872（查閱於 2026-11-09）上有進一步說明：每日支出限制、符合資格的開發人員功能、Meta Business Partners 存取權、新聞頁面索引、WhatsApp Business Platform、粉絲專頁透明度、位於中國的代理商以及金融服務廣告客戶狀態。具體針對 WhatsApp Business Platform，同一頁面說明：「使用 WhatsApp Business Platform 的企業可能需要完成驗證才能存取某些功能。」在開發人員方面：「進階存取現在需要商業驗證... 請求權限進階存取的應用程式，以及允許其他企業存取其自身資料的應用程式，必須連接到已完成商業驗證的商業帳號。」（https://developers.facebook.com/docs/development/release/business-verification/，查閱於 2026-11-09）。
在上述任何頁面，或在 Meta 關於 WhatsApp 的帳戶擴展頁面（https://www.facebook.com/business/help/595597942906808，查閱於 2026-11-09）上檢查後，均未發現：Meta 關於在停止之前應重新提交多少次之任何聲明，或關於從根本上修正文件而不是再次重新提交之建議。該建議在第三方代理商部落格上很常見，但 Meta 沒有在任何為此技巧檢查過的地方提到它，因此此處不將其作為事實重複。下面的「切勿」清單堅持 Meta 自己頁面所支援的內容：一個時間規則，而不是次數規則。
選擇正確的文件組
Meta 自己接受的文件類別（直接從其「詳細資訊與後續步驟」對話框中讀取，該對話框僅在驗證嘗試實際執行後才會出現）：
| 證明 | 接受的類型 |
|---|---|
| 法律商業名稱 | 公司註冊證書/公司章程、商業執照或許可證、銀行對帳單或銀行信函 |
| 地址 | 上述四種，加上水、瓦斯、電費或電話費帳單 |
對於註冊公司而言，公司註冊證書通常是最簡潔的單一文件。對於沒有公司註冊的獨資經營者而言，通常沒有完全對應的文件——不要假設一個管轄區的通用小型企業稅務登記證書就算數，即使它感覺是顯而易見的文件。範例（以色列）： 以色列獨資經營者的 עוסק פטור/עוסק מורשה 證書會被 Meta 明確拒絕（「不是接受的類型」），即使它是以色列證明合法貿易狀態的標準文件。實際有效的方法是：一份用於證明法律名稱的銀行帳戶所有權信函（大多數銀行可以應要求開立，專門用於商業驗證）加上一份用於證明地址的水電費帳單——從兩個接受類別中各取一份文件，每份文件都精確列印出在商業資訊中輸入的名稱或地址。
無論管轄區為何，普遍適用的規則：
- 一份同時完整、清晰地包含名稱和地址的單一文件，可一次滿足兩項要求。
- 希伯來文或任何非英文文字按原樣接受——無需翻譯——但請為名稱/地址選擇一種語言，並在商業資訊、網站首頁和文件本身之間保持一致使用。
- 拒絕任何不值得嘗試的文件：租約、個人（非商業）帳單、入口網站的螢幕截圖、任何裁切、註解或以其他方式編輯過的文件，以及任何超過約 90 天的文件（正式註冊文件除外）。
- 從一種檔案格式忠實地全頁渲染到另一種格式（例如，從 PDF 到高解析度 PNG）是可以的；但裁切或重新輸入文件的任何部分則不行。
在提交前準備商業組合
- 商業資訊欄位必須與上傳的文件完全一致，包括標點符號和法律字尾（像 "Ltd" 這樣的公司字尾要麼同時出現在兩個地方，要麼都不出現）。決定要標準化使用哪種語言，並在所有地方使用它。
- 網站必須可連線、提供 HTTPS、在任何頁面上都不顯示錯誤或建置中狀態，並且——這是單獨檢查且與可連線性無關的失敗原因——在首頁上特別顯示確切的法律名稱。最近才註冊的網域也更容易引起懷疑；具有一定歷史的網域表現更好。
- 商業電子郵件應使用與網站相同的網域。免費的消費者電子郵件網域會顯著提高拒絕率，並在非此情況下減慢審查速度。
- 選擇一個誠實符合業務的描述類別——敏感類別（金融、健康、賭博、酒精）會招致額外的審查和額外的所需文件。
- 在商業組合上設定兩位管理員，並在兩者上都啟用雙因素認證，這有助於減少摩擦；單一未受保護的管理員本身就被列為拒絕觸發條件。
- 任何需要驗證的資產（通常是 WABA）必須在開始之前就已經附加到商業組合——否則驗證入口點本身會顯示為灰色並顯示「不符合資格」。
如果即使上述問題都已修正，網站仍持續通過其自身檢查失敗，Meta 記錄了兩種替代方式來確認商業身份，而非使用一個可運作的網站：在一個確實與該業務關聯的不同網域上寄送確認電子郵件，或者改為透過商業電話號碼進行確認。
確認管道會變更所需的文件
在精靈中選擇的確認管道會變更上傳步驟實際要求的內容：
- 選擇電話、簡訊或 WhatsApp 訊息作為管道 → 精靈接著需要證明法律名稱和電話號碼的文件。
- 選擇電子郵件作為管道 → 精靈需要證明法律名稱和地址或電話號碼的文件。
因此，請選擇管道以符合最容易取得的文件，而不是反過來——如果現有銀行信函和水電費帳單，請選擇電子郵件。
提交
前往驗證入口點（在 Meta 目前的佈局中為安全中心），選擇與正在驗證的項目相符的使用案例（通常有一個專門用於設定 WhatsApp Business 帳戶的單獨選項——如果兩者都存在，請優先選擇該選項，而不是通用的「應用程式權限」選項），然後逐步執行精靈：國家、業務類型（未註冊的獨資經營者通常是「獨資企業」，如果當地稅務機關已為其簽發任何註冊號碼，即使沒有正式公司，通常仍會回答為「已註冊」）、商業詳細資訊、CAPTCHA（始終由人類完成，絕不由自動化代理完成）、公共記錄比對步驟、確認管道、文件上傳以及最終審查/提交。
在該公共記錄比對步驟和上傳步驟中，有兩個值得預料到的陷阱：
- Meta 可能提供一個看似合理但實際上屬於另一個名稱相似但無關的實體的公共記錄比對。在接受比對之前，請驗證每個識別詳細資訊（地址、網域、顯示的任何稅務或註冊號碼）——聲明他人的商業記錄是一項政策違規行為，可能會限制整個商業組合，而不僅僅是導致此單次驗證失敗。如有疑問，請選擇「我的業務未列出」。
- 某些文件上傳步驟預設將一個容易忽略的切換開關（「您的文件是否包含您的電話號碼或地址？」）設為「否」，這會完全要求提供另一份大多數申請者手邊沒有的單獨文件。如果已上傳的單一文件確實包含這兩項資訊，請將該切換開關切換為「是」，則額外步驟就會消失。
提交後，預計經過管道驗證的提交大約需要 1-2 個工作日，而基於文件的提交則需要 3-7 個工作日（在 Meta 定期政策更新期間可能長達 14 天）。在提交處於「待處理」狀態時，請勿進行任何操作——不要新增管理員、更改設定或隨意開啟支援執行緒；這些都不會加速排隊中的審查，而且任何導致與已提交內容不一致的操作只會有害。
在不依賴電子郵件的情況下監控「需要更多資訊」
Meta 關於狀態變更的通知會發送到設為組合管理員聯絡人的任何電子郵件地址——這通常不是有人每天檢查的收件匣。一旦有任何 API 存取權限存在，唯一可靠且無需瀏覽器的檢查方式是直接進行 API 呼叫：
curl -s "https://graph.facebook.com/v21.0/$WABA_ID?fields=business_verification_status" \
-H "Authorization: Bearer $ACCESS_TOKEN"
在實踐中看到的值：pending（輪到 Meta 處理，除了等待別無他法）、pending_need_more_info（輪到您處理——請前往主控台確切閱讀要求的內容，僅此欄位不會說明）和 verified。請定期輪詢此狀態，而不是等待被告知——狀態悄然變為「需要更多資訊」與有人實際注意到之間的時間差，已經讓真正的提交浪費了整整一個審查週期。
2. 啟動 Cloud API（在驗證通過前也可運作）
以下每個步驟在未經驗證的組合上都能運作——驗證只會改變訊息量上限，而不會改變 API 本身是否可運作。請同時進行這兩項工作，而不是等待一項完成後才開始另一項。在第 1 步之前，必須已存在一個商業組合（在 business.facebook.com 建立）——下面的步驟是將一個新的應用程式附加到該現有組合，而不是建立一個新的組合。
- 建立應用程式。 在開發人員主控台中，使用以 WhatsApp 為中心的使用案例（「透過 WhatsApp 與客戶聯繫」，或目前主控台中任何等效的用語）建立一個應用程式，並將其附加到現有的商業組合——切勿為此建立新的組合，這會使驗證從頭開始。
- 附加或建立一個 WhatsApp Business 帳戶 (WABA)。 應用程式的 WhatsApp 設定面板可以連接到現有的 WABA 或建立一個。將 WABA ID 和測試電話號碼的 ID 持久地記錄在某處。
- 先嘗試 Meta 發行的測試號碼。 它在有限的試用期內是免費的，支援少數預先核准的收件者號碼（每個都需要一次性碼來加入白名單），並且是在涉及實際 SIM 卡之前證明您的 Webhook 和訊息發送程式碼能夠運作的最快方式。
- 產生系統使用者存取權杖，而不是臨時使用者權杖。具有適當角色的系統使用者，被指派給具有管理存取權的應用程式，可以產生一個沒有過期時間的權杖——所需的權限通常是訊息傳送和 WABA 管理範圍；如果整合將曾經透過 API 而非主控台讀取驗證狀態或刪除 WABA，則還需要更廣泛的商業管理範圍。來自快速入門指南的臨時權杖...
...（已截斷以進行翻譯）