WhatsApp API dla agentów AI: oficjalny dostęp w kilka minut, bez zostawania Tech Providerem
Agent AI dostaje oficjalny dostęp do WhatsApp przez Cloud API Meta, a numer, który pozostaje w aplikacji WhatsApp Business, dołącza do niego przez Tech Providera lub Solution Partnera. Możesz nim zostać, z weryfikacją firmy, filmami do App Review i wdrożeniem Embedded Signup, albo połączyć się przez dostawcę, który już nim jest: numer dołącza w kilka minut, a agent dostaje narzędzia MCP lub dane dostępowe do API.
easyCoexistence to niezależny Tech Provider Meta: podłącza numer WhatsApp Business do Cloud API przez Coexistence w kilka minut, więc Twój agent dostaje oficjalny dostęp, a firma zachowuje aplikację.
Czego Meta wymaga od każdego, kto podłącza numer pozostający w aplikacji WhatsApp Business: statusu Tech Providera lub Solution Partnera.
App Review wymaga jednego filmu z wiadomością wysłaną z Twojej aplikacji oraz drugiego, na którym Twoja aplikacja tworzy szablon.
Co App Review przyznaje dla whatsapp_business_messaging i whatsapp_business_management, obu wymaganych, by zostać Tech Providerem.
Kiedy Meta wycofała Embedded Signup v2 i v3, każąc integracjom przejść na v4.
Stała przepustowość numeru używanego jednocześnie w aplikacji WhatsApp Business i w Cloud API.
Jak długo hostowany link do połączenia pozostaje ważny, gdy platforma podłącza numer klienta przez Partner API.
Czego agent AI potrzebuje, by używać WhatsApp oficjalnie?
Czterech rzeczy z Cloud API Meta. Identyfikatora numeru telefonu (phone number ID) i tokenu dostępu z uprawnieniem whatsapp_business_messaging, dzięki czemu agent może wywoływać endpoint messages. Endpointu webhooka, na który Meta dostarcza przychodzące wiadomości, a przy numerze współdzielonym z aplikacją także smb_message_echoes, czyli odpowiedzi, które osoba wpisuje w telefonie. Zatwierdzonych szablonów, bo wiadomość wpisana ręcznie dociera tylko do osoby, która napisała w ciągu ostatnich 24 godzin. Oraz sposobu, by wiedzieć, kiedy połączenie się zerwie, ponieważ aplikacja w telefonie dalej działa, gdy strona API przestaje.
Skrót, który ludzie znajdują najpierw, to automatyzacja WhatsApp Web, logująca się jako urządzenie powiązane. Łamie ona warunki WhatsApp i naraża numer na ryzyko blokady, cokolwiek agent na niej robi.
Co obejmuje ścieżka Tech Providera?
Sekwencję Meta, w tej kolejności. Każdy krok jest bezpłatny i żadnego nie da się kupić szybciej: przeglądy odbywają się według harmonogramu Meta, a Meta nie publikuje terminów, więc planuj raczej tygodnie niż dni, zanim numer pierwszego klienta się połączy. Potem backend musi działać nieprzerwanie: wymiana tokenu po każdej rejestracji, odbiornik webhooków, kierowanie ruchu według numeru i monitorowanie rozłączeń, na przykład regułę Meta o 14 dniach bez aktywności.
Jaka jest krótsza droga?
Połącz numer przez dostawcę, który już przeszedł ten proces. W easyCoexistence firma uruchamia Embedded Signup Meta i skanuje kod w aplikacji WhatsApp Business, co zajmuje około dwóch minut. Numer dołącza do Cloud API w Business Portfolio firmy, a aplikacja dalej działa. Agent dostaje dostęp w takiej formie, jakiej używa: narzędzia MCP dla asystenta, takiego jak ChatGPT, Claude, Claude Code lub Codex, albo dane dostępowe i webhooki numeru dla kodu, który sam uruchamiasz.
| Connect through easyCoexistence | Become a Tech Provider | |
|---|---|---|
| Meta app and App Review | Not needed: the number joins through ours | Yours to build and pass |
| Embedded Signup | Hosted, with the QR scan in the app | You integrate version 4 and host the flow |
| First number connected | Minutes after signing up | After verification and review |
| Webhook trust | A secret in your URL, or X-EC-Signature on forwarded messages | Your app secret signs Meta's deliveries |
| Disconnection alerts | Every number watched 24/7, 14-day rule included | Monitoring you build and run |
| Who owns the WhatsApp Business Account | The business, in its own portfolio | The business |
Skąd agent bierze dane dostępowe numeru?
Przez narzędzie get_api_credentials albo ze strony numeru w panelu. Narzędzie zwraca bazowy adres URL Graph API, WhatsApp Business Account ID, identyfikator numeru telefonu, endpoint wysyłania oraz, jeśli istnieje, własny token dostępu firmy, ograniczony do jej zasobów WhatsApp. Gdy nie wydano tokenu klienta, token wraca jako null z notatką, że ponowne połączenie numeru z panelu wydaje go, bez zastępowania działającego tokenu. Nie ma sekretu aplikacji do pobrania, bo Meta podpisuje webhooki sekretem aplikacji easyCoexistence, który nigdy nie jest udostępniany. Narzędzie wymaga aktywnego planu, bo token może wysyłać wiadomości.
curl -X POST "$SEND_ENDPOINT" \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"messaging_product": "whatsapp",
"to": "5511999998888",
"type": "text",
"text": { "body": "Your order #1042 is ready for pickup." }
}'Jak wiadomości przychodzące trafiają do agenta?
Każdy numer ma dwa tryby, przełączane przez set_inbound_mode albo na stronie numeru. Bezpośrednio do serwera: set_webhook_destination kieruje Meta prosto na Twój endpoint HTTPS, który musi odpowiadać na handshake GET Meta, a easyCoexistence nigdy nie widzi wiadomości, więc automatyzacje są wyłączone. Ponieważ Meta podpisuje te dostarczenia naszym sekretem aplikacji, umieść długi losowy sekret w ścieżce URL i odrzucaj żądania bez niego.
Automatyzacje włączone: Meta dostarcza do easyCoexistence, automatyzacje mogą odpowiadać, a opcjonalny Forward URL odbiera oryginalny payload Meta pod kluczem „value”, podpisany nagłówkiem X-EC-Signature: t=<unix>,v1=<HMAC-SHA256 z „<t>.<body>”> przy użyciu sekretu pokazanego jednorazowo. Krok „Call my webhook” w automatyzacji także przekazuje wiadomość i ostatnie 10 wiadomości czatu agentowi, i wysyła jego odpowiedź, gdy Twoja odpowiedź ma postać {"reply": "..."} w ciągu 20 sekund.
Jakie limity agent musi respektować?
Limity Meta, takie same przez dowolnego dostawcę. Agent, który zna je z góry, unika błędów, które wyglądają na bugi:
- 20 wiadomości na sekundę na numer, ustalone przez Meta dla numerów współdzielonych z aplikacją WhatsApp Business.
- Wpisane ręcznie wiadomości tylko w ciągu 24 godzin od ostatniej wiadomości klienta; potem zatwierdzony szablon.
- Szablony wysyłane wyłącznie przez API, bo aplikacja na numerze Coexistence nie może ich wysłać.
- Odpowiedzi, które osoba wpisuje w aplikacji, przychodzą jako
smb_message_echoes; wstrzymaj agenta w tym czacie, inaczej klient dostanie dwie odpowiedzi. - Czaty grupowe nie są synchronizowane z API, więc agent działa w czatach jeden na jeden.
- Kontakty i do 6 miesięcy czatów jeden na jeden importują się jednorazowo, tylko jeśli bezpośredni cel webhooka zostanie zapisany w ciągu 24 godzin od połączenia; numer z włączonymi automatyzacjami nie otrzymuje importu.
- Rozmowy głosowe i wideo działają dalej w aplikacji, ale Cloud API nie obsługuje połączeń na numerze Coexistence, więc agent działa tekstowo.
Czy platforma może podłączać w ten sposób numery własnych klientów?
Tak, przez Partner API. Tą drogą SaaS lub agencja podłącza klientów bez własnego statusu Tech Providera. Klucz utwórz przez create_api_key (zaczyna się od ec_live_ i jest pokazany jednorazowo), a potem wywołaj POST /api/v1/connect-sessions z backendu albo create_connect_link z asystenta, by otrzymać hostowany link ważny przez 1 godzinę. Klient przechodzi tam okno Meta i skan kodu QR, po czym wraca na Twój redirect_url z connection_id. GET /api/v1/connections/:id?credentials=1 zwraca wtedy własny token klienta, a zdarzenia statusu, na przykład connection.disconnected, przychodzą podpisane nagłówkiem X-EC-Signature. Każdy numer jest rozliczany na Twoim koncie według tych samych progów za numer.
Typowe błędy
- Sprawdzanie X-Hub-Signature-256 przy bezpośrednim celu. Meta podpisuje sekretem aplikacji easyCoexistence, który nigdy nie jest udostępniany, więc prawdziwe dostarczenia nie przechodzą sprawdzenia; zaufaj długiemu losowemu sekretowi w URL albo użyj przekierowania z X-EC-Signature.
- Odbiór przez węzeł WhatsApp Trigger w n8n. Oczekuje on własnej aplikacji Meta; użyj zamiast tego ogólnego węzła Webhook z sekretem w URL.
- Ignorowanie smb_message_echoes. Agent odpowiada wtedy na wiadomość osoby, która już odpisała z telefonu, i klient widzi dwie odpowiedzi.
- Zapisanie bezpośredniego celu webhooka dni po połączeniu albo pozostawienie numeru z automatyzacjami. Jednorazowy import kontaktów i do 6 miesięcy czatów Meta wymaga bezpośredniego celu zapisanego w ciągu 24 godzin od połączenia.
Agent działa przez ponad 30 narzędzi MCP lub przez dane dostępowe i webhooki każdego numeru, a każdy numer jest monitorowany 24/7, z powiadomieniami. Od US$ 9 do US$ 0.75 za numer miesięcznie, z każdym kolejnym numerem taniej, z bezpłatnym okresem próbnym przez pierwsze 3 dni.
Najczęściej zadawane pytania
Czy potrzebuję własnej aplikacji Meta?
Nie. Numer zostaje podłączony przez aplikację Meta easyCoexistence i pozostaje w Business Portfolio firmy oraz w jej WhatsApp Business Account. Twój kod wysyła wiadomości tokenem firmy z get_api_credentials, więc żadna Twoja aplikacja nie jest potrzebna, chyba że później ją zbudujesz.
Czy agent i zespół mogą jednocześnie korzystać z numeru?
Tak. Meta synchronizuje wiadomości między Cloud API a aplikacją WhatsApp Business, więc to, co wysyła agent, pojawia się w wątku czatu w aplikacji w telefonie, a to, co zespół wpisze w aplikacji, trafia do Twojego systemu jako smb_message_echoes.
Które frameworki agentów z tym działają?
Każdy klient, który mówi przez MCP po HTTP z OAuth, na przykład ChatGPT, Claude, Claude Code, Codex i Cursor, oraz każdy kod wywołujący Graph API Meta: Node.js, Python, n8n, LangChain, OpenAI Agents SDK czy Vercel AI SDK. Pod spodem jest samo API Meta, więc w agencie nie ma niczego zastrzeżonego.
Czy ogólnego przeznaczenia asystent AI może działać na WhatsApp?
Warunki Business Solution Meta, sekcja 4.7, zakazują dostawcom ogólnych asystentów AI oferowania ich na WhatsApp Business Platform tam, gdzie AI jest główną funkcją, według oceny Meta, obowiązuje od 15 stycznia 2026. Firma, która używa AI wobec własnych klientów, do obsługi, sprzedaży lub rezerwacji, nie jest celem tego zakazu, a regulatorzy w UE i Brazylii nakazali Meta zawieszenie lub cofnięcie tej reguły wobec konkurencyjnych asystentów.
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óbnyZweryfikowano w