# WhatsApp Business Tools MCP：如何將 WhatsApp Business 連接至 AI 代理程式

> Meta 官方 WhatsApp Business MCP 伺服器：代理程式能做什麼、在 Claude Code 中的連線指令、在 Codex 和 ChatGPT 中的設定方式，以及測試版的限制。

Source: https://ailoot.ai/blog/zh-hant-tw/whatsapp-business-mcp/
Canonical: https://ailoot.ai/blog/zh-hant-tw/whatsapp-business-mcp/
Language: zh-Hant-TW
Publisher: Ailoot (https://ailoot.ai/)
Translation: guide-234
Revision: sha256-6b62c79afe963661143006bd1cfd59f11d51b0e643150b3d394d87d4c78e56c5


2026 年 9 月 15 日，Meta 發布了官方的 WhatsApp Business Tools MCP 伺服器。它能將 AI 代理程式——Claude Code、Codex、ChatGPT 或 Cursor——連接至 WhatsApp Business Platform。你不必再在 Developer Console、Business Manager 和 API 文件之間切換，只要向代理程式描述工作，它就能新增電話號碼、建立訊息範本、設定 Webhook，並傳送測試訊息。

這個伺服器仍處於測試版：目前正逐步開放使用，這個版本是為開發和測試而推出，並非供大規模正式環境傳送訊息使用。以下介紹四種用戶端的準備工作和連線步驟。指令和設定已依據 Meta 於 2026 年 9 月 18 日的官方文件核對。

Ailoot 的使用資訊請參閱[文件](https://ailoot.ai/docs/)。



## 什麼是 WhatsApp Business Tools MCP？

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="本節重點">

重點

這是 Meta 官方的遠端 MCP 伺服器，為 AI 代理程式提供管理 WhatsApp Business Platform 的工具，包括帳號、電話號碼、訊息範本、Webhook 和測試傳送。存取方式採用 OAuth：你使用 Meta 帳號登入，並選擇允許伺服器操作的商家。

</div>

MCP（Model Context Protocol，模型情境協定）是用來將外部系統連接至 AI 代理程式的開放標準。深入了解請參閱文章[Claude Code 的 MCP 伺服器：7 種現成整合](https://ailoot.ai/blog/zh-hant-tw/mcp-servers-claude-code/)。已驗證且附有安裝指令的連線方式收錄於 MCP 目錄。

在這項服務推出之前，設定 WhatsApp 整合看起來會是這樣：開啟 Developer Console、建立應用程式、連結商家、新增電話號碼、輸入驗證碼完成驗證、產生權杖、設定 Webhook、查閱 API 文件——之後才能開始寫第一行程式碼。

Meta 對這個伺服器背後的構想有以下說明（由英文翻譯）：

<figure>
<blockquote>
<p>你只要描述需要什麼，代理程式就會自行找出帳號、電話號碼、範本和 API 呼叫方式。</p>
</blockquote>
<figcaption>— Meta for Developers，https://developers.facebook.com/blog/post/2026/09/15/whatsapp-business-messaging-mcp-ai-agent/</figcaption>
</figure>

Meta 現在有兩種 MCP 伺服器，很容易混淆。Meta Social Technologies MCP 是通用的開發者工具，可用來搜尋文件、探索 Graph API 端點，以及診斷應用程式錯誤。WhatsApp Business Tools MCP 則用於管理 WhatsApp 帳號、電話號碼、範本、Webhook 和測試訊息。兩者互補，需要時可以同時連線。

## 連線後，代理程式具體能做什麼？

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="本節重點">

重點

伺服器支援四類工作。從頭設定電話號碼：新增號碼、傳送驗證碼、驗證號碼並完成註冊。管理訊息範本：建立、編輯範本並檢查審核狀態。設定 Webhook：指定回呼 URL 並訂閱欄位。檢查前置條件：代理程式會偵測是否尚未接受條款或設定付款方式，並提供可直接前往修正問題的連結。

</div>

伺服器工具分組使用`whatsapp_biz_`前綴。根據官方文件，工具如下：

- 概覽：`whatsapp_biz_businesses`、`whatsapp_biz_accounts`、`whatsapp_biz_phone_numbers`——查詢你可以使用哪些商家、帳號和電話號碼。
- 電話號碼設定：`whatsapp_biz_add_phone_number`、`whatsapp_biz_send_verification_code`、`whatsapp_biz_verify_phone_number`、`whatsapp_biz_register_phone_number`。
- 範本：`whatsapp_biz_list_templates`、`whatsapp_biz_get_template`、`whatsapp_biz_create_template`、`whatsapp_biz_update_template`、`whatsapp_biz_delete_template`。
- 訊息：`whatsapp_biz_send_message`——在 24 小時對話時限內傳送自由格式文字，或在時限外傳送已核准的範本；代理程式會在傳送前向你確認收件者。
- Webhook：`whatsapp_biz_configure_webhooks`、`whatsapp_biz_subscribe_webhook`。
- 帳號設定：`whatsapp_biz_configure_payments`、`whatsapp_biz_verify_business`、`whatsapp_biz_system_user_token`——提供建立系統使用者權杖的連結，以便直接呼叫 Cloud API。

顧客先傳訊息給商家時，顧客服務時限便會開始。在 24 小時內，你可以用自由格式文字回覆。顧客每傳來一則新訊息，時限就會延長。時限結束後，你只能使用已核准的範本聯絡顧客。代理程式知道這項規則，如果收件者已不在時限內，就會建議使用範本，而非一般文字。

伺服器內建存取控制。你使用 Meta 帳號登入，並選擇特定商家；權杖不會包含在對話記錄中。每次讀取都會在你的使用者情境中執行，呼叫會留下記錄，而會造成變更的操作必須由已驗證的使用者執行；只有伺服器應用程式金鑰並不足夠。



## 連線前應該檢查什麼？

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="本節重點">

重點

三項必要條件：你在要管理的 Meta 商家中具有 MANAGE 角色；你是已啟用 WhatsApp 情境之應用程式的管理員；以及已接受 WhatsApp Business Cloud API 條款。若缺少任何一項，工具會傳回說明問題的錯誤訊息，並附上可前往修正的頁面連結。

</div>

伺服器會代表你操作，並且只使用你的資源，因此在第一次呼叫前，請確認以下事項：

1.  你有一個 Meta 商家，且在其中具有管理員身分（MANAGE 角色）。
2.  你有一個已啟用 WhatsApp Business Messaging 情境的 Meta 應用程式（或較舊應用程式中的 WhatsApp 產品），而且你是該應用程式本身的管理員；只有商家層級的權限並不足夠。
3.  該商家已接受 WhatsApp Business Cloud API 條款——若未接受，就無法註冊電話號碼或傳送訊息。

Meta 表示，使用條款、付款方式和商家驗證方面的問題經常在沒有明確說明的情況下出現。代理程式會事先檢查這些項目，並提供可直接前往接受條款、指定付款方式或開始商家驗證的連結。

## 如何將伺服器連接至 Claude Code？

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="本節重點">

重點

執行指令`claude mcp add --transport http whatsapp_business_tools https://mcp.facebook.com/whatsapp_business_tools`，然後在工作階段中輸入`/mcp`、選取伺服器，並透過 Meta 登入。重新啟動用戶端後，需要再次登入。

</div>

如果你還沒安裝 Claude Code，請先參閱指南[如何從官方網站安裝 Claude Code](https://ailoot.ai/blog/zh-hant-tw/install-claude-code/)。

1.  ### 新增伺服器

    在終端機中執行：

    ```bash
    claude mcp add --transport http whatsapp_business_tools https://mcp.facebook.com/whatsapp_business_tools
    ```

    這是遠端伺服器，因此不需要在本機安裝。

2.  ### 透過 Meta 登入

    在 Claude Code 工作階段中輸入`/mcp`，並選取`whatsapp_business_tools`。瀏覽器視窗會開啟，供你登入 Meta 帳號。如果瀏覽器沒有開啟，請從用戶端複製連結並手動開啟。

3.  ### 授予權限

    在同意畫面中，選擇你允許伺服器存取的商家和 WhatsApp 應用程式。伺服器會要求三項權限：`business_management`（尋找你具有管理員身分的商家）、`whatsapp_business_management`（帳號、電話號碼、範本、Webhook），以及`whatsapp_business_messaging`（從你的電話號碼傳送訊息）。

4.  ### 檢查連線

    重新啟動 Claude Code，透過`/mcp`再次登入，然後詢問代理程式在`whatsapp_business_tools`伺服器上看得到哪些工具。接著執行安全的讀取操作：「列出我可以管理的商家」——代理程式會呼叫`whatsapp_biz_businesses`。如果沒有任何工具，或出現登入錯誤，請檢查伺服器位址並再次登入。

OAuth 登入與用戶端啟動程序綁定：重新啟動 Claude Code 後，需要再次登入。你可以隨時前往 facebook.com 的設定，在「Business Integrations」下撤銷存取權。

## 如何連接 Codex、ChatGPT 和 Claude Desktop？

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="本節重點">

重點

這三種用戶端都使用相同的伺服器位址和 OAuth 登入方式，只有設定位置不同。Codex App：在 Settings、MCP Servers 中新增 Streamable HTTP 伺服器。ChatGPT：在 Settings、Plugins 中透過 URL 新增。Claude Desktop：在 Settings、Connectors 中新增自訂連接器。

</div>

**Codex App。** 開啟設定（左下角的齒輪），前往 MCP Servers，然後選取 Add servers。選擇 Streamable HTTP 並輸入：

- Name：`WhatsApp Business Tools`
- URL：`https://mcp.facebook.com/whatsapp_business_tools`
- Authentication：OAuth

按一下 Authenticate，並在瀏覽器中登入。

<strong>ChatGPT。</strong>依序前往 Settings、Plugins、Browse plugins，然後點選右上角的「+」圖示。輸入名稱、相同的 URL，以及 OAuth 作為驗證類型。

<strong>Claude Desktop。</strong>依序前往 Settings、Connectors、Add custom connector。Name：`WhatsApp Business Tools`；URL：相同的伺服器位址。

在任何用戶端新增伺服器後，依照相同的檢查步驟操作：重新啟動、再次登入、查看工具清單，並安全地讀取商家清單。

## 第一次工作階段會發生什麼事：從商家清單到測試訊息

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="本節重點">

重點

流程如下：列出商家、選擇一個商家、查看其帳號和電話號碼、新增電話號碼、透過簡訊或電話傳送驗證碼、用驗證碼驗證號碼、註冊號碼、建立範本、傳送測試訊息，以及設定 Webhook。你需要親自將收到的簡訊驗證碼提供給代理程式。

</div>

連接伺服器後，第一次工作階段通常會像這樣：

1.  「列出我管理的商家」——代理程式呼叫`whatsapp_biz_businesses`，然後由你選擇需要的商家。
2.  「顯示這個商家的 WhatsApp 帳號和電話號碼」——透過`whatsapp_biz_accounts`和`whatsapp_biz_phone_numbers`查看狀態。
3.  「將我的測試電話號碼新增至帳號」——`whatsapp_biz_add_phone_number`。
4.  「透過簡訊傳送驗證碼」——`whatsapp_biz_send_verification_code`。你的手機會收到驗證碼。
5.  「使用驗證碼 123456 驗證這個號碼」——呼叫`whatsapp_biz_verify_phone_number`，接著使用`whatsapp_biz_register_phone_number`註冊號碼。
6.  「使用收件者偏好的語言，建立一個用於訂單通知的`order_update`範本」——`whatsapp_biz_create_template`；代理程式會提供查看審核狀態的連結。
7.  「傳送測試訊息到我的號碼」——`whatsapp_biz_send_message`；代理程式會在傳送前向你確認收件者。
8.  「在[https://example.com/webhook](https://example.com/webhook)設定 Webhook」——呼叫`whatsapp_biz_configure_webhooks`，並使用`whatsapp_biz_subscribe_webhook`訂閱。

完成後，顧客傳入的訊息會抵達指定的位址——通常由 CRM、客服服務或機器人在該處接收。你需要另外建置該位址的訊息處理流程；伺服器只負責設定。

## 測試版有哪些限制？

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="本節重點">

重點

這個伺服器仍處於測試版：工具集合可能會變動，存取權也正逐步開放，並非同時提供給所有人。這個版本是為開發和測試而推出，不適合大規模正式環境訊息傳送。每個工具都設有使用者層級的請求限制，而且重新啟動用戶端後必須再次登入。

</div>

使用伺服器時，請留意以下四項限制。

**測試版狀態。** Meta 表示，介面和工具集合可能會變動，存取權也正逐步開放。如果你目前還無法連接伺服器，可能是因為尚未開放給你使用。

**用途。** 這個版本是為開發和測試而推出，並非供正式環境大量傳送訊息使用。若要在正式環境傳送訊息，你需要與 Cloud API 完整整合，例如使用`whatsapp_biz_system_user_token`工具提供連結的系統使用者權杖。

**限制。** 每個工具都設有使用者層級的請求限制。若超過限制，工具會傳回限制錯誤——請稍候再試。

**24 小時時限規則。** 顧客對話時限結束後，只能傳送已核准的範本。

## 這對企業有什麼意義？

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="本節重點">

重點

現在你可以在與代理程式的一次對話中完成 WhatsApp 整合的初始設定：代理程式了解操作順序，也能理解平台錯誤。主要用途包括客服、訂單和預約通知，以及準備訊息範本。

</div>

小型企業常見的情境是：顧客透過 WhatsApp 傳訊息，而你希望迅速回覆並傳送訂單狀態通知。過去，初始設定得由你自行操作好幾個 Meta 控制面板，或聘請開發者處理。現在你可以透過與代理程式對話完成這部分工作。你仍須另外建置在自家位址處理傳入訊息的流程——這是設定 Webhook 後的下一項工作。

如果整合已經在運作，這個伺服器也很實用。訊息範本需要定期更新，例如新增促銷活動或通知文字。透過伺服器，代理程式可以建立或編輯範本，並顯示審核狀態，不必帶你前往控制面板。

代理程式連接外部系統，並根據你的描述與系統互動；如何透過 MCP 將 NotebookLM 連接至 Claude Code這篇指南也用文件示範了類似做法。

## 接下來呢？

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="本節重點">

重點

檢查前置條件，使用一條指令連接伺服器並登入，然後安全地讀取商家清單。接著新增測試電話號碼並傳送第一則訊息。請記得目前仍是測試版：若要在正式環境傳送訊息，請準備完整的 Cloud API 整合。

</div>

這個伺服器在公布消息三天後，你現在就能用一條指令開始使用並透過 Meta 登入，接著請代理程式列出你的商家。之後可依需求設定電話號碼、範本、Webhook 和測試訊息。

其他將代理程式連接至外部系統的方法，請參閱[Claude Code 的 MCP 伺服器](https://ailoot.ai/blog/zh-hant-tw/mcp-servers-claude-code/)合輯——其中還有七種可用於不同工作的整合方式。

<div class="section" role="doc-bibliography" aria-label="來源">

### 來源

- [Meta for Developers：宣布推出 WhatsApp Business Tools MCP（15.09.2026）](https://developers.facebook.com/blog/post/2026/09/15/whatsapp-business-messaging-mcp-ai-agent/)
- [Meta：WhatsApp Business Tools MCP 文件](https://developers.facebook.com/documentation/mcp/whatsapp-business-tools-mcp)
- [Meta：開發者 MCP 伺服器概覽](https://developers.facebook.com/documentation/mcp)
- [WhatsApp Business Platform：文件](https://developers.facebook.com/documentation/business-messaging/whatsapp)

</div>



認識 [Ailoot](https://ailoot.ai/)。

## 常見問題：WhatsApp Business Tools MCP：如何將 WhatsApp Business 連接至 AI 代理程式

### 第一次連線，最安全的檢查是什麼？

OAuth 登入後，先看工具清單並讀取能管理的企業。先證實存取，再新增電話、建立範本、設定 webhook 或傳測試訊息。

### 設定 webhook 就等於建立訊息處理功能嗎？

不是。MCP server 設定回呼與訂閱，你仍需另外建立在該地址接收、處理訊息的 CRM、客服服務或機器人。


## Ailoot · 公司及其專案組合

Ailoot以累積的營運經驗、廣大的客戶群、穩定的服務及持續的KPI管理為基礎。

公司及其專案組合：數百萬客戶，每月銷售額達數十億。

Ailoot將這些營運經驗用於API存取，讓客戶的產品、代理、應用程式及自動化流程使用AI功能。
