第 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 天)。

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」卡片 → 在「選擇您的 API 供應商」頁點「WhatsApp Cloud」。

2. 填入五個欄位:

   欄位	說明	範例
   對話管道名稱	你自己辨識用的名字	WhatsApp - 蘋果客服
   電話號碼	已驗證的電話,E.164 格式:+ 開頭、含國碼、不含空白與符號	+886912345678
   電話號碼 ID	Phone Number ID,17 位數字(不是電話號碼)	109xxxxxxxxxxxx
   商業帳戶 ID	WABA ID,10 位數字	1234567890
   API Key	步驟四產生的 System User 永久權杖,約 200 字	EAAG...

   表單沒有驗證字串欄位——驗證字串由系統在建立時自動產生,5.6 會用到。

3. 按「建立 WhatsApp 頻道」。

4. 接著選「客服人員」(預設已選你自己),按「新增客服人員」。

5. 最後一頁會顯示「訊息接收網址 Webhook URL」與「驗證字串 Verify Token」兩段。先別關掉這一頁,直接做 5.6。

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

1. 在 5.5 的最後一頁複製「訊息接收網址 Webhook URL」與「驗證字串 Verify Token」(每一段右上角都有「複製」;驗證字串是系統自動產生的 32 位英數)。
2. Meta 開發者後台 → 你的應用程式 → WhatsApp → 設定 / Configuration。
3. 在 Webhook 區塊填:
   • 回呼網址:剛複製的訊息接收網址。
   • 驗證權杖:剛複製的驗證字串。
4. 儲存 → 訂閱 messages 欄位。

🔴 驗證權杖要跟對話中心顯示的「驗證字串 Verify Token」一字不差:請用複製貼上,不要手打。儲存時 Meta 會回頭驗證一次,差一個字元就會失敗。

已經離開最後一頁、沒抄到? 到對話中心 → 該 WhatsApp 管道 → 設定頁 →「設定檔」分頁,「驗證字串 Verify Token」可以再複製一次。訊息接收網址在設定頁不會再顯示,但格式固定:https://chat.kinsunn.com/webhooks/whatsapp/ 後面直接接你在 5.5 填的電話號碼(含 +),例如 https://chat.kinsunn.com/webhooks/whatsapp/+886912345678。

5.7 費用怎麼算(2025 新制)

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

5.8 常見卡關