Gumawa ng WhatsApp bot gamit ang Claude Code o Codex, sa numerong nasa app ninyo
Idagdag ang WhatsApp MCP server sa Claude Code o Codex at hayaang ang coding agent ang gumawa ng setup: binabasa nito ang Cloud API credentials ng numero, gumagawa ng webhook receiver, idinadaan dito ang mga papasok na mensahe, at nagpapadala ng test reply sa taong nag-message sa loob ng nakaraang 24 oras. Ang kalalabasan ay sarili ninyong agent, na tumatakbo bilang sarili ninyong code sa sarili ninyong server.
Ikinokonekta ng easyCoexistence ang WhatsApp Business number na nasa app ninyo sa Cloud API ng Meta sa pamamagitan ng Coexistence, at binibigyan ang Claude Code at Codex ng higit 30 MCP tools para sa pagbuo: credentials, routing, templates, test send at automations.
Claude Code flag na naglo-load ng server sa lahat ng project ninyo; ang default na local scope ay naglo-load lamang sa project kung saan ito idinagdag.
Codex command na nag-iimbak ng OAuth sign-in ng server; kapag walang credential, puwedeng kumonekta ang Codex nang walang authentication.
Ang dapat gamitin ng direct webhook destination, at dapat nitong ibalik ang hub.challenge sa GET handshake ng Meta.
Gaano katagal maghihintay ang Call my webhook step sa {"reply"} ng endpoint ninyo bago mabigo ang step.
Customer service window pagkatapos ng huling mensahe ng user; sa labas nito, template message lang ang tinatanggap ng Meta.
Nakapirming throughput ng numerong ginagamit sa WhatsApp Business app at Cloud API nang sabay.
Ano ang kailangan ng coding agent para makagawa ng WhatsApp agent?
Apat na bagay. Isang WhatsApp Business number na nakakonekta sa Cloud API ng Meta sa pamamagitan ng Coexistence, kaya nananatili ang app sa telepono habang nakakapagpadala at nakakatanggap ang code. Isang MCP connection mula sa Claude Code o Codex papunta sa numerong iyon, na nagpapahintulot sa coding agent na basahin ang credentials, baguhin ang routing at magpadala ng test message nang hindi binubuksan ang dashboard. Isang pampublikong HTTPS address para sa receiver, mula sa host kung saan kayo mag-deploy o tunnel habang nagde-develop. At isang model key para sa agent na binubuo ninyo.
Panatilihing magkahiwalay sa isip ang dalawang agent. Ang Claude Code o Codex ang tagabuo: kumikilos lamang ito habang nakikipagtrabaho kayo rito sa terminal. Ang programang isinusulat nito ang sasagot sa mga customer, at patuloy itong tatakbo kahit isara ninyo ang session.
Paano idinadagdag ang WhatsApp tools sa Claude Code at Codex?
Bawat isa ay kumukuha ng isang URL mula sa terminal at nag-sa-sign in gamit ang OAuth, kaya walang key na napupunta sa file. Sa Claude Code, idagdag ang server gamit ang --scope user para maglo-load ito sa bawat project, pagkatapos simulan ang claude, patakbuhin ang /mcp, piliin ang easycoexistence at mag-sign in sa browser. Sa Codex, idagdag ang server at patakbuhin ang codex mcp login, na nag-iimbak ng sign-in; ipinapakita ng codex mcp list kung ano ang naka-configure. Itinatago ng Codex ang entry sa ~/.codex/config.toml, na binabasa rin ng ChatGPT desktop app at ng Codex IDE extension.
Para suriin kung gumana, humiling ng bagay na tanging ang tools lang ang makakasagot, gaya ng "list my WhatsApp numbers". Tinatawag ng agent ang list_numbers at kinukuha ang connection_id ng bawat numero, na ginagamit ng lahat ng iba pang tool.
# 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 listAling route ang dapat buuin ng agent?
Tatlong route ang nagdadala ng mensahe ng customer sa code ninyo, at nagkakaiba sila sa dami ng kailangang hawakan ng code. Para sa unang bersyon, ang Call my webhook step ang pinakamaikli: nilalaktawan ng easyCoexistence ang mga duplicate, humihinto kapag sumagot kayo mula sa telepono, at sinusuri ang 24-hour window bago tawagin ang endpoint ninyo, kaya ang code na lang ang sumusulat ng reply. Lumipat sa Forward URL o direct destination kapag kailangan ng agent ang bawat event, hindi lamang ang mga mensaheng pinipili ng automation.
Ano ang dapat ipagawa sa coding agent?
Ibigay sa agent ang route, ang wika, at ang mga patakaran mula sa simula, at humingi ng plano bago ito magsulat ng code. Sabihin kung anong tool calls ang puwede nitong gawin nang mag-isa: ang pagbasa ng credentials at docs ay walang panganib, samantalang ang pagbabago kung saan napupunta ang mga mensahe ay nakakaapekto sa live na numero. Ibinabalik ng get_docs ang dokumentasyon ng easyCoexistence, kasama kung paano nag-a-authenticate ang receiver ng mga delivery, kaya mababasa ng agent ang patakaran sa halip na hulaan ito. Ang ganitong request ay gumagawa ng receiver na masusuri ninyo sa isang upuan lang:
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.Paano ikokonekta ang receiver at susubukan ito?
Simulan ang server kung saan maaabot ito ng Meta at ng easyCoexistence sa HTTPS, saka hayaang ang agent ang gumawa ng routing. Para sa Forward URL route, tinatawag nito ang set_inbound_mode gamit ang URL ninyo sa isang numerong nasa Automations on mode; ibinabalik ang forward secret nang isang beses, at isinusulat ito ng agent sa .env ninyo. Para sa direct route, kailangang sumagot muna ang endpoint sa GET handshake ng Meta, saka tinatawag ng agent ang set_webhook_destination gamit ang URL, isang mahabang random na secret sa path nito, at ang verify token ninyo.
Para subukan, mag-message sa business number mula sa sarili ninyong telepono at bantayan ang logs: dapat makita ng receiver ang event, dapat sumagot ang model, at dapat lumitaw ang reply sa chat. Dahil kakasulat lang ninyo, bukas pa ang 24-hour window, kaya puwede ring subukan ng coding agent ang send_message sa sarili ninyong numero.
Kailangan pa ba ng tapos na agent ang MCP server?
Hindi. Ang MCP server ay tool ng tagabuo, naka-sign in bilang kayo. Ang agent na idedeploy ninyo ay nagpapadala sa pamamagitan ng Graph API ng Meta gamit ang send_endpoint at access_token na ibinalik ng get_api_credentials, ang sariling token ng negosyo na may saklaw sa mga WhatsApp asset nito, at tumatanggap ito sa route na itinakda ninyo. Kung null ang access_token, ang pagkonekta muli ng numero mula sa dashboard ay maglalabas ng isa nang hindi pinapalitan ang token na gumagana na.
Panatilihin ang MCP connection para sa gawaing nakapaligid sa agent: paggawa ng template gamit ang create_template, pagsuri ng get_number_health kapag may mukhang mali, at pagbasa ng run log ng anumang automation na nagpapasa ng mensahe sa code ninyo.
Paano ito i-set up
- 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.
Mga karaniwang pagkakamali
- Pag-save ng pansamantalang tunnel bilang direct destination sa unang 24 oras. Ang isang beses na import ng Meta ng contacts at hanggang 6 na buwang chats ay napupunta sa URL na iyon at nawawala kapag nagsara ang tunnel.
- Pagtatakda ng direct destination sa numerong may automations. Lilipat sa direct ang numero at hihinto ang mga automation nito; gumamit ng Forward URL sa Automations on mode para mapanatili ang dalawa.
- Pag-commit ng .env na isinulat ng agent. Idagdag ito sa .gitignore muna, dahil ang sinumang may hawak ng access token ay makakapag-message sa mga customer bilang negosyo.
- Pagsubok ng send_message sa contact na hindi nag-message sa loob ng 24 oras. Tinatanggihan ng Meta ang free-form text sa labas ng window, kaya mag-message muna sa numero mula sa sarili ninyong telepono.
Tumatakbo ang agent ninyo sa sarili ninyong server, at bawat numero ay binabantayan 24/7 na may alerts. US$ 9 hanggang US$ 0.75 kada numero kada buwan, bumababa habang dumarami ang numero, na may unang 3 araw na libre.
Mga madalas itanong
Gumagana ba ito sa Cursor o iba pang coding tools?
Oo. Anumang MCP client na kumokonekta sa remote servers sa pamamagitan ng Streamable HTTP na may OAuth ay puwedeng gamitin ang parehong URL, kasama ang Cursor, VS Code, Gemini CLI at Antigravity. Ang format ng configuration lamang ang nagbabago mula sa isang client patungo sa isa pa.
Anong wika ang dapat isulat ng agent?
Anumang wika na kayang mag-serve ng HTTPS at mag-compute ng HMAC-SHA256. Karaniwang pagpipilian ang Node.js at Python, at may nasusubukang sample para sa pareho, kasama ang signature checks, duplicate handling at phone pause, sa Node.js and Python agent page.
Kailangan ko ba ng sarili kong Meta app o App Review?
Hindi. Sumasali ang numero sa Cloud API sa pamamagitan ng Meta app ng easyCoexistence at nananatili sa sariling portfolio ng negosyo. Ang token na ipinapadala ng code ninyo ay sarili ng negosyo, kaya walang Meta app ninyo ang kasangkot.
Puwede bang gawin ng coding agent ang mga template na kailangan ng agent?
Oo, gamit ang create_template, saka get_template_status hanggang sumagot ang Meta, karaniwan sa loob ng ilang minuto at hanggang mga 24 oras. Kailangan ng agent ninyo ng aprubadong template para simulan ang usapan o para sumulat matapos magsara ang 24-hour window.
Magpatuloy sa pagbabasa
Handa na po ba kayong magsimula?
I-set up ang WhatsApp Coexistence sa loob ng ilang minuto, hindi buwan. Patuloy na gumagana ang app sa telepono.
Magsimula ng Libreng TrialNa-verify noong