Rakenna WhatsApp-botti Claude Coden tai Codexin avulla, sovelluksessa pitämälläsi numerolla
Lisää WhatsApp MCP -palvelin Claude Codeen tai Codexiin ja anna koodausagentin tehdä asennus. Agentti lukee numeron Cloud API -tunnukset, luo webhook-vastaanottimen, ohjaa saapuvat viestit sille ja lähettää testivastauksen henkilölle, joka on kirjoittanut viimeisen 24 tunnin aikana. Lopputuloksena on oma agenttisi, joka toimii sinun koodinasi mukaan omalla palvelimellasi.
easyCoexistence yhdistää WhatsApp Business -numerosi, jonka pidät sovelluksessa, Metan Cloud API:in Coexistencen kautta ja antaa Claude Codelle ja Codexille yli 30 MCP-työkalua rakentamiseen: tunnukset, reititys, viestipohjat, testilähetykset ja automaatiot.
Claude Coden lippu, joka lataa palvelimen kaikkiin projekteihisi; oletuksena paikallinen laajuus lataa sen vain siellä, missä se lisättiin.
Codex-komento, joka tallentaa palvelimen OAuth-kirjautumisen; ilman tunnistetta Codex voi yhdistää ilman todennusta.
Mitä suoran webhook-kohteen on käytettävä, ja sen on toistettava hub.challenge Metan GET-kättelyssä.
Kuinka kauan Call my webhook -vaihe odottaa endpointisi {"reply"}-vastausta ennen kuin vaihe epäonnistuu.
Asiakaspalveluikkuna käyttäjän viimeisen viestin jälkeen; sen ulkopuolella Meta hyväksyy vain viestipohjat.
Kiinteä läpimenonopeus numerolle, jota käytetään sekä WhatsApp Business -sovelluksen että Cloud API:n kanssa.
Mitä koodausagentti tarvitsee WhatsApp-agentin rakentamiseen?
Neljä asiaa. WhatsApp Business -numero, joka on yhdistetty Metan Cloud API:in Coexistencen kautta, jolloin sovellus pysyy puhelimella ja koodi voi lähettää ja vastaanottaa. MCP-yhteys Claude Codesta tai Codexista tuohon numeroon, jonka avulla koodausagentti lukee tunnuksia, muuttaa reititystä ja lähettää testiviestejä ilman, että avaat hallintapaneelin. Julkinen HTTPS-osoite vastaanottimelle, joko palvelimelta, johon julkaiset, tai tunnelilta kehityksen ajaksi. Ja mallin avain rakentamallesi agentille.
Pidä kaksi agenttia erillään mielessäsi. Claude Code tai Codex on rakentaja: se toimii vain silloin, kun työskentelet sen kanssa terminaalissa. Sen kirjoittama ohjelma on se, joka vastaa asiakkaille, ja se jatkaa toimintaa, kun suljet istunnon.
Miten lisäät WhatsApp-työkalut Claude Codeen ja Codexiin?
Kumpikin ottaa yhden URL-osoitteen terminaalista ja kirjautuu OAuthilla, joten avainta ei tallenneta tiedostoon. Claude Codessa lisää palvelimen komennolla --scope user, jolloin se latautuu jokaisessa projektissa. Käynnistä claude, aja /mcp, valitse easycoexistence ja kirjaudu selaimessa. Codexissa lisää palvelimen ja aja codex mcp login, joka tallentaa kirjautumisen. codex mcp list näyttää, mitä on määritetty. Codex tallentaa merkinnän tiedostoon ~/.codex/config.toml, jonka ChatGPT-työpöytäsovellus ja Codex IDE -laajennus lukevat myös.
Tarkista, että se toimi pyytämällä jotain, mihin vain työkalut voivat vastata, esimerkiksi ”listaa WhatsApp-numeroni”. Agentti kutsuu list_numbers-työkalua ja saa jokaisen numeron connection_id:n, jonka kaikki muut työkalut ottavat.
# 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 listMitä reittiä agentin pitäisi rakentaa?
Kolme reittiä vie asiakkaan viestin koodiisi, ja ne eroavat siinä, kuinka paljon koodin on hoidettava. Ensimmäiseen versioon lyhin on Call my webhook -vaihe: easyCoexistence ohittaa kaksoiskappaleet, väistyy, kun vastaat puhelimesta, ja tarkistaa 24 tunnin ikkunan ennen kuin endpointtiasi kutsutaan, joten koodisi kirjoittaa vain vastauksen. Siirry Forward URL -reittiin tai suoraan kohteeseen, kun agentin on saatava kaikki tapahtumat eikä vain automaatioiden valitsemia viestejä.
Mitä koodausagentin pitäisi tehdä, kun pyydät sitä?
Anna sille heti alussa reitti, kieli ja säännöt, ja pyydä suunnitelma ennen kuin se kirjoittaa koodia. Kerro, mitä työkalukutsuja se saa tehdä itsenäisesti. Tunnusten ja dokumentaation lukeminen on vaaratonta, mutta viestien kohteen muuttaminen vaikuttaa elävään numeroon. get_docs palauttaa easyCoexistencen dokumentaation, myös siitä, miten vastaanotin todentaa toimitukset, joten agentti voi lukea säännöt sen sijaan, että arvaisi ne. Tämän kaltainen pyyntö tuottaa vastaanottimen, jonka voit tarkistaa yhdellä istunnolla:
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.Miten yhdistät vastaanottimen ja testaat sen?
Käynnistä palvelin paikkaan, josta Meta ja easyCoexistence tavoittavat sen HTTPS:n yli, ja anna agentin tehdä reititys. Forward URL -reittiä varten se kutsuu set_inbound_mode-työkalua URL-osoitteellasi numerolle, joka on Automations on -tilassa. Forward secret palautuu kerran, ja agentti kirjoittaa sen .env-tiedostoon. Suoraa reittiä varten endpointin on ensin vastattava Metan GET-kättelyyn. Sen jälkeen agentti kutsuu set_webhook_destination-työkalua URL-osoitteella, jonka polussa on pitkä satunnainen salaisuus, ja verify tokenillasi.
Testaa lähettämällä viesti yritysnumerolle omasta puhelimestasi ja seuraa lokeja. Vastaanottimen pitäisi nähdä tapahtuma, mallin vastata ja vastauksen ilmestyä chattiin. Koska kirjoitit juuri, 24 tunnin ikkuna on auki, joten koodausagentti voi myös kokeilla send_message-työkalua omaan numeroosi.
Tarvitseeko valmis agentti yhä MCP-palvelinta?
Ei. MCP-palvelin on rakentajan työkalu, kirjautuneena sinuna. Agentti, jonka julkaiset, lähettää Meta Graph API:n kautta send_endpoint-osoitteella ja access_tokenilla, jotka get_api_credentials palautti. Token on yrityksen oma ja rajattu sen WhatsApp-resursseihin, ja agentti vastaanottaa sen reitin kautta, jonka asetit. Jos access_token palautui nullina, numeron yhdistäminen uudelleen hallintapaneelista antaa uuden tokenin, eikä korvaa jo toimivaa tokenia.
Pidä MCP-yhteys työn ympärillä agentin ulkopuolella: viestipohjien luomiseen create_template-työkalulla, get_number_health-tarkistukseen, kun jokin näyttää vialliselta, ja minkä tahansa automaation ajolokin lukemiseen, jos se välittää viestejä koodillesi.
Näin otat sen käyttöön
- 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.
Yleiset virheet
- Väliaikaisen tunnelin tallentaminen suoraksi kohteeksi ensimmäisen 24 tunnin aikana. Metan kertaluonteinen kontaktien ja jopa 6 kuukauden chatit tuonti menee siihen URL-osoitteeseen ja katoaa, kun tunneli suljetaan.
- Suoran kohteen asettaminen numerolle, joka ajaa automaatioita. Numero siirtyy suoraan tilaan ja sen automaatiot pysähtyvät. Käytä Forward URL -reittiä Automations on -tilassa, jotta molemmat toimivat.
- Agentin kirjoittaman .env-tiedoston vieminen versionhallintaan. Lisää se ensin .gitignoreen, koska kuka tahansa, jolla on access token, voi viestiä asiakkaille yrityksen nimissä.
- send_message-testin lähettäminen kontaktille, joka ei ole kirjoittanut 24 tunnin aikana. Meta kieltäytyy vapaasta tekstistä ikkunan ulkopuolella, joten lähetä ensin viesti numerolle omasta puhelimestasi.
Agenttisi toimii sitten omalla palvelimellasi, ja jokaista numeroa valvotaan 24/7 hälytyksin. US$ 9:stä US$ 0.75:een numeroa kohden kuukaudessa, kun lisäät numeroita. Ensimmäiset 3 päivää ilmaiseksi.
Usein kysytyt kysymykset
Toimiiko tämä Cursorissa tai muissa koodaustyökaluissa?
Kyllä. Mikä tahansa MCP-asiakas, joka yhdistää etäpalvelimiin Streamable HTTP -protokollalla ja OAuthilla, voi käyttää samaa URL-osoitetta, mukaan lukien Cursor, VS Code, Gemini CLI ja Antigravity. Vain konfiguraation muoto vaihtelee asiakkaasta toiseen.
Mitä kieltä agentin pitäisi kirjoittaa?
Mitä tahansa kieltä, joka osaa palvella HTTPS:ää ja laskea HMAC-SHA256:n. Yleisimmät valinnat ovat Node.js ja Python. Molempiin on testatut esimerkit allekirjoituksen tarkistuksineen, kaksoiskappaleiden käsittelyineen ja tauko-ominaisuudella, joka pysähtyy, kun vastaat puhelimesta. Ne löytyvät Node.js- ja Python-agenttisivulta.
Tarvitsenko oman Meta-sovelluksen tai App Reviewn?
Et. Numero liittyy Cloud API:in easyCoexistencen Meta-sovelluksen kautta ja pysyy yrityksen omassa Business Portfoliossa. Koodisi lähettämä token on yrityksen oma, joten sinun omaa Meta-sovellustasi ei tarvita.
Voiko koodausagentti luoda agentin tarvitsemat viestipohjat?
Kyllä, create_template-työkalulla ja sen jälkeen get_template_status-työkalulla, kunnes Meta vastaa. Vastaus tulee yleensä minuuteissa ja enintään noin 24 tunnissa. Agenttisi tarvitsee hyväksytyn viestipohjan keskustelun aloittamiseen tai kirjoittamiseen sen jälkeen, kun 24 tunnin ikkuna sulkeutuu.
Lue lisää
Valmis aloittamaan?
Ota WhatsApp Coexistence käyttöön minuuteissa, ei kuukausissa. Sovellus toimii edelleen puhelimessa.
Aloita ilmainen kokeiluVahvistettu