MCP 工具參考
連接器涵蓋帳戶內每個號碼的 11 個工具。list_numbers 排在最前，因為其他工具都需要從中取得 connection_id。4 個工具會對外執行操作，欠費時會受限制；其餘 7 個只讀取資料，仍然開放。
每個工具有甚麼作用？
讀取：list_numbers 會傳回已連接號碼、狀態、品質評分及訊息層級，也是所有其他請求的起點。get_number_health 會一併傳回即時 Meta 快照、近期監察時間線、Webhook 事件及輪詢器檢查結果。get_api_credentials 會傳回 Graph API 基本 URL、WABA id、phone number id，以及在可用時傳回帳戶本身的存取權杖。
傳送：send_message 會在 24 小時時限內傳送自由文字，期間回覆免費。send_template 會傳送已核准的範本，用來與尚未發訊息的人開始對話。list_templates、create_template 及 get_template_status 涵蓋範本生命週期。
連接設定：set_webhook_destination 會將傳入訊息及應用程式回傳訊息轉送至您的系統，傳入 null 則會重設設定。get_connect_link 會傳回控制台連結及連接新號碼的步驟。get_docs 會以 markdown 傳回產品文件。
為甚麼 connection_id 很重要？
因為它會將指令連繫至指定號碼，而助理無法自行猜出它。
所有對號碼執行操作的工具都需要 connection_id，而 list_numbers 是唯一提供它的地方。實際上，這表示助理收到傳送訊息的要求時，會先呼叫 list_numbers，因此工作階段中的第一個請求通常會比其後請求慢。
這也表示，帳戶有多個號碼時，操作對象仍然明確。系統沒有預設號碼，也不會隱式選擇，因此未指出所涉及號碼的指令會被要求澄清，而不是由系統猜測。
欠費時會發生甚麼事？
4 個對外執行操作的工具會受限制：send_message、send_template、create_template 及 set_webhook_destination。所有只讀取資料的工具仍然可用。
這是有意的設計，而非疏忽。如果帳戶無法查看受限制的原因，或無法檢查號碼是否健康，便只能提交支援要求。健康監察也依賴這些讀取功能，因此限制它們會在最需要監察時一併關閉監察功能。
實際效果是，欠費帳戶仍可回答有關自身狀態的問題，也會繼續接受監察。停止的是所有接觸客戶的操作。
常見錯誤
- 以為連接器會接收訊息。MCP 採用請求與回應模式；傳入流量需要 Webhook。
- 硬編碼 connection_id。它來自 list_numbers，不應手動記錄。
- 以為欠費帳戶會完全離線。讀取功能及監察會按設計繼續運作。
一個連接器涵蓋帳戶內每個號碼，透過 OAuth 授權，無需貼上金鑰。每個號碼每月 US$ 9 起，用量大時降至 US$ 2，首 7 天免費。
常見問題
我需要選擇要呼叫哪個工具嗎？
不用。您只需用日常語言提出要求，助理會自行選擇工具，工具說明就是為此而寫。
它可以讀取我的對話嗎？
不可以。傳入訊息會轉送至您指定的 Webhook 目的地。連接器只讀取帳戶及號碼狀態。
get_docs 有用嗎？
比您想像中更有用。它會將我們的文件以 markdown 交給助理，因此有關 Coexistence 規則的答案來自我們的文件，而不是助理憑記憶回答。
一個連接器可以涵蓋多個客戶嗎？
可以。一個帳戶可容納您需要的任意數量號碼，而 list_numbers 會傳回全部號碼。
繼續閱讀
準備開始嗎？
幾分鐘內設定 WhatsApp Coexistence，而非幾個月。應用程式在手機上仍可繼續運作。
開始免費試用驗證日期