Claude Code または Codex で WhatsApp ボットを作る:アプリで使っている番号のまま
Claude Code または Codex に WhatsApp の MCP サーバーを追加すると、コーディングエージェントがセットアップを行います。エージェントは番号の Cloud API 認証情報を読み取り、Webhook 受信側を作成して、受信メッセージをそこへ振り分け、直近 24 時間以内にメッセージを送ってきた相手にテスト返信を送ります。最終的に得られるのは、お使いのサーバーで動く独自のエージェントで、その実体はお客様自身のコードです。
EasyCoexistence は、アプリで使っている WhatsApp Business の番号を、Coexistence を通じて Meta の Cloud API に接続し、Claude Code と Codex に、構築用の 30 を超える MCP ツールを提供します。
すべてのプロジェクトでサーバーを読み込む Claude Code のフラグです。デフォルトの local スコープは、追加したプロジェクトでのみ読み込みます。
サーバーの OAuth サインインを保存する Codex のコマンドです。認証情報がない場合、Codex は認証なしで接続できます。
直接の Webhook 宛先が満たすべき要件。Meta の GET ハンドシェイクでは、hub.challenge をそのまま返す必要があります。
「Call my webhook」ステップが、エンドポイントの {"reply"} を待つ時間。その後ステップは失敗します。
ユーザーの最後のメッセージから続くカスタマーサービスウィンドウ。その外では、Meta はメッセージテンプレートしか受け付けません。
WhatsApp Business アプリと Cloud API の両方で使われる番号の、固定のスループット。
コーディングエージェントが WhatsApp エージェントを作るには何が必要ですか?
四つ必要です。Coexistence で Meta の Cloud API に接続された WhatsApp Business の番号。アプリは電話に残したまま、コードから送受信できます。Claude Code または Codex から、その番号への MCP 接続。これにより、コーディングエージェントはダッシュボードを開かなくても、認証情報の読み取り、振り分けの変更、テストメッセージの送信を行えます。受信側のための公開 HTTPS アドレス。デプロイ先のホストか、開発中はトンネルを使います。そして、作成するエージェントのためのモデルキーです。
二つのエージェントを混同しないようにしてください。Claude Code または Codex は作成者で、ターミナルで作業している間だけ動きます。作成されたプログラムがお客様のお問い合わせに応答するもので、セッションを閉じた後も動き続けます。
Claude Code と Codex に WhatsApp のツールを追加するには?
どちらも、ターミナルで URL を 1 つ指定し、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 を受け取ります。ほかのすべてのツールがこの connection_id を使います。
# 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エージェントはどの経路を作るべきですか?
お客様のメッセージをコードに届ける経路は三つあり、コードが処理すべき内容の量がそれぞれ異なります。最初のバージョンには、「Call my webhook」ステップが最も簡単です。EasyCoexistence が重複を除き、電話から返信すると一時停止し、エンドポイントを呼び出す前に 24 時間ウィンドウを確認するため、コードは返信を書くだけで済みます。エージェントがオートメーションで選んだメッセージだけでなく、すべてのイベントを必要とするようになったら、Forward URL または直接の宛先へ移行してください。
コーディングエージェントに何を頼めばよいですか?
経路、言語、ルールを最初に伝え、コードを書く前に計画を出させてください。エージェントが単独で行ってよいツール呼び出しも指定してください。認証情報やドキュメントの読み取りは問題ありませんが、メッセージの送り先を変更すると、稼働中の番号に影響します。get_docs は EasyCoexistence のドキュメントを返します。受信側がどのように配信を認証するかも含まれるため、エージェントは推測ではなくルールを読んで判断できます。次のような依頼により、一度に確認できる受信側が出来上がります:
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 の経路では、エージェントが Automations の on mode に設定された番号で set_inbound_mode を呼び出し、URL を渡します。Forward secret は一度だけ返されるので、エージェントはそれを .env に書き込みます。直接の経路では、まずエンドポイントが Meta の GET ハンドシェイクに応答する必要があります。その後、エージェントは URL と、パスに長いランダムな secret を含む URL、そして verify token を指定して set_webhook_destination を呼び出します。
テストするには、お使いの電話から WhatsApp Business の番号にメッセージを送り、ログを確認してください。受信側がイベントを受け取り、モデルが応答し、返信がチャットに表示されるはずです。ちょうど書き込んだばかりなので 24 時間ウィンドウは開いており、コーディングエージェントは、ご自身の番号に対して send_message を試すこともできます。
完成したエージェントに MCP サーバーはまだ必要ですか?
いいえ。MCP サーバーは、あなたとしてサインインした作成者のためのツールです。デプロイするエージェントは、get_api_credentials が返した send_endpoint と access_token を使い、Meta の Graph API 経由で送信します。このトークンはビジネス自身のもので、そのビジネスの WhatsApp アセットに限定されています。受信は、設定した経路で行われます。access_token が null で返された場合は、ダッシュボードから番号を接続し直すと、動作しているトークンを置き換えずに新しいトークンが発行されます。
エージェントの周辺の作業では MCP 接続を維持してください。たとえば create_template でのテンプレート作成、問題が見えたときの get_number_health の確認、メッセージをお使いのコードに渡すオートメーションの実行ログの確認です。
設定方法
- Connect your numberAt easycoexistence.com, run Meta's Embedded Signup and scan the code with the WhatsApp Business app; the app keeps its chats.
- 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.
- 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.
- Expose the receiver over HTTPSDeploy it, or run a tunnel while developing, and confirm the URL answers from outside your machine.
- Route the messagesLet the agent call set_inbound_mode with a Forward URL, or set_webhook_destination for the direct route, once you approve.
- 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 に送られ、トンネルを閉じると失われます。
- オートメーションを実行している番号に直接の宛先を設定すること。番号は直接モードに切り替わり、そのオートメーションは停止します。両方を維持するには、Automations の on mode で Forward URL を使ってください。
- エージェントが書き込んだ .env をコミットすること。先に .gitignore に追加してください。アクセストークンを持つ人は誰でも、そのビジネスとして顧客にメッセージを送れてしまうためです。
- 24 時間以内に書き込みがないまだ連絡先に対して send_message をテストすること。Meta はウィンドウ外のフリーテキストを拒否するため、先に自分の電話からその番号宛にメッセージを送ってください。
認証情報、振り分け、メッセージテンプレート、テスト送信、オートメーションなどです。エージェントはお使いのサーバーで動作し、接続された番号は 24 時間監視され、アラート通知が届きます。料金は番号 1 件あたり月額 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 で作成し、Meta から回答があるまで get_template_status で確認します。通常は数分以内、長くとも約 24 時間以内です。エージェントが会話を始める場合や、24 時間ウィンドウを過ぎてから送信する場合は、承認済みのメッセージテンプレートが必要です。
続きを読む
始める準備はできましたか?
WhatsApp Coexistence の設定は数分で完了し、数か月もかかりません。スマートフォン上のアプリも引き続き使えます。
無料トライアルを始める確認日