Zaloguj sięRozpocznij bezpłatny okres próbny
Meta Tech Provider

Zbuduj bota WhatsApp z Claude Code lub Codex, na numerze, który zachowujesz w aplikacji

Dodaj serwer MCP WhatsApp do Claude Code lub Codex i pozwól agentowi programistycznemu wykonać konfigurację: odczyta dane uwierzytelniające Cloud API numeru, utworzy odbiornik webhooka, skieruje przychodzące wiadomości do niego i wyśle testową odpowiedź do osoby, która napisała w ciągu ostatnich 24 godzin. Wynikiem jest własny agent, działający jako Twój kod na Twoim serwerze.

easyCoexistence łączy numer WhatsApp Business, który zachowujesz w aplikacji, z Cloud API Meta przez Coexistence i daje Claude Code oraz Codex ponad 30 narzędzi MCP do budowania: dane uwierzytelniające, routing, szablony, testowe wysyłki i automatyzacje.

--scope user

Flaga Claude Code, która ładuje serwer we wszystkich projektach; domyślny zakres local ładuje go tylko tam, gdzie został dodany.

codex mcp login

Polecenie Codex, które zapisuje logowanie OAuth serwera; bez poświadczenia Codex może połączyć się bez uwierzytelnienia.

HTTPS

Wymagania bezpośredniego celu webhooka: w uzgadnianiu GET Meta musi odesłać hub.challenge.

20 seconds

Jak długo krok „Wywołaj mój webhook” czeka na {"reply"} z Twojego endpointu, zanim krok zakończy się błędem.

24 hours

Okno obsługi klienta po ostatniej wiadomości użytkownika; poza nim Meta przyjmuje wyłącznie wiadomości szablonowe.

20 msg/s

Stała przepustowość numeru używanego zarówno w aplikacji WhatsApp Business, jak i w Cloud API.

Czego potrzebuje agent programistyczny, żeby zbudować agenta WhatsApp?

Cztery rzeczy. Numer WhatsApp Business połączony z Cloud API Meta przez Coexistence, dzięki czemu aplikacja zostaje w telefonie, a kod może wysyłać i odbierać. Połączenie MCP od Claude Code lub Codex z tym numerem, które pozwala agentowi programistycznemu odczytać dane uwierzytelniające, zmienić routing i wysłać testowe wiadomości bez otwierania panelu. Publiczny adres HTTPS dla odbiornika, z hosta, na który wdrażasz, albo z tunelu podczas programowania. I klucz modelu dla budowanego agenta.

Rozdziel w głowie dwóch agentów. Claude Code lub Codex jest budowniczym: działa tylko wtedy, gdy z nim pracujesz w terminalu. Program, który napisze, odpowiada klientom i działa nadal po zamknięciu sesji.

Jak dodać narzędzia WhatsApp do Claude Code i Codex?

Każde z nich przyjmuje jeden adres URL z terminala i loguje się przez OAuth, więc żaden klucz nie trafia do pliku. W Claude Code dodaj serwer z --scope user, aby ładował się we wszystkich projektach, następnie uruchom claude, wpisz /mcp, wybierz easycoexistence i zaloguj się w przeglądarce. W Codex dodaj serwer i uruchom codex mcp login, które zapisuje logowanie; codex mcp list pokazuje, co jest skonfigurowane. Codex przechowuje wpis w ~/.codex/config.toml, który czytają także aplikacja desktopowa ChatGPT i rozszerzenie Codex IDE.

Sprawdź, czy działa, prosząc o coś, na co odpowiedzą tylko narzędzia, na przykład „wypisz moje numery WhatsApp”. Agent wywoła list_numbers i dostanie connection_id każdego numeru, który przyjmują wszystkie pozostałe narzędzia.

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

Jaką trasę powinien zbudować agent?

Trzy trasy doprowadzają wiadomość klienta do Twojego kodu i różnią się tym, ile kod musi obsłużyć. Na pierwszą wersję najkrótszy jest krok „Wywołaj mój webhook”: easyCoexistence pomija duplikaty, ustępuje, gdy odpowiesz z telefonu, i sprawdza 24-godzinne okno, zanim wywoła Twój endpoint, więc kod tylko pisze odpowiedź. Przejdź na adres Forward URL lub bezpośredni cel webhooka, gdy agent potrzebuje każdego zdarzenia, a nie tylko wiadomości wybranych przez automatyzację.

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

O co poprosić agenta programistycznego?

Podaj mu trasę, język i zasady od razu i poproś o plan, zanim napisze kod. Określ, które wywołania narzędzi może wykonać samodzielnie: odczyt danych uwierzytelniających i dokumentacji jest bezpieczny, natomiast zmiana miejsca wysyłki wiadomości wpływa na działający numer. get_docs zwraca dokumentację easyCoexistence, w tym sposób uwierzytelniania dostaw do odbiornika, więc agent może czytać zasady zamiast je zgadywać. Prośba w tym stylu daje odbiornik, który przejrzysz w jednym posiedzeniu:

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.

Jak podłączyć odbiornik i go przetestować?

Uruchom serwer tam, gdzie Meta i easyCoexistence mogą go osiągnąć przez HTTPS, a potem pozwól agentowi zająć się routingiem. Przy trasie Forward URL agent wywołuje set_inbound_mode z Twoim adresem URL dla numeru z automatyzacjami w trybie on; sekret przekazywania jest zwracany jednorazowo, a agent zapisuje go w .env. Przy trasie bezpośredniej endpoint musi najpierw odpowiedzieć na uzgadnianie GET Meta, a dopiero potem agent wywołuje set_webhook_destination z adresem, długim losowym sekretem w ścieżce i Twoim verify tokenem.

Aby przetestować, napisz z własnego telefonu na numer firmowy i obserwuj logi: odbiornik powinien zobaczyć zdarzenie, model odpowiedzieć, a odpowiedź pojawić się w czacie. Okno 24-godzinne jest otwarte, bo wiadomość właśnie przyszła, więc agent może też spróbować send_message na Twój numer.

Czy gotowy agent nadal potrzebuje serwera MCP?

Nie. Serwer MCP to narzędzie budowniczego, zalogowane na Twoje konto. Agent, który wdrażasz, wysyła przez Graph API Meta, używając send_endpoint i access_token zwróconych przez get_api_credentials, czyli własnego tokenu firmy ograniczonego do jej zasobów WhatsApp, a odbiera przez trasę, którą ustawiłeś. Jeśli access_token wrócił jako null, ponowne połączenie numeru z panelu wystawi go bez zastępowania tokenu, który już działa.

Zachowaj połączenie MCP do pracy wokół agenta: tworzenia szablonów przez create_template, sprawdzania get_number_health, gdy coś wygląda źle, oraz czytania logu uruchomień każdej automatyzacji, która przekazuje wiadomości do Twojego kodu.

Jak to skonfigurować

  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.

Typowe błędy

  • Zapisanie tymczasowego tunelu jako bezpośredniego celu w ciągu pierwszych 24 godzin. Jednorazowy import kontaktów i do 6 miesięcy czatów przez Meta trafia na ten adres i przepada, gdy tunel się zamknie.
  • Ustawienie bezpośredniego celu na numerze, który obsługuje automatyzacje. Numer przechodzi na tryb bezpośredni i jego automatyzacje się zatrzymują; użyj adresu Forward URL w trybie on w automatyzacjach, aby zachować oba.
  • Commitowanie pliku .env zapisanego przez agenta. Dodaj go najpierw do .gitignore, bo każdy, kto ma token dostępu, może pisać do klientów jako firma.
  • Testowanie send_message na kontakcie, który nie pisał od 24 godzin. Meta odrzuca wiadomości z dowolnym tekstem poza oknem, więc najpierw napisz na numer z własnego telefonu.
Z EasyCoexistence zrobisz to

Twój agent działa wtedy na własnym serwerze, a każdy numer jest monitorowany 24/7 z alertami. Od US$ 9 do US$ 0.75 za numer miesięcznie, spadając wraz z dodawaniem numerów, z pierwszymi 3 dniami za darmo.

Najczęściej zadawane pytania

Czy to działa w Cursor lub innych narzędziach do kodowania?

Tak. Każdy klient MCP, który łączy się ze zdalnymi serwerami przez Streamable HTTP z OAuth, może użyć tego samego adresu URL, w tym Cursor, VS Code, Gemini CLI i Antigravity. Zmienia się tylko format konfiguracji między klientami.

W jakim języku powinien być napisany agent?

W dowolnym, który potrafi obsługiwać HTTPS i obliczyć HMAC-SHA256. Najczęstsze wybory to Node.js i Python; sprawdzone przykłady dla obu, z weryfikacją podpisu, obsługą duplikatów i pauzą telefonu, znajdziesz na stronie agenta dla Node.js i Pythona.

Czy potrzebuję własnej aplikacji Meta i App Review?

Nie. Numer dołącza do Cloud API przez aplikację Meta easyCoexistence i pozostaje w portfolio firmy. Token, którym wysyła Twój kod, należy do firmy, więc aplikacja Meta po Twojej stronie nie jest potrzebna.

Czy agent programistyczny może utworzyć potrzebne szablony?

Tak, przez create_template, a następnie get_template_status, aż Meta odpowie, zwykle w ciągu minut, najwyżej około 24 godzin. Agent potrzebuje zatwierdzonego szablonu, aby rozpocząć rozmowę lub pisać po zamknięciu 24-godzinnego okna.

Czytaj dalej

Gotowy, aby zacząć?

Skonfiguruj WhatsApp Coexistence w kilka minut, nie miesięcy. Aplikacja nadal działa na telefonie.

Rozpocznij bezpłatny okres próbny

Zweryfikowano w