登入開始免費試用
Meta Tech Provider

用 Claude Code 或 Codex 建立 WhatsApp 機械人,沿用你保留在應用程式中的號碼

在 Claude Code 或 Codex 中加入 WhatsApp MCP 伺服器,讓編程代理完成設定:它會讀取號碼的 Cloud API 憑證、搭建 Webhook 接收端、把收到的訊息路由到接收端,並向過去 24 小時內曾發訊息的人發送測試回覆。你最終得到的是你自己的代理,以你的程式碼運行於你自己的伺服器上。

easyCoexistence 透過 Coexistence 把你保留在應用程式中的 WhatsApp Business 號碼連接至 Meta 的 Cloud API,並讓 Claude Code 與 Codex 擁有超過 30 個 MCP 工具可用於建立:憑證、路由、範本、測試發送與自動化。

--scope user

Claude Code 的參數,可讓伺服器在你所有項目中載入;預設的本地範圍只會在添加該伺服器的項目中載入。

codex mcp login

Codex 指令,用於儲存伺服器的 OAuth 登入資料;若沒有憑證,Codex 可在不經驗證的情況下連接。

HTTPS

直接 Webhook 目的地須使用的內容,以及在 Meta 的 GET 握手中必須回傳 hub.challenge。

20 seconds

「呼叫我的 Webhook」步驟等待你的端點回傳 {"reply"} 的時間長度,逾時則該步驟失敗。

24 hours

用戶最後一則訊息之後的客戶服務窗口;窗口以外,Meta 只接受訊息範本。

20 msg/s

同時使用 WhatsApp Business 應用程式與 Cloud API 的號碼,其吞吐量是固定的。

編程代理要建立 WhatsApp 代理,需要什麼?

需要四樣東西。第一,一個透過 Coexistence 連接到 Meta 的 Cloud API 的 WhatsApp Business 號碼,讓應用程式留在手機上,同時程式碼可以收發訊息。第二,一條從 Claude Code 或 Codex 連接到該號碼的 MCP 連線,讓編程代理無需你打開控制台,就能讀取憑證、更改路由並發送測試訊息。第三,供接收端使用的公開 HTTPS 地址,來自你部署所在的主機,或在開發時使用隧道。第四,你正在建立的代理所用的模型金鑰。

請在腦海中把兩個代理分清楚。Claude Code 或 Codex 是建造者:它只在你於終端機與它合作時才會行動。它所編寫的程式才是回覆客戶的那個,而且在你關閉工作階段後仍會持續運行。

如何把 WhatsApp 工具加入 Claude Code 和 Codex?

兩者都只需在終端機輸入一個 URL,並透過 OAuth 登入,因此不會有任何金鑰寫入檔案。在 Claude Code 中,使用 --scope user 加入伺服器,讓它在每個項目中都會載入;然後啟動 claude,執行 /mcp,選取 easycoexistence,並在瀏覽器中完成登入。在 Codex 中,加入伺服器後執行 codex mcp login,此指令會儲存登入資料;codex mcp list 會顯示已設定的內容。Codex 將設定保存在 ~/.codex/config.toml,ChatGPT 桌面應用程式與 Codex IDE 擴充功能也會讀取該檔案。

請問一個只有工具才能回答的問題,以確認設定成功,例如「列出我的 WhatsApp 號碼」。代理會呼叫 list_numbers,並取得每個號碼的 connection_id,其他所有工具都會以它作為參數。

Add the server, then sign in
# Claude Code: then start claude and run /mcp to sign in
claude mcp add --transport http easycoexistence --scope user https://easycoexistence.com/api/mcp

# Codex: add, store the OAuth sign-in, check
codex mcp add easycoexistence --url https://easycoexistence.com/api/mcp
codex mcp login easycoexistence
codex mcp list

代理應採用哪一種路由?

有三種路由可把客戶的訊息送到你的程式,它們的差別在於程式需要處理的工作量。對於第一個版本,「呼叫我的 Webhook」步驟最簡單:easyCoexistence 會略過重複項目、在你從手機回覆時自動暫停,並在呼叫你的端點之前檢查 24 小時窗口,因此你的程式只需撰寫回覆。當代理需要所有事件,而不只是自動化篩選出的訊息時,再改用 Forward URL 或直接目的地。

Call my webhook stepAn automation POSTs the message and the chat's last 10 messages, signed; return {"reply": "..."} within 20 seconds
Forward URL (Automations on)A signed copy of each Meta event goes to your code; automations keep running; you send through the Graph API
Direct destinationMeta posts straight to your endpoint; easyCoexistence never sees the messages; automations stop for that number

你應請編程代理做什麼?

先把路由、語言與規則全部交代清楚,並要求它在寫程式之前先提出計劃。告訴它哪些工具呼叫可以自行執行:讀取憑證和文件是無害的,但更改訊息的去向會影響正在運作的號碼。get_docs 會回傳 easyCoexistence 的文件,包括接收端如何驗證傳遞,因此代理可以閱讀規則,而非憑空猜測。像這樣的請求會產生一個可在一次審閱中完成檢查的接收端:

A request for Claude Code or Codex
Build a WhatsApp agent in Node.js for my number +55 11 4000 1234.
1. Call list_numbers, then get_api_credentials for that number.
   Put send_endpoint and access_token in .env, never in code.
2. Scaffold an HTTPS server with POST /wa/<long random path>.
   Verify X-EC-Signature (HMAC-SHA256 of "<t>.<raw body>").
   Skip message ids already handled.
   On smb_message_echoes, stay quiet on that chat for 4 hours.
3. Reply with my model only within 24 hours of the
   customer's last message.
4. Write tests for the signature check and the 24-hour rule.
Do not call set_inbound_mode or set_webhook_destination
until I say so.

如何連接接收端並進行測試?

先在 Meta 與 easyCoexistence 都能透過 HTTPS 存取的位置啟動伺服器,然後讓代理完成路由設定。若使用 Forward URL 路由,代理會在處於 on 模式的自動化號碼上,以你的 URL 呼叫 set_inbound_mode;轉發密鑰只會回傳一次,代理會把它寫入你的 .env。若使用直接路由,端點必須先回應 Meta 的 GET 握手,然後代理以 URL、路徑中一段很長的隨機密鑰,以及你的驗證權杖呼叫 set_webhook_destination。

測試時,請用自己的手機向商業號碼發送訊息,並觀察日誌:接收端應看到該事件,模型應作出回覆,而回覆應出現在對話中。由於你剛剛發過訊息,24 小時窗口仍然開啟,因此編程代理也可以嘗試用 send_message 發送到你自己的號碼。

完成的代理仍需要 MCP 伺服器嗎?

不需要。MCP 伺服器是建造者的工具,以你的身份登入。你部署的代理透過 Meta 的 Graph API 發送,使用 get_api_credentials 回傳的 send_endpoint 與 access_token,即商業自身的權杖,範圍僅限該商業的 WhatsApp 資產;接收則透過你設定的路由。如果 access_token 回傳為 null,從控制台重新連接該號碼即可發出一個新權杖,而不會取代仍可正常運作的現有權杖。

請保留 MCP 連線,用於代理周邊的工作:用 create_template 建立範本,當出現問題時用 get_number_health 檢查號碼健康狀況,並閱讀任何把訊息交給你程式的自動化之運行紀錄。

設定方法

  1. Connect your numberAt easycoexistence.com, run Meta's Embedded Signup and scan the code with the WhatsApp Business app; the app keeps its chats.
  2. Add the server to your coding agentRun the claude mcp add or codex mcp add command, then sign in with /mcp in Claude Code or codex mcp login in Codex.
  3. Ask for credentials and a planHave the agent call list_numbers and get_api_credentials, store the values in .env and propose the receiver before writing it.
  4. Expose the receiver over HTTPSDeploy it, or run a tunnel while developing, and confirm the URL answers from outside your machine.
  5. Route the messagesLet the agent call set_inbound_mode with a Forward URL, or set_webhook_destination for the direct route, once you approve.
  6. Test from your phoneSend the business number a message and check that your agent's reply arrives in the same chat.

常見錯誤

  • 在最初 24 小時內,把一次性的隧道儲存為直接目的地。Meta 一次性匯入的聯絡人與最多 6 個月的對話會發送到該 URL,隧道關閉後即會遺失。
  • 在運行自動化的號碼上設定直接目的地。該號碼會切換為直接模式,其自動化隨即停止;請在自動化的 on 模式中使用 Forward URL,即可兩者兼顧。
  • 把代理寫入的 .env 提交到版本庫。請先將其加入 .gitignore,因為任何持有存取權杖的人,都能以該商業的身份向客戶發送訊息。
  • 對 24 小時內未曾發訊息的聯絡人測試 send_message。窗口以外,Meta 會拒絕自由格式訊息,因此請先用自己的手機向號碼發送訊息。
使用 EasyCoexistence 完成這項設定

你的代理隨後運行於你自己的伺服器上,每個號碼均獲 24/7 監察並附警報。每個號碼每月由 US$ 9 降至 US$ 0.75,號碼越多越便宜,首 3 天免費。

常見問題

這能在 Cursor 或其他編程工具中使用嗎?

可以。任何透過 OAuth 以 Streamable HTTP 連接遠端伺服器的 MCP 客戶端,都能使用同一個 URL,包括 Cursor、VS Code、Gemini CLI 與 Antigravity。改變的只是各客戶端的設定格式。

代理應使用哪種語言編寫?

任何能夠提供 HTTPS 服務並計算 HMAC-SHA256 的語言皆可。Node.js 與 Python 是常見選擇,兩者的已測試範例,包括簽名檢查、重複處理及手機暫停,都可在 Node.js 與 Python 代理頁面找到。

我需要自己的 Meta 應用程式或 App Review 嗎?

不需要。號碼透過 easyCoexistence 的 Meta 應用程式加入 Cloud API,並保留在商業自身的 Business Portfolio 中。你的程式所使用的權杖屬於該商業本身,因此不涉及你自己的 Meta 應用程式。

編程代理能建立代理所需的範本嗎?

可以。先用 create_template 建立範本,然後用 get_template_status 查詢,直到 Meta 作出回覆,通常在幾分鐘內,最長約 24 小時。你的代理需要已獲批准的範本,才能在 24 小時窗口關閉後開啟對話或繼續發送訊息。

繼續閱讀

準備開始嗎?

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

開始免費試用

驗證日期