Bina bot WhatsApp dengan Claude Code atau Codex, pada nombor yang anda simpan dalam aplikasi
Tambah pelayan MCP WhatsApp ke Claude Code atau Codex dan biarkan ejen pengekodan melakukan persediaan: ia membaca kelayakan Cloud API nombor tersebut, membina penerima webhook, menghala mesej masuk kepadanya dan menghantar balasan ujian kepada seseorang yang menulis dalam 24 jam terakhir. Apa yang anda perolehi ialah ejen anda sendiri, berjalan sebagai kod anda di pelayan anda.
easyCoexistence menyambungkan nombor WhatsApp Business yang anda simpan dalam aplikasi ke Cloud API Meta melalui Coexistence dan memberi Claude Code dan Codex lebih 30 alat MCP untuk dibina: kelayakan, penghalaan, templat, hantaran ujian dan automasi.
Bendera Claude Code yang memuatkan pelayan dalam semua projek anda; skop tempatan lalai hanya memuatkannya di tempat ia ditambah.
Arahan Codex yang menyimpan log masuk OAuth bagi pelayan; tanpa kelayakan, Codex boleh bersambung tanpa pengesahan.
Apa yang mesti digunakan oleh destinasi webhook terus, dan ia mesti mengembalikan semula hub.challenge dalam pengendalian GET Meta.
Berapa lama langkah Panggil webhook saya menunggu "reply" daripada endpoint anda sebelum langkah itu gagal.
Tetingkap khidmat pelanggan selepas mesej terakhir pengguna; di luarnya, Meta hanya menerima mesej templat.
Throughput tetap bagi nombor yang digunakan dengan aplikasi WhatsApp Business dan Cloud API.
Apakah yang diperlukan oleh ejen pengekodan untuk membina ejen WhatsApp?
Empat perkara. Nombor WhatsApp Business yang disambungkan ke Cloud API Meta melalui Coexistence, supaya aplikasi kekal di telefon manakala kod boleh menghantar dan menerima. Sambungan MCP dari Claude Code atau Codex ke nombor itu, yang membolehkan ejen pengekodan membaca kelayakan, menukar penghalaan dan menghantar mesej ujian tanpa anda membuka dashboard. Alamat HTTPS awam untuk penerima, daripada hos tempat anda menggunakan atau terowong semasa anda membangun. Dan kunci model untuk ejen yang anda bina.
Asingkan dua ejen dalam fikiran anda. Claude Code atau Codex ialah pembina: ia hanya bertindak semasa anda bekerja dengannya dalam terminal. Program yang ditulisnya ialah yang menjawab pelanggan, dan ia terus berjalan selepas anda menutup sesi.
Bagaimana anda menambah alat WhatsApp ke Claude Code dan Codex?
Setiap satu mengambil satu URL daripada terminal dan log masuk dengan OAuth, jadi tiada kunci disimpan dalam fail. Dalam Claude Code, tambah pelayan dengan --scope user supaya ia dimuatkan dalam setiap projek, kemudian mulakan claude, jalankan /mcp, pilih easycoexistence dan log masuk dalam pelayar. Dalam Codex, tambah pelayan dan jalankan codex mcp login, yang menyimpan log masuk itu; codex mcp list menunjukkan apa yang dikonfigurasi. Codex menyimpan entri dalam ~/.codex/config.toml, yang turut dibaca oleh aplikasi desktop ChatGPT dan sambungan Codex IDE.
Semak sama ada ia berfungsi dengan meminta sesuatu yang hanya alat boleh jawab, seperti "senaraikan nombor WhatsApp saya". Ejen memanggil list_numbers dan mendapat connection_id bagi setiap nombor, yang digunakan oleh setiap alat lain.
# 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 listLaluan manakah yang perlu dibina oleh ejen?
Tiga laluan membawa mesej pelanggan ke kod anda, dan ia berbeza dari segi jumlah kerja yang perlu dikendalikan oleh kod. Untuk versi pertama, langkah Panggil webhook saya ialah yang paling ringkas: easyCoexistence melangkau pendua, berundur apabila anda menjawab dari telefon dan menyemak tetingkap 24 jam sebelum endpoint anda dipanggil, jadi kod anda hanya menulis balasan. Beralih kepada Forward URL atau destinasi terus apabila ejen perlu setiap peristiwa, bukan hanya mesej yang dipilih oleh automasi.
Apa yang perlu anda minta daripada ejen pengekodan?
Berikan laluan, bahasa dan peraturan di awal, dan minta pelan sebelum ia menulis kod. Beritahunya panggilan alat yang boleh dibuatnya sendiri: membaca kelayakan dan dokumen tidak membahayakan, manakala menukar ke mana mesej pergi menjejaskan nombor yang sedang aktif. get_docs memulangkan dokumentasi easyCoexistence, termasuk cara penerima mengesahkan penghantaran, supaya ejen dapat membaca peraturan dan bukan meneka. Permintaan seperti ini menghasilkan penerima yang boleh anda semak dalam satu sesi:
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.Bagaimana anda menyambung penerima dan mengujinya?
Mulakan pelayan di lokasi yang boleh dicapai oleh Meta dan easyCoexistence melalui HTTPS, kemudian biarkan ejen melakukan penghalaan. Untuk laluan Forward URL, ia memanggil set_inbound_mode dengan URL anda pada nombor dalam Automasi mod On; rahsia forward dipulangkan sekali sahaja, dan ejen menulisnya ke .env anda. Untuk laluan terus, endpoint mesti menjawab pengendalian GET Meta dahulu, kemudian ejen memanggil set_webhook_destination dengan URL, rahsia rawak yang panjang dalam laluannya, dan verify token anda.
Untuk menguji, hantar mesej ke nombor perniagaan dari telefon anda sendiri dan perhatikan log: penerima sepatutnya melihat peristiwa itu, model sepatutnya menjawab, dan balasan sepatutnya muncul dalam sembang. Kerana anda baru menulis, tetingkap 24 jam masih terbuka, jadi ejen pengekodan juga boleh mencuba send_message ke nombor anda sendiri.
Adakah ejen siap masih memerlukan pelayan MCP?
Tidak. Pelayan MCP ialah alat pembina, dilog masuk sebagai anda. Ejen yang anda gunakan menghantar melalui Graph API Meta dengan send_endpoint dan access_token yang dipulangkan oleh get_api_credentials, iaitu token milik perniagaan itu sendiri yang dihadkan kepada aset WhatsApp perniagaan tersebut, dan ia menerima melalui laluan yang anda sediakan. Jika access_token dipulangkan sebagai null, menyambung semula nombor dari dashboard akan mengeluarkan satu token tanpa menggantikan token yang sudah berfungsi.
Simpan sambungan MCP untuk kerja di sekeliling ejen: mencipta templat dengan create_template, memeriksa get_number_health apabila ada sesuatu yang kelihatan tidak kena, dan membaca log larian mana-mana automasi yang menyerahkan mesej kepada kod anda.
Cara menetapkannya
- 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.
Kesilapan biasa
- Menyimpan terowong sementara sebagai destinasi terus dalam 24 jam pertama. Import kenalan sekali sahaja oleh Meta dan sehingga 6 bulan sembang dihantar ke URL itu dan hilang apabila terowong ditutup.
- Menetapkan destinasi terus pada nombor yang menjalankan automasi. Nombor itu bertukar kepada terus dan automasinya berhenti; gunakan Forward URL dalam Automasi mod On untuk mengekalkan kedua-duanya.
- Melakukan commit pada .env yang ditulis oleh ejen. Tambahkannya ke .gitignore dahulu, kerana sesiapa yang memegang access token boleh menghantar mesej kepada pelanggan sebagai perniagaan itu.
- Menguji send_message pada kenalan yang belum menulis dalam 24 jam. Meta menolak teks bebas di luar tetingkap, jadi hantar mesej ke nombor itu dari telefon anda sendiri dahulu.
Ejen anda kemudian berjalan di pelayan anda sendiri, dan setiap nombor dipantau 24/7 dengan amaran. Daripada US$ 9 turun kepada US$ 0.75 setiap nombor sebulan, menurun apabila anda menambah nombor, termasuk percubaan percuma 3 hari.
Soalan lazim
Adakah ini berfungsi dalam Cursor atau alat pengekodan lain?
Ya. Mana-mana klien MCP yang bersambung ke pelayan jauh melalui Streamable HTTP dengan OAuth boleh menggunakan URL yang sama, termasuk Cursor, VS Code, Gemini CLI dan Antigravity. Hanya format konfigurasi yang berubah dari satu klien ke klien yang lain.
Bahasa apakah yang perlu ditulis oleh ejen?
Mana-mana bahasa yang boleh melayani HTTPS dan mengira HMAC-SHA256. Node.js dan Python ialah pilihan biasa, dan sampel yang diuji untuk kedua-duanya, dengan semakan tandatangan, pengendalian pendua dan jeda telefon, terdapat pada halaman ejen Node.js dan Python.
Adakah saya memerlukan aplikasi Meta sendiri atau App Review?
Tidak. Nombor itu menyertai Cloud API melalui aplikasi Meta easyCoexistence dan kekal dalam portfolio perniagaan itu sendiri. Token yang dihantar oleh kod anda ialah milik perniagaan itu, jadi tiada aplikasi Meta milik anda terlibat.
Bolehkah ejen pengekodan mencipta templat yang diperlukan oleh ejen?
Ya, dengan create_template, kemudian get_template_status sehingga Meta memberi jawapan, biasanya dalam beberapa minit dan paling lama kira-kira 24 jam. Ejen anda memerlukan templat yang diluluskan untuk memulakan perbualan atau untuk menulis selepas tetingkap 24 jam tamat.
Teruskan membaca
Sedia untuk bermula?
Sediakan WhatsApp Coexistence dalam beberapa minit, bukan berbulan-bulan. Aplikasi terus berfungsi pada telefon.
Mulakan Percubaan PercumaDisahkan pada