Prijavite seZapočnite besplatno probno razdoblje
Meta Tech Provider

Izradite WhatsApp bota pomoću alata Claude Code ili Codex, na broju koji čuvate u aplikaciji

Dodajte WhatsApp MCP poslužitelj u Claude Code ili Codex i prepustite postavljanje agentu za programiranje: on čita Cloud API vjerodajnice broja, izrađuje webhook primatelja, usmjerava dolazne poruke prema njemu i šalje probni odgovor osobi koja je pisala u posljednja 24 sata. Ono što dobivate jest vaš vlastiti agent, koji radi kao vaš kod na vašem poslužitelju.

easyCoexistence povezuje WhatsApp Business broj koji čuvate u aplikaciji s Metinim Cloud API-jem putem Coexistencea i daje Claude Code i Codexu više od 30 MCP alata za izradu: vjerodajnice, usmjeravanje, predloške, probna slanja i automatizacije.

--scope user

Zastavica Claude Code koja učitava poslužitelj u svim vašim projektima; zadani lokalni opseg učitava ga samo tamo gdje je dodan.

codex mcp login

Naredba za Codex koja pohranjuje OAuth prijavu poslužitelja; bez vjerodajnice Codex se može povezati bez autentifikacije.

HTTPS

Što izravno odredište webhooka mora koristiti te mora vraćati hub.challenge u Metinom GET rukovanju.

20 seconds

Koliko dugo korak „Call my webhook” čeka na {"reply"} vašeg endpointa prije nego što korak ne uspije.

24 hours

Prozor za korisničku uslugu nakon posljednje poruke korisnika; izvan njega Meta prihvaća samo predloške.

20 msg/s

Fiksni propusni kapacitet broja koji se koristi s aplikacijom WhatsApp Business i Cloud API-jem.

Što agentu za programiranje treba za izradu WhatsApp agenta?

Četiri stvari. WhatsApp Business broj povezan s Metinim Cloud API-jem putem Coexistencea, tako da aplikacija ostaje na telefonu dok kod može slati i primati. MCP veza iz Claude Code ili Codex s tim brojem, što agentu omogućuje čitanje vjerodajnica, promjenu usmjeravanja i slanje probnih poruka bez otvaranja nadzorne ploče. Javna HTTPS adresa za primatelja, s poslužitelja na koji se postavljate ili s tunela dok razvijate. I ključ modela za agenta koji gradite.

Držite dva agenta odvojeno u glavi. Claude Code ili Codex je graditelj: djeluje samo dok radite s njim u terminalu. Program koji on napiše jest onaj koji odgovara kupcima i nastavlja raditi nakon što zatvorite sesiju.

Kako dodati WhatsApp alate u Claude Code i Codex?

Svaki prima jedan URL iz terminala i prijavljuje se putem OAuth-a, tako da se nikakav ključ ne sprema u datoteku. U Claude Code dodajte poslužitelj s --scope user da se učitava u svakom projektu, zatim pokrenite claude, izvedite /mcp, odaberite easycoexistence i prijavite se u pregledniku. Za Codex dodajte poslužitelj i pokrenite codex mcp login, što pohranjuje prijavu; codex mcp list prikazuje što je konfigurirano. Codex zadržava unos u ~/.codex/config.toml, koji čitaju i ChatGPT stolna aplikacija i proširenje za Codex IDE.

Provjerite je li radi tako da zatražite nešto što mogu odgovoriti samo alati, npr. „list my WhatsApp numbers”. Agent poziva list_numbers i dobiva connection_id svakog broja, a njega koriste svi ostali alati.

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

Koji put treba agent izgraditi?

Tri puta dovode poruku kupca do vašeg koda, a razlikuju se po tome koliko kod mora obraditi. Za prvu verziju korak „Call my webhook” je najkraći: easyCoexistence preskače duplikate, povlači se kada odgovorite s telefona i provjerava 24-satni prozor prije nego što pozove vaš endpoint, pa vaš kod samo piše odgovor. Prijeđite na Forward URL ili izravno odredište kada agent treba svaki događaj, a ne samo poruke koje odabere automatizacija.

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

Što treba zatražiti od agenta za programiranje?

Dajte mu rutu, jezik i pravila unaprijed te zatražite plan prije nego što napiše kod. Recite mu koje pozive alata smije sam izvršavati: čitanje vjerodajnica i dokumentacije je bezopasno, dok promjena mjesta slanja poruka utječe na živi broj. get_docs vraća easyCoexistence dokumentaciju, uključujući način na koji primatelj autentificira isporuke, pa agent može čitati pravila umjesto da ih pogađa. Zahtjev kao ovaj daje primatelja koji možete pregledati u jednom sjedenju:

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.

Kako povezati primatelja i testirati ga?

Pokrenite poslužitelj tamo gdje Meta i easyCoexistence mogu doći putem HTTPS-a, a zatim agentu prepustite usmjeravanje. Za rutu Forward URL, on poziva set_inbound_mode s vašim URL-om na broju u Automations, u načinu on; tajni ključ za prosljeđivanje vraća se jednom, a agent ga zapisuje u vašu .env datoteku. Za izravnu rutu endpoint najprije mora odgovoriti na Metino GET rukovanje, nakon čega agent poziva set_webhook_destination s URL-om, dugim nasumičnim tajnim kodom u putanji i vašim verify tokenom.

Za test pošaljite poruku s vlastitog telefona na poslovni broj i pratite zapise: primatelj bi trebao vidjeti događaj, model bi trebao odgovoriti, a odgovor bi se trebao pojaviti u razgovoru. Budući da ste upravo pisali, 24-satni prozor je otvoren, pa agent za programiranje može pokušati pozvati send_message na vaš vlastiti broj.

Treba li gotovom agentu još MCP poslužitelj?

Ne. MCP poslužitelj je alat graditelja, prijavljen kao vi. Agent koji postavite šalje putem Metinog Graph API-ja s send_endpoint i access_token koje je vratio get_api_credentials, tvrtkinim vlastitim tokenom ograničenim na njezine WhatsApp resurse, a prima putem rute koju ste postavili. Ako je access_token vraćen kao null, ponovno povezivanje broja s nadzorne ploče izdaje jedan bez zamjene tokena koji već radi.

Zadržite MCP vezu za posao oko agenta: stvaranje predložaka pomoću create_template, provjeru get_number_health kada nešto izgleda pogrešno i čitanje dnevnika izvođenja svake automatizacije koja poruke predaje vašem kodu.

Kako ga postaviti

  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.

Uobičajene pogreške

  • Spremanje privremenog tunela kao izravnog odredišta u prvih 24 sata. Metin jednokratni uvoz kontakata i do 6 mjeseci razgovora šalje se na taj URL i gubi se kada se tunel zatvori.
  • Postavljanje izravnog odredišta na broj koji vodi automatizacije. Broj prelazi na izravno i njegove automatizacije prestaju; koristite Forward URL u Automations, u načinu on, da zadržite oboje.
  • Slanje .env datoteke koju je agent zapisao u repozitorij. Prvo je dodajte u .gitignore, jer svatko tko ima access token može slati poruke kupcima u ime tvrtke.
  • Testiranje send_message na kontaktu koji nije pisao u posljednja 24 sata. Meta odbija slobodan tekst izvan prozora, pa prvo pošaljite poruku broju s vlastitog telefona.
Radite ovo uz EasyCoexistence

Vaš agent zatim radi na vašem poslužitelju, a svaki broj nadzire se 24/7 uz obavijesti. Od US$ 9 do US$ 0,75 po povezanom broju mjesečno, a cijena pada kako dodajete brojeve. Prva 3 dana su besplatna.

Često postavljana pitanja

Radi li ovo u alatu Cursor ili drugim alatima za programiranje?

Da. Svaki MCP klijent koji se povezuje s udaljenim poslužiteljima putem Streamable HTTP s OAuth-om može koristiti isti URL, uključujući Cursor, VS Code, Gemini CLI i Antigravity. Mijenja se samo format konfiguracije od jednog klijenta do drugog.

Koji jezik agent treba pisati?

Bilo koji jezik koji može poslužiti HTTPS i izračunati HMAC-SHA256. Node.js i Python su uobičajeni izbori, a testirani primjeri za oba, s provjerama potpisa, obradom duplikata i pauzom telefona, nalaze se na stranici za agenta u Node.js i Pythonu.

Treba li mi vlastita Meta aplikacija ili App Review?

Ne. Broj se pridružuje Cloud API-ju putem Meta aplikacije easyCoexistence i ostaje u portfelju tvrtke (Business Portfolio). Token kojim vaš kod šalje pripada tvrtki, pa vaša vlastita Meta aplikacija nije uključena.

Može li agent za programiranje izraditi predloške koje treba vaš agent?

Može, pomoću create_template, a zatim get_template_status dok Meta ne odgovori, obično unutar nekoliko minuta i najviše otprilike 24 sata. Vašem agentu treba odobren predložak da započne razgovor ili da piše nakon što se zatvori 24-satni prozor.

Nastavite čitati

Spremni za početak?

Postavite WhatsApp Coexistence u nekoliko minuta, a ne mjeseci. Aplikacija i dalje radi na telefonu.

Započnite besplatno probno razdoblje

Provjereno na