Tengeneza boti ya WhatsApp kwa Claude Code au Codex, kwenye nambari unayoweka kwenye programu
Ongeza seva ya WhatsApp MCP kwa Claude Code au Codex, kisha umwachie wakala wa kuandika msimbo kazi ya usanidi: husoma vitambulisho vya Cloud API vya nambari, huunda mpokeaji wa webhook, huelekeza ujumbe unaoingia kwake na kutuma jibu la majaribio kwa mtu aliyeandika ndani ya saa 24 zilizopita. Unachopata ni wakala wako mwenyewe, unaoendeshwa kama msimbo wako kwenye seva yako.
easyCoexistence huunganisha nambari ya WhatsApp Business unayoweka kwenye programu kwenye Cloud API ya Meta kupitia Coexistence, na kukupa zana zaidi ya 30 za MCP za Claude Code na Codex za kujengea: vitambulisho, uelekezaji, violezo, majaribio ya kutuma na otomatiki.
Bendera ya Claude Code inayopakia seva kwenye miradi yako yote; wigo chaguo-msingi wa ndani huipakia tu mahali ilipoongezwa.
Amri ya Codex inayohifadhi kuingia kwa OAuth wa seva; bila kitambulisho, Codex inaweza kuunganishwa bila uthibitishaji.
Kinachohitajika kwa lengo la moja kwa moja la webhook, na lazima kirudishe hub.challenge kwenye salamu ya GET ya Meta.
Muda ambao hatua ya Call my webhook husubiri {"reply"} kutoka kwa endpoint yako kabla hatua haijashindwa.
Dirisha la huduma kwa wateja baada ya ujumbe wa mwisho wa mtumiaji; nje yake, Meta inakubali ujumbe wa kiolezo pekee.
Kasi ya uchakataji isiyobadilika ya nambari inayotumiwa na programu ya WhatsApp Business na Cloud API kwa pamoja.
Wakala wa kuandika msimbo anahitaji nini ili kujenga wakala wa WhatsApp?
Vitu vinne. Nambari ya WhatsApp Business iliyounganishwa na Cloud API ya Meta kupitia Coexistence, ili programu ibaki kwenye simu huku msimbo ukiweza kutuma na kupokea. Muunganisho wa MCP kutoka Claude Code au Codex hadi nambari hiyo, unaoruhusu wakala wa kuandika msimbo kusoma vitambulisho, kubadilisha uelekezaji na kutuma ujumbe wa majaribio bila wewe kufungua dashboard. Anwani ya HTTPS ya umma kwa mpokeaji, kutoka kwa seva unayoweka au tuneli wakati unaendeleza. Na ufunguo wa modeli kwa wakala unaoujenga.
Weka mawakala wawili tofauti akilini. Claude Code au Codex ndiye mjenzi: hufanya kazi tu unapofanya kazi nao kwenye terminali. Programu inayoandikwa ndiyo inayojibu wateja, na inaendelea kufanya kazi baada ya kufunga kikao.
Unaongezaje zana za WhatsApp kwenye Claude Code na Codex?
Kila moja inachukua URL moja kutoka terminali na kuingia kwa OAuth, hivyo hakuna ufunguo unaoingia kwenye faili. Katika Claude Code, ongeza seva kwa --scope user ili ipakie kwenye kila mradi, kisha anzisha claude, endesha /mcp, chagua easycoexistence na uingie kwenye kivinjari. Katika Codex, ongeza seva kisha endesha codex mcp login, ambayo huhifadhi kuingia; codex mcp list huonyesha kilichowekwa. Codex huhifadhi ingizo kwenye ~/.codex/config.toml, ambalo programu ya eneo-kazi ya ChatGPT na kiendelezi cha Codex IDE pia husoma.
Thibitisha kwamba ilifanya kazi kwa kuomba kitu ambacho zana pekee zinaweza kujibu, kama "orodhesha nambari zangu za WhatsApp". Wakala ataita list_numbers na kupata connection_id ya kila nambari, ambayo kila zana nyingine inaitumia.
# 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 listWakala apange njia ipi?
Njia tatu huleta ujumbe wa mteja kwenye msimbo wako, na zinatofautiana kwa kiasi cha kazi msimbo unaopaswa kushughulikia. Kwa toleo la kwanza, hatua ya Call my webhook ndiyo fupi zaidi: easyCoexistence huruka marudio, hurudi nyuma unapojibu kutoka kwenye simu na hukagua dirisha la saa 24 kabla ya kuita endpoint yako, hivyo msimbo wako unaandika jibu pekee. Hamia kwenye Forward URL au lengo la moja kwa moja wakati wakala anahitaji kila tukio, si ujumbe tu ambao otomatiki fulani inachagua.
Unapaswa kumwomba wakala wa msimbo afanye nini?
Mpe njia, lugha na sheria mwanzoni, kisha omba mpango kabla haijaandika msimbo. Mwambie ni wito gani wa zana anaweza kufanya peke yake: kusoma vitambulisho na nyaraka hakudhuru, lakini kubadilisha mahali ujumbe unakokwenda kunaathiri nambari hai. get_docs hurudisha nyaraka za easyCoexistence, ikijumuisha jinsi mpokeaji anavyothibitisha uwasilishaji, ili wakala asome sheria badala ya kuzikisia. Ombi kama hili linazalisha mpokeaji unaoweza kukagua kwa kikao kimoja:
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.Unaunganishaje mpokeaji na kuujaribu?
Anzisha seva mahali ambapo Meta na easyCoexistence wanaweza kuifikia kupitia HTTPS, kisha acha wakala afanye uelekezaji. Kwa njia ya Forward URL, huita set_inbound_mode na URL yako kwenye nambari iliyo kwenye Automations katika modi ya on; siri ya forward hurudi mara moja tu, na wakala ailandika kwenye .env yako. Kwa njia ya moja kwa moja, endpoint lazima ijibu kwanza salamu ya GET ya Meta, kisha wakala aite set_webhook_destination na URL, siri ndefu ya nasibu kwenye njia yake, na verify token yako.
Kujaribu, tuma ujumbe kwa nambari ya biashara kutoka simu yako mwenyewe na angalia kumbukumbu: mpokeaji anapaswa kuona tukio, modeli ijibu, na jibu lionekane kwenye gumzo. Kwa kuwa umeandika tu, dirisha la saa 24 liko wazi, kwa hivyo wakala wa msimbo anaweza pia kujaribu send_message kwa nambari yako mwenyewe.
Je, wakala aliyekamilika bado anahitaji seva ya MCP?
Hapana. Seva ya MCP ni zana ya mjenzi, iliyoingia kama wewe. Wakala unayoweka hutuma kupitia Graph API ya Meta kwa kutumia send_endpoint na access_token ambazo get_api_credentials ilirudisha, token ya biashara yenyewe iliyowekwa kwenye mali zake za WhatsApp, na hupokea kupitia njia uliyoweka. Ikiwa access_token ilirudi null, kuunganisha upya nambari kutoka dashboard hutoa moja bila kubadilisha token inayofanya kazi tayari.
Weka muunganisho wa MCP kwa kazi inayozunguka wakala: kuunda violezo kwa create_template, kukagua get_number_health wakati kitu kinaonekana si sawa, na kusoma kumbukumbu ya kila otomatiki inayokabidhi ujumbe kwa msimbo wako.
Jinsi ya kuisanidi
- 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.
Makosa ya kawaida
- Kuhifadhi tuneli ya muda kama lengo la moja kwa moja ndani ya saa 24 za kwanza. Uingizaji wa mara moja wa Meta wa anwani na hadi miezi 6 ya gumzo unaenda kwenye URL hiyo, na unapotea wakati tuneli inapofungwa.
- Kuweka lengo la moja kwa moja kwenye nambari inayoendesha otomatiki. Nambari inabadilika kuwa ya moja kwa moja na otomatiki zake zinasimama; tumia Forward URL katika modi ya Automations on ili kuweka zote mbili.
- Kuweka kwenye git faili ya .env ambayo wakala aliandika. Iongeze kwenye .gitignore kwanza, kwa sababu yeyote mwenye access token anaweza kutuma ujumbe kwa wateja kama biashara.
- Kujaribu send_message kwa mtu ambaye hajaandika ndani ya saa 24. Meta inakataa maandishi huru nje ya dirisha, kwa hivyo tuma ujumbe kwa nambari kutoka simu yako mwenyewe kwanza.
Wakala wako kisha unaendeshwa kwenye seva yako mwenyewe, na kila nambari inafuatiliwa saa 24 kwa siku kwa arifa. Kuanzia US$ 9 hadi US$ 0.75 kwa kila nambari kwa mwezi, kinashuka kadri unavyoongeza nambari, na siku 3 za kwanza bila malipo.
Maswali yanayoulizwa mara kwa mara
Hii inafanya kazi kwenye Cursor au zana nyingine za kuandika msimbo?
Ndiyo. Mteja yeyote wa MCP anayeunganisha kwenye seva za mbali kupitia Streamable HTTP na OAuth anaweza kutumia URL hiyo hiyo, ikiwemo Cursor, VS Code, Gemini CLI na Antigravity. Muundo wa usanidi pekee ndio hubadilika kutoka mteja mmoja hadi mwingine.
Wakala aandike kwa lugha gani?
Lugha yoyote inayoweza kutoa HTTPS na kukokotoa HMAC-SHA256. Node.js na Python ndizo chaguo za kawaida, na sampuli zilizojaribiwa kwa zote mbili, zenye ukaguzi wa sahihi, ushughulikiaji wa marudio na kusitisha wakati mtu anajibu kutoka kwenye simu, ziko kwenye ukurasa wa wakala wa Node.js na Python.
Je, ninahitaji programu yangu ya Meta au App Review?
Hapana. Nambari inajiunga na Cloud API kupitia programu ya Meta ya easyCoexistence na inabaki kwenye Business Portfolio ya biashara. Token ambayo msimbo wako unatuma nayo ni ya biashara yenyewe, kwa hivyo programu yoyote ya Meta yako haihusiki.
Je, wakala wa msimbo anaweza kuunda violezo ambavyo wakala wako anahitaji?
Ndiyo, kwa create_template, kisha get_template_status hadi Meta ijibu, kwa kawaida ndani ya dakika chache na kwa kiwango cha juu takriban saa 24. Wakala wako anahitaji kiolezo kilichoidhinishwa ili kuanzisha mazungumzo au kuandika baada ya dirisha la saa 24 kufungwa.
Endelea kusoma
Uko tayari kuanza?
Sanidi WhatsApp Coexistence kwa dakika chache, si miezi. Programu inaendelea kufanya kazi kwenye simu.
Anza kipindi cha majaribio bila malipoImethibitishwa kwenye