Conectați-văÎncepeți perioada de probă gratuită
Meta Tech Provider

Construiți un bot WhatsApp cu Claude Code sau Codex, pe numărul pe care îl păstrați în aplicație

Adăugați serverul MCP pentru WhatsApp în Claude Code sau Codex și lăsați agentul de programare să facă configurarea: citește credențialele Cloud API ale numărului, creează un receptor webhook, direcționează mesajele primite către el și trimite un mesaj de test unui contact care a scris în ultimele 24 de ore. Rezultatul final este propriul dumneavoastră agent, rulând ca cod al dumneavoastră pe serverul dumneavoastră.

easyCoexistence conectează numărul de firmă WhatsApp Business pe care îl păstrați în aplicație la Cloud API de la Meta prin Coexistence și oferă Claude Code și Codex peste 30 de instrumente MCP cu care să construiți: credențiale, rutare, șabloane, mesaje de test și automatizări.

--scope user

Indicatorul Claude Code care încarcă un server în toate proiectele; domeniul local implicit îl încarcă doar acolo unde a fost adăugat.

codex mcp login

Comanda Codex care stochează autentificarea OAuth a unui server; fără credențial, Codex se poate conecta fără autentificare.

HTTPS

Ce trebuie să folosească o destinație directă webhook, și trebuie să reflecte hub.challenge în handshake-ul GET al Meta.

20 seconds

Cât timp așteaptă pasul Call my webhook răspunsul {"reply"} de la endpoint-ul dumneavoastră înainte ca pasul să eșueze.

24 hours

Fereastra de serviciu pentru clienți după ultimul mesaj al utilizatorului; în afara ei, Meta acceptă doar mesajele de tip șablon.

20 msg/s

Debit fix al unui număr folosit atât cu aplicația WhatsApp Business, cât și cu Cloud API.

Ce are nevoie un agent de programare ca să construiască un agent WhatsApp?

Patru lucruri. Un număr WhatsApp Business conectat la Cloud API de la Meta prin Coexistence, astfel încât aplicația rămâne pe telefon, în timp ce codul poate trimite și primi mesaje. O conexiune MCP din Claude Code sau Codex la acest număr, care permite agentului de programare să citească credențialele, să modifice rutarea și să trimită mesaje de test fără să deschideți panoul de control. O adresă HTTPS publică pentru receptor, de pe un host unde faceți deploy sau printr-un tunel în timpul dezvoltării. Și o cheie de model pentru agentul pe care îl construiți.

Țineți minte diferența dintre cei doi agenți. Claude Code sau Codex este constructorul: acționează doar cât timp lucrați cu el în terminal. Programul pe care îl scrie este cel care răspunde clienților și continuă să ruleze după ce închideți sesiunea.

Cum adăugați instrumentele WhatsApp în Claude Code și Codex?

Fiecare primește un singur URL din terminal și vă autentificați prin OAuth, astfel încât nicio cheie nu intră într-un fișier. În Claude Code, adăugați serverul cu --scope user ca să se încarce în fiecare proiect, apoi porniți claude, rulați /mcp, alegeți easycoexistence și vă autentificați în browser. În Codex, adăugați serverul și rulați codex mcp login, care stochează autentificarea; codex mcp list arată ce este configurat. Codex păstrează intrarea în ~/.codex/config.toml, pe care o citesc și aplicația desktop ChatGPT și extensia Codex IDE.

Verificați că a funcționat cerând ceva ce pot răspunde doar instrumentele, de exemplu „listează numerele mele WhatsApp”. Agentul apelează list_numbers și primește connection_id al fiecărui număr, pe care îl folosesc toate celelalte instrumente.

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

Ce rută trebuie să construiască agentul?

Trei rute aduc mesajul clientului în codul dumneavoastră, iar ele diferă prin cât trebuie să gestioneze codul. Pentru o primă versiune, pasul Call my webhook este cel mai scurt: easyCoexistence omite duplicatele, se oprește când răspundeți de pe telefon și verifică fereastra de 24 de ore înainte să apeleze endpoint-ul dumneavoastră, astfel încât codul scrie doar răspunsul. Treceți la un Forward URL sau la o destinație directă atunci când agentul are nevoie de toate evenimentele, nu doar de mesajele pe care le alege o automatizare.

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

Ce ar trebui să le cereți agentului de programare?

Dați-i din start ruta, limbajul și regulile și cereți un plan înainte ca el să scrie cod. Spuneți-i ce apeluri de instrumente poate face din proprie inițiativă: citirea credențialelor și a documentației este inofensivă, în timp ce schimbarea destinației mesajelor afectează numărul live. get_docs returnează documentația easyCoexistence, inclusiv modul în care un receptor autentifică livrările, astfel încât agentul poate citi regulile în loc să le ghicească. O cerere ca aceasta produce un receptor pe care îl puteți verifica dintr-o singură sesiune:

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.

Cum conectați receptorul și îl testați?

Porniți serverul acolo unde Meta și easyCoexistence îl pot atinge prin HTTPS, apoi lăsați agentul să facă rutarea. Pentru ruta Forward URL, el apelează set_inbound_mode cu URL-ul dumneavoastră pe un număr din Automations în modul on; secretul de redirecționare apare o singură dată, iar agentul îl scrie în fișierul .env. Pentru ruta directă, endpoint-ul trebuie să răspundă mai întâi la handshake-ul GET al Meta, apoi agentul apelează set_webhook_destination cu URL-ul, un secret lung și aleator în cale și token-ul de verificare.

Pentru test, trimiteți un mesaj numărului de firmă de pe telefonul dumneavoastră și urmăriți jurnalele: receptorul ar trebui să vadă evenimentul, modelul ar trebui să răspundă, iar răspunsul ar trebui să apară în conversație. Pentru că tocmai ați scris, fereastra de 24 de ore este deschisă, deci agentul de programare poate încerca și send_message către propriul număr.

Mai are nevoie agentul finalizat de serverul MCP?

Nu. Serverul MCP este instrumentul constructorului, autentificat ca dumneavoastră. Agentul pe care îl lansați trimite prin Graph API de la Meta, cu send_endpoint și access_token returnate de get_api_credentials, token-ul propriu al firmei, limitat la activele sale WhatsApp, și primește prin ruta configurată de dumneavoastră. Dacă access_token a venit null, reconectarea numărului din panoul de control emite unul, fără să înlocuiască un token care deja funcționează.

Păstrați conexiunea MCP pentru lucrul din jurul agentului: crearea șabloanelor cu create_template, verificarea cu get_number_health când ceva pare greșit și citirea jurnalului de rulare al oricărei automatizări care transmite mesaje codului dumneavoastră.

Cum să îl configurați

  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.

Greșeli frecvente

  • Salvarea unui tunel temporar ca destinație directă în primele 24 de ore. Importul unic al Meta, cu contactele și până la 6 luni de conversații, merge la acel URL și se pierde când tunelul se închide.
  • Setarea unei destinații directe pe un număr care rulează automatizări. Numărul trece pe direct, iar automatizările sale se opresc; folosiți un Forward URL în Automations în modul on ca să păstrați ambele.
  • Includerea fișierului .env scris de agent într-un commit. Adăugați-l mai întâi în .gitignore, pentru că oricine deține access_token-ul poate trimite mesaje clienților în numele firmei.
  • Testarea send_message pe un contact care nu a scris în ultimele 24 de ore. Meta refuză textul liber în afara ferestrei, așa că trimiteți mai întâi un mesaj numărului de pe telefonul dumneavoastră.
Faceți acest lucru cu EasyCoexistence

Agentul dumneavoastră rulează apoi pe propriul server, iar fiecare număr este monitorizat 24/7, cu alerte. US$ 9 până la US$ 0.75 pe număr pe lună, scăzând pe măsură ce adăugați numere, cu primele 3 zile gratuite.

Întrebări frecvente

Funcționează și în Cursor sau în alte instrumente de programare?

Da. Orice client MCP care se conectează la servere la distanță prin Streamable HTTP cu OAuth poate folosi același URL, inclusiv Cursor, VS Code, Gemini CLI și Antigravity. Diferă doar formatul de configurare de la un client la altul.

În ce limbaj ar trebui să scrie agentul?

În orice limbaj care poate servi HTTPS și calcula un HMAC-SHA256. Node.js și Python sunt alegerile obișnuite, iar exemplele testate pentru ambele, cu verificări de semnătură, gestionarea duplicatelor și oprirea la răspunsul de pe telefon, se află pe pagina agentului Node.js și Python.

Am nevoie de propria aplicație Meta sau de App Review?

Nu. Numărul se alătură Cloud API prin aplicația Meta a easyCoexistence și rămâne în Business Portfolio al firmei. Token-ul cu care trimite codul este al firmei, așa că nu este implicată nicio aplicație Meta a dumneavoastră.

Poate agentul de programare să creeze șabloanele de care are nevoie agentul?

Da, cu create_template, apoi get_template_status până răspunde Meta, de obicei în câteva minute și cel mult în aproximativ 24 de ore. Agentul dumneavoastră are nevoie de un șablon aprobat ca să înceapă o conversație sau să scrie după ce se închide fereastra de 24 de ore.

Continuați să citiți

Gata să începeți?

Configurați WhatsApp Coexistence în câteva minute, nu luni. Aplicația continuă să funcționeze pe telefon.

Începeți perioada de probă gratuită

Verificat la