MasukMulai uji coba gratis
Meta Tech Provider

Bangun bot WhatsApp dengan Claude Code atau Codex, di nomor yang Anda simpan di aplikasi

Tambahkan server MCP WhatsApp ke Claude Code atau Codex dan biarkan agen coding mengerjakan penyiapannya: ia membaca kredensial Cloud API nomor tersebut, menyiapkan kerangka receiver webhook, mengarahkan pesan masuk ke sana, dan mengirim balasan uji ke seseorang yang menulis dalam 24 jam terakhir. Yang Anda dapatkan adalah agen Anda sendiri, berjalan sebagai kode Anda di server Anda.

easyCoexistence menghubungkan nomor WhatsApp Business yang Anda simpan di aplikasi ke Cloud API Meta melalui Coexistence, dan memberi Claude Code dan Codex lebih dari 30 alat MCP untuk membangun: kredensial, perutean, template, pengiriman uji, dan otomatisasi.

--scope user

Flag Claude Code yang memuat server di semua proyek Anda; cakupan lokal default hanya memuatnya di tempat server itu ditambahkan.

codex mcp login

Perintah Codex yang menyimpan proses masuk OAuth sebuah server; tanpa kredensial, Codex dapat terhubung tanpa autentikasi.

HTTPS

Yang wajib dipakai tujuan webhook langsung, dan tujuan itu harus membalas dengan hub.challenge dalam handshake GET Meta.

20 seconds

Berapa lama langkah Call my webhook menunggu {"reply"} dari endpoint Anda sebelum langkah itu gagal.

24 hours

Jendela layanan pelanggan setelah pesan terakhir pengguna; di luarnya, Meta hanya menerima pesan template.

20 msg/s

Throughput tetap dari nomor yang dipakai bersama aplikasi WhatsApp Business dan Cloud API.

Apa yang dibutuhkan agen coding untuk membangun agen WhatsApp?

Ada empat hal. Nomor WhatsApp Business yang terhubung ke Cloud API Meta melalui Coexistence, sehingga aplikasi tetap di ponsel sementara kode dapat mengirim dan menerima. Koneksi MCP dari Claude Code atau Codex ke nomor itu, yang memungkinkan agen coding membaca kredensial, mengubah perutean, dan mengirim pesan uji tanpa Anda membuka dashboard. Alamat HTTPS publik untuk receiver, dari host tempat Anda melakukan deploy atau tunnel selama pengembangan. Dan kunci API model untuk agen yang sedang Anda bangun.

Bedakan kedua agen ini. Claude Code atau Codex adalah pembangunnya: ia bekerja hanya saat Anda bekerja dengannya di terminal. Program yang ditulisnya adalah yang menjawab pelanggan, dan program itu terus berjalan setelah Anda menutup sesi.

Bagaimana cara menambahkan alat WhatsApp ke Claude Code dan Codex?

Keduanya cukup memakai satu URL dari terminal dan masuk dengan OAuth, sehingga tidak ada kunci yang masuk ke dalam file. Di Claude Code, tambahkan server dengan --scope user agar dimuat di setiap proyek, lalu jalankan claude, jalankan /mcp, pilih easycoexistence, dan masuk di browser. Di Codex, tambahkan server dan jalankan codex mcp login, yang menyimpan proses masuk; codex mcp list menampilkan apa yang sudah dikonfigurasi. Codex menyimpan entri di ~/.codex/config.toml, yang juga dibaca aplikasi desktop ChatGPT dan ekstensi Codex IDE.

Pastikan berhasil dengan meminta sesuatu yang hanya bisa dijawab oleh alat, misalnya "tampilkan nomor WhatsApp saya". Agen memanggil list_numbers dan mendapatkan connection_id setiap nomor, yang dipakai oleh setiap alat lainnya.

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

Rute mana yang sebaiknya dibangun agen?

Tiga rute membawa pesan pelanggan ke kode Anda, dan perbedaannya ada pada seberapa banyak yang harus ditangani kode Anda. Untuk versi pertama, langkah Call my webhook adalah yang paling singkat: easyCoexistence melewati duplikat, memberi jeda saat Anda membalas dari ponsel, dan memeriksa jendela 24 jam sebelum endpoint Anda dipanggil, sehingga kode Anda hanya menulis balasan. Beralihlah ke Forward URL atau tujuan langsung ketika agen membutuhkan setiap event, bukan hanya pesan yang dipilih otomatisasi.

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

Apa yang sebaiknya Anda minta dari agen coding?

Berikan rute, bahasa, dan aturan di awal, lalu minta rencana sebelum ia menulis kode. Beri tahu panggilan alat mana yang boleh ia lakukan sendiri: membaca kredensial dan dokumen tidak berbahaya, sedangkan mengubah tujuan pesan memengaruhi nomor yang sedang aktif. get_docs mengembalikan dokumentasi easyCoexistence, termasuk cara receiver mengautentikasi pengiriman, sehingga agen dapat membaca aturannya alih-alih menebaknya. Permintaan seperti ini menghasilkan receiver yang dapat Anda tinjau dalam satu sesi:

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.

Bagaimana cara menghubungkan receiver dan mengujinya?

Jalankan server di tempat yang dapat dijangkau Meta dan easyCoexistence melalui HTTPS, lalu biarkan agen mengatur perutean. Untuk rute Forward URL, agen memanggil set_inbound_mode dengan URL Anda pada nomor di Automations dalam mode on; forward secret dikembalikan sekali saja, dan agen menulisnya ke .env Anda. Untuk rute langsung, endpoint harus menjawab handshake GET Meta terlebih dahulu, kemudian agen memanggil set_webhook_destination dengan URL, secret acak yang panjang di path-nya, dan verify token Anda.

Untuk menguji, kirim pesan ke nomor bisnis dari ponsel Anda sendiri dan pantau log: receiver harus menerima event, model harus menjawab, dan balasan harus muncul di chat. Karena Anda baru saja menulis, jendela 24 jam masih terbuka, sehingga agen coding juga dapat mencoba send_message ke nomor Anda sendiri.

Apakah agen yang sudah jadi masih membutuhkan server MCP?

Tidak. Server MCP adalah alat pembangun, yang masuk sebagai Anda. Agen yang Anda deploy mengirim melalui Graph API Meta dengan send_endpoint dan access_token yang dikembalikan get_api_credentials, yaitu token milik bisnis itu sendiri yang dibatasi pada aset WhatsApp-nya, dan ia menerima melalui rute yang Anda atur. Jika access_token kembali sebagai null, menghubungkan ulang nomor dari dashboard akan menerbitkannya tanpa mengganti token yang sudah berfungsi.

Pertahankan koneksi MCP untuk pekerjaan di sekitar agen: membuat template dengan create_template, memeriksa get_number_health saat ada yang terlihat tidak beres, dan membaca log eksekusi dari otomatisasi apa pun yang menyerahkan pesan ke kode Anda.

Cara mengonfigurasi

  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.

Kesalahan umum

  • Menyimpan tunnel sementara sebagai tujuan langsung dalam 24 jam pertama. Impor kontak satu kali dan hingga 6 bulan chat dari Meta dikirim ke URL itu, lalu hilang saat tunnel ditutup.
  • Mengatur tujuan langsung pada nomor yang menjalankan otomatisasi. Nomor beralih ke mode direct dan otomatisasinya berhenti; gunakan Forward URL dalam Automations pada mode on untuk menjaga keduanya.
  • Melakukan commit .env yang ditulis agen. Tambahkan ke .gitignore terlebih dahulu, karena siapa pun yang memegang access token dapat mengirim pesan ke pelanggan atas nama bisnis.
  • Menguji send_message pada kontak yang belum menulis dalam 24 jam. Meta menolak teks bebas di luar jendela, jadi kirim pesan ke nomor itu dari ponsel Anda terlebih dahulu.
Melakukan ini dengan EasyCoexistence

Agen Anda kemudian berjalan di server Anda sendiri, dan setiap nomor dipantau 24/7 dengan peringatan. US$ 9 turun hingga US$ 0.75 per nomor per bulan, menurun seiring Anda menambah nomor, dengan 3 hari pertama gratis.

Pertanyaan yang sering diajukan

Apakah ini bisa dipakai di Cursor atau alat coding lainnya?

Ya. Klien MCP apa pun yang terhubung ke server jarak jauh melalui Streamable HTTP dengan OAuth dapat menggunakan URL yang sama, termasuk Cursor, VS Code, Gemini CLI, dan Antigravity. Yang berubah dari satu klien ke klien lain hanyalah format konfigurasinya.

Bahasa apa yang sebaiknya ditulis agen?

Bahasa apa pun yang dapat melayani HTTPS dan menghitung HMAC-SHA256. Node.js dan Python adalah pilihan umum, dan contoh yang sudah diuji untuk keduanya, dengan pemeriksaan tanda tangan, penanganan duplikat, dan jeda saat ponsel dipakai, ada di halaman agen Node.js dan Python.

Apakah saya membutuhkan aplikasi Meta sendiri atau App Review?

Tidak. Nomor bergabung ke Cloud API melalui aplikasi Meta milik easyCoexistence dan tetap berada di Business Portfolio bisnis itu sendiri. Token yang dikirim kode Anda adalah milik bisnis tersebut, jadi tidak ada aplikasi Meta milik Anda yang terlibat.

Dapatkah agen coding membuat template yang dibutuhkan agen?

Bisa, dengan create_template, lalu get_template_status hingga Meta menjawab, biasanya dalam hitungan menit dan paling lama sekitar 24 jam. Agen Anda membutuhkan template yang disetujui untuk memulai percakapan atau untuk menulis setelah jendela 24 jam tertutup.

Lanjut membaca

Siap memulai?

Konfigurasikan WhatsApp Coexistence dalam hitungan menit, bukan bulan. Aplikasi tetap berfungsi di ponsel.

Mulai uji coba gratis

Diverifikasi pada