登入開始免費試用
Meta Tech Provider

MCP 工具參考

連接器涵蓋帳戶內的每個連接,共提供 30 多個工具。WhatsApp 先用 list_numbers,其工具需要從中取得 connection_id;其他頻道先用 list_social_accounts,其工具使用 account_id。欠費時有 6 個工具會受限制:4 個對外執行操作的 WhatsApp 工具、會傳回存取權杖的 get_api_credentials,以及 create_connect_link。其餘工具仍然開放。

30+

連接器公開的工具。

6

欠費時受限制的工具,包括會傳回存取權杖的 get_api_credentials。

1

OAuth 登入,涵蓋帳戶內每個號碼。

每個工具有甚麼作用?

讀取: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 傳回產品文件。

Partner API 適用於讓自家客戶連接號碼的軟件或代理商:get_partner_setup 會顯示收費狀態、API 金鑰、事件 URL 及下一步。create_api_key 會發出 Partner API 金鑰並只顯示一次,未經明確確認不會取代現有金鑰。revoke_api_key 會撤銷金鑰,同樣需要確認。set_partner_events_url 會設定狀態事件的傳送位置,並只傳回一次簽署密鑰。create_connect_link 會為一位客戶建立託管連接連結,有效期 1 小時,與 POST /api/v1/connect-sessions 相同。

為甚麼 connection_id 很重要?

因為它會將指令連繫至指定號碼,而助理無法自行猜出它。

所有對號碼執行操作的工具都需要 connection_id,而 list_numbers 是唯一提供它的地方。實際上,這表示助理收到傳送訊息的要求時,會先呼叫 list_numbers,因此工作階段中的第一個請求通常會比其後請求慢。

這也表示,帳戶有多個號碼時,操作對象仍然明確。系統沒有預設號碼,也不會隱式選擇,因此未指出所涉及號碼的指令會被要求澄清,而不是由系統猜測。

欠費時會發生甚麼事?

6 個工具會受限制:對外執行操作的 send_message、send_template、create_template 及 set_webhook_destination;get_api_credentials,因為它會傳回帳戶的存取權杖,受限制的帳戶可憑此直接透過 Graph API 傳送;以及連接新號碼的 create_connect_link。其他讀取功能仍然可用,Partner API 設定工具亦然:get_partner_setup、create_api_key、revoke_api_key 及 set_partner_events_url。

這是有意的設計,而非疏忽。如果帳戶無法查看受限制的原因,或無法檢查號碼是否健康,便只能提交支援要求。健康監察也依賴這些讀取功能,因此限制它們會在最需要監察時一併關閉監察功能。

實際效果是,欠費帳戶仍可回答有關自身狀態的問題,也會繼續接受監察。停止的是所有接觸客戶的操作。

常見錯誤

  • 以為連接器會接收訊息。MCP 採用請求與回應模式;傳入流量需要 Webhook。
  • 硬編碼 connection_id。它來自 list_numbers,不應手動記錄。
  • 以為欠費帳戶會完全離線。讀取功能及監察會按設計繼續運作,但憑證除外,因為其中包含用於傳送的存取權杖。
使用 EasyCoexistence 完成這項設定

一個連接器涵蓋帳戶內每個號碼,透過 OAuth 授權,無需貼上金鑰。每個號碼每月 US$ 9 起,隨號碼增加降至 US$ 0.75,首 3 天免費。

常見問題

我需要選擇要呼叫哪個工具嗎?

不用。您只需用日常語言提出要求,助理會自行選擇工具,工具說明就是為此而寫。

它可以讀取我的對話嗎?

不可以。傳入訊息會轉送至您指定的 Webhook 目的地。連接器只讀取帳戶及號碼狀態。

get_docs 有用嗎?

比您想像中更有用。它會將我們的文件以 markdown 交給助理,因此有關 Coexistence 規則的答案來自我們的文件,而不是助理憑記憶回答。

一個連接器可以涵蓋多個客戶嗎?

可以。一個帳戶可容納您需要的任意數量號碼,而 list_numbers 會傳回全部號碼。

繼續閱讀

準備開始嗎?

幾分鐘內設定 WhatsApp Coexistence,而非幾個月。應用程式在手機上仍可繼續運作。

開始免費試用

驗證日期