第 5 章 WhatsApp

5.1 先看這裡

（部分方案)WhatsApp 是否開放依你的方案而定,實際以你的方案為準。

5.2 兩個一定要先知道的事

1. 號碼一旦進入 WhatsApp 商業 API,就不能再用個人版 WhatsApp 登入。 請準備一支專用號碼,不要拿任何人的私人門號。
2. 綠色 logo 的「WhatsApp Business App」與這裡講的「商業 API」是兩個不同的產品,資料無法直接搬移。如果你現在用 App 版,接 API 前請先想清楚。

5.3 你需要準備的東西

• Meta 商業管理平台 帳號(有粉專的話通常已經有)。
• 一支沒有註冊過個人 WhatsApp、且能接收簡訊或電話驗證的號碼。
• 你要對外顯示的商家顯示名稱(要送 Meta 審核,1–7 天)。
• 一組你自己想的驗證字串:8–32 字元,只用英文、數字與連字號,例如 kinsunn-wa-2026。先想好、記下來,後面三個地方要填一模一樣的值。

5.4 步驟一~四:在 Meta 端把資產備齊

這一段全部在 Meta 商業管理平台 與 Meta 開發者後台操作:

這些名詞(WABA、Phone Number ID、System User)是 Meta 後台的固定名稱,介面語言切成中文時也會保留英文或直譯,依原文尋找即可。Phone Number ID 與 WABA ID 都可以在 Meta 開發者後台的 WhatsApp → API 設定頁面上直接看到。

5.5 步驟五:在對話中心建立 WhatsApp 管道

1. 依 0.2 進到「新增對話管道」頁 → 點「WhatsApp」卡片。

2. 填入五個值:

   欄位	說明	範例
   Phone Number(E.164)	已驗證的電話,要含國碼、不含空白與符號	+886912345678
   Phone Number ID	17 位數字(不是電話號碼)	109xxxxxxxxxxxx
   WhatsApp Business Account ID	WABA ID,10 位數字	1234567890
   System User Access Token	步驟四產生的永久權杖,約 200 字	EAAG...
   驗證字串	你在 5.3 想好的那組	kinsunn-wa-2026

3. 按建立。

5.6 步驟六:把訊息接收網址貼回 Meta(不能跳過)

1. 對話中心 → 該管道設定頁 → 複製「訊息接收網址」。
2. Meta 開發者後台 → 你的應用程式 → WhatsApp → 設定 / Configuration。
3. 在 Webhook 區塊填:
   • 回呼網址:剛複製的訊息接收網址。
   • 驗證權杖:與 5.5 填的驗證字串完全相同。
4. 儲存 → 訂閱 messages 欄位。

🔴 驗證字串要在三個地方一致:對話中心表單、Meta 端的驗證權杖欄位、以及儲存時 Meta 回頭驗證的那一次。三者有一個不同就會失敗。

5.7 費用怎麼算(2025 新制)

誰付錢:每個客戶用自己的 WABA 綁自己的付款方式,Meta 直接向你收訊息費,不經過我們。沒綁付款方式的話,免費額度用完就發不出範本。台灣屬 Meta「亞太其他地區」費率分組,實際費率以 Meta 公告為準。

5.8 常見卡關