# WhatsApp Business Tools MCP: jak połączyć WhatsApp Business z agentem AI
> Oficjalny serwer MCP Meta dla WhatsApp Business: możliwości agenta, polecenie połączenia w Claude Code, konfiguracja w Codex i ChatGPT oraz ograniczenia wersji beta.
Source: https://ailoot.ai/blog/pl/whatsapp-business-mcp/
Canonical: https://ailoot.ai/blog/pl/whatsapp-business-mcp/
Language: pl
Publisher: Ailoot (https://ailoot.ai/)
Translation: guide-234
Revision: sha256-2d50bb41d274f525234d142ba990dff10934364e53816c23bcdb925d9f441990
15 września 2026 r. Meta udostępniła oficjalny serwer WhatsApp Business Tools MCP. Łączy on agenta AI — Claude Code, Codex, ChatGPT lub Cursor — z platformą WhatsApp Business Platform. Zamiast przechodzić między Developer Console, Business Managerem i dokumentacją API, opisujesz zadanie agentowi, a on dodaje numer, tworzy szablon wiadomości, konfiguruje webhooki i wysyła wiadomość testową.
Serwer jest nadal w wersji beta: dostęp jest udostępniany stopniowo, a wydanie przeznaczono do programowania i testowania, a nie do masowej wysyłki wiadomości w środowisku produkcyjnym. Poniżej opisujemy przygotowania i kroki połączenia dla czterech klientów. Polecenia i ustawienia sprawdzono na podstawie oficjalnej dokumentacji Meta z 18 września 2026 r.
Informacje o korzystaniu z Ailoot znajdziesz w [dokumentacji](https://ailoot.ai/docs/).
## Czym jest WhatsApp Business Tools MCP?
Najważniejsze informacje
To oficjalny zdalny serwer MCP Meta, który udostępnia agentowi AI narzędzia do zarządzania platformą WhatsApp Business Platform: kontami, numerami telefonów, szablonami wiadomości, webhookami i wysyłaniem wiadomości testowych. Dostęp odbywa się przez OAuth: logujesz się na konto Meta i wybierasz firmy, z którymi serwer może pracować.
MCP (Model Context Protocol) to otwarty standard łączenia systemów zewnętrznych z agentami AI. Więcej informacji znajdziesz w artykule [Serwery MCP dla Claude Code: 7 gotowych integracji](https://ailoot.ai/blog/pl/mcp-servers-claude-code/). Sprawdzone połączenia wraz z poleceniami instalacji znajdują się w katalogu MCP.
Przed premierą tej usługi konfiguracja integracji z WhatsApp wyglądała tak: otwórz Developer Console, utwórz aplikację, połącz firmę, dodaj numer telefonu, zweryfikuj go kodem, wygeneruj token, skonfiguruj webhook, sprawdź dokumentację API — i dopiero wtedy napisz pierwszą linię kodu.
Meta opisuje pomysł stojący za tym serwerem następująco (tłumaczenie z języka angielskiego):
Opisujesz, czego potrzebujesz, a agent sam ustala, jakie konta, numery telefonów, szablony i wywołania API są potrzebne.
— Meta for Developers, https://developers.facebook.com/blog/post/2026/09/15/whatsapp-business-messaging-mcp-ai-agent/
Meta ma teraz dwa serwery MCP i łatwo je pomylić. Meta Social Technologies MCP to uniwersalne narzędzie dla deweloperów: służy do wyszukiwania dokumentacji, odkrywania punktów końcowych Graph API i diagnozowania błędów aplikacji. WhatsApp Business Tools MCP służy do obsługi kont WhatsApp, numerów telefonów, szablonów, webhooków i wiadomości testowych. Serwery się uzupełniają i w razie potrzeby możesz połączyć oba.
## Co dokładnie może zrobić agent po połączeniu?
Najważniejsze informacje
Serwer obsługuje cztery grupy zadań. Konfiguracja numeru telefonu od podstaw: dodanie go, wysłanie kodu weryfikacyjnego, weryfikacja i rejestracja. Szablony wiadomości: tworzenie, edytowanie i sprawdzanie statusu zatwierdzenia. Webhooki: podanie adresu URL funkcji zwrotnej i subskrybowanie pól. Sprawdzanie wymagań wstępnych: agent wykrywa, że nie zaakceptowano warunków lub nie skonfigurowano płatności, i podaje bezpośredni link do rozwiązania problemu.
Narzędzia serwera są pogrupowane pod prefiksem `whatsapp_biz_`. Zgodnie z oficjalną dokumentacją:
- Przegląd: `whatsapp_biz_businesses`, `whatsapp_biz_accounts`, `whatsapp_biz_phone_numbers` — dostępne firmy, konta i numery telefonów.
- Konfiguracja numeru telefonu: `whatsapp_biz_add_phone_number`, `whatsapp_biz_send_verification_code`, `whatsapp_biz_verify_phone_number`, `whatsapp_biz_register_phone_number`.
- Szablony: `whatsapp_biz_list_templates`, `whatsapp_biz_get_template`, `whatsapp_biz_create_template`, `whatsapp_biz_update_template`, `whatsapp_biz_delete_template`.
- Wiadomości: `whatsapp_biz_send_message` — dowolny tekst w 24-godzinnym oknie konwersacji lub zatwierdzony szablon poza tym oknem; przed wysłaniem agent potwierdza z tobą odbiorcę.
- Webhooki: `whatsapp_biz_configure_webhooks`, `whatsapp_biz_subscribe_webhook`.
- Konfiguracja konta: `whatsapp_biz_configure_payments`, `whatsapp_biz_verify_business`, `whatsapp_biz_system_user_token` — link do utworzenia tokena użytkownika systemowego na potrzeby bezpośrednich wywołań Cloud API.
Gdy klient jako pierwszy napisze do firmy, rozpoczyna się okno obsługi klienta: przez 24 godziny możesz odpowiadać dowolnym tekstem. Każda nowa wiadomość od klienta przedłuża to okno. Po jego zamknięciu możesz skontaktować się z klientem tylko za pomocą zatwierdzonego szablonu. Agent zna tę zasadę i jeśli odbiorca znajduje się poza oknem, zasugeruje wysłanie szablonu zamiast zwykłego tekstu.
Serwer ma wbudowaną kontrolę dostępu. Logujesz się za pomocą konta Meta i wybierasz konkretne firmy; tokeny nie są uwzględniane w historii rozmowy. Każdy odczyt odbywa się w twoim kontekście, wywołania są rejestrowane, a działania wprowadzające zmiany wymagają uwierzytelnionej osoby — sam klucz aplikacji serwera nie wystarczy.
## Co sprawdzić przed połączeniem?
Najważniejsze informacje
Trzy wymagania wstępne: rola MANAGE w firmie Meta, którą chcesz zarządzać; uprawnienia administratora aplikacji z włączonym scenariuszem WhatsApp; oraz akceptacja warunków WhatsApp Business Cloud API. Jeśli czegoś brakuje, narzędzie zwraca błąd wyjaśniający problem i link do strony, na której można go rozwiązać.
Serwer działa w twoim imieniu i korzysta wyłącznie z twoich zasobów, dlatego przed pierwszym wywołaniem sprawdź, czy:
1. Masz firmę Meta, w której jesteś administratorem (rola MANAGE).
2. Masz aplikację Meta z włączonym scenariuszem WhatsApp Business Messaging (lub produktem WhatsApp w starszych aplikacjach) i jesteś administratorem tej konkretnej aplikacji; same uprawnienia na poziomie firmy nie wystarczą.
3. Firma zaakceptowała warunki WhatsApp Business Cloud API — bez tego rejestracja numeru telefonu i wysyłanie wiadomości są zablokowane.
Według Meta problemy z warunkami użytkowania, metodami płatności i weryfikacją firmy często pojawiają się bez jasnego wyjaśnienia. Agent sprawdza je z wyprzedzeniem i podaje bezpośredni link, pod którym możesz zaakceptować warunki, określić metodę płatności lub rozpocząć weryfikację firmy.
## Jak połączyć serwer z Claude Code?
Najważniejsze informacje
Uruchom polecenie `claude mcp add --transport http whatsapp_business_tools https://mcp.facebook.com/whatsapp_business_tools`, a następnie wpisz `/mcp` w sesji, wybierz serwer i zaloguj się przez Meta. Po ponownym uruchomieniu klienta musisz zalogować się ponownie.
Jeśli nie masz jeszcze zainstalowanego Claude Code, zacznij od przewodnika [Jak zainstalować Claude Code z oficjalnej strony](https://ailoot.ai/blog/pl/install-claude-code/).
1. ### Dodaj serwer
W terminalu uruchom:
```bash
claude mcp add --transport http whatsapp_business_tools https://mcp.facebook.com/whatsapp_business_tools
```
Serwer jest zdalny, więc nie musisz instalować go lokalnie.
2. ### Zaloguj się przez Meta
W sesji Claude Code wpisz `/mcp` i wybierz `whatsapp_business_tools`. Otworzy się okno przeglądarki, w którym zalogujesz się na konto Meta. Jeśli przeglądarka się nie otworzy, skopiuj link z klienta i otwórz go ręcznie.
3. ### Przyznaj uprawnienia
Na ekranie zgody wybierz firmy i aplikacje z WhatsApp, którym zezwalasz na dostęp. Serwer poprosi o trzy uprawnienia: `business_management` (znajdowanie firm, w których jesteś administratorem), `whatsapp_business_management` (konta, numery telefonów, szablony, webhooki) oraz `whatsapp_business_messaging` (wysyłanie wiadomości z twoich numerów).
4. ### Sprawdź połączenie
Uruchom ponownie Claude Code, zaloguj się ponownie przez `/mcp` i zapytaj agenta, jakie narzędzia widzi na serwerze `whatsapp_business_tools`. Następnie wykonaj bezpieczny odczyt: „Wyświetl listę firm, którymi mogę zarządzać” — agent wywoła `whatsapp_biz_businesses`. Jeśli nie ma żadnych narzędzi albo pojawi się błąd logowania, sprawdź adres serwera i zaloguj się ponownie.
Logowanie OAuth jest powiązane z uruchomieniem klienta: po ponownym uruchomieniu Claude Code musisz zalogować się ponownie. Dostęp możesz w każdej chwili cofnąć w ustawieniach na facebook.com, w sekcji „Business Integrations”.
## Jak połączyć Codex, ChatGPT i Claude Desktop?
Najważniejsze informacje
Wszystkie trzy aplikacje korzystają z tego samego adresu serwera i logowania OAuth; różni się tylko miejsce w ustawieniach. Codex App: Settings, MCP Servers, dodaj serwer Streamable HTTP. ChatGPT: Settings, Plugins, dodaj serwer za pomocą URL. Claude Desktop: Settings, Connectors, niestandardowy konektor.
**Codex App.** Otwórz ustawienia (ikona koła zębatego w lewym dolnym rogu), przejdź do MCP Servers i wybierz Add servers. Wybierz Streamable HTTP i wpisz:
- Name: `WhatsApp Business Tools`
- URL: `https://mcp.facebook.com/whatsapp_business_tools`
- Authentication: OAuth
Kliknij Authenticate i zaloguj się w przeglądarce.
**ChatGPT.** Otwórz kolejno Settings, Plugins i Browse plugins, a następnie kliknij ikonę „+” w prawym górnym rogu. Wpisz nazwę, ten sam URL oraz OAuth jako typ uwierzytelniania.
**Claude Desktop.** Otwórz kolejno Settings, Connectors i Add custom connector. Name: `WhatsApp Business Tools`; URL: ten sam adres serwera.
Po dodaniu serwera w dowolnym kliencie wykonaj te same czynności kontrolne: uruchom go ponownie, zaloguj się ponownie, wyświetl listę narzędzi i bezpiecznie odczytaj listę firm.
## Co dzieje się podczas pierwszej sesji: od listy firm do wiadomości testowej?
Najważniejsze informacje
Kolejność jest następująca: wyświetl listę firm, wybierz jedną, sprawdź jej konta i numery telefonów, dodaj numer telefonu, wyślij kod weryfikacyjny SMS-em lub połączeniem, zweryfikuj numer kodem, zarejestruj go, utwórz szablon, wyślij wiadomość testową i skonfiguruj webhook. Kod SMS podajesz agentowi samodzielnie.
Typowa pierwsza sesja z połączonym serwerem wygląda tak:
1. „Wyświetl listę firm, którymi zarządzam” — agent wywołuje `whatsapp_biz_businesses`, a ty wybierasz potrzebną firmę.
2. „Pokaż konta WhatsApp i numery telefonów tej firmy” — `whatsapp_biz_accounts` i `whatsapp_biz_phone_numbers` wraz z ich statusami.
3. „Dodaj mój testowy numer telefonu do konta” — `whatsapp_biz_add_phone_number`.
4. „Wyślij kod weryfikacyjny SMS-em” — `whatsapp_biz_send_verification_code`. Kod dotrze na twój telefon.
5. „Zweryfikuj numer kodem 123456” — `whatsapp_biz_verify_phone_number`, a następnie zarejestruj go za pomocą `whatsapp_biz_register_phone_number`.
6. „Utwórz szablon `order_update` w języku preferowanym przez odbiorców, przeznaczony do powiadomień o zamówieniach” — `whatsapp_biz_create_template`; agent poda link do sprawdzenia statusu zatwierdzenia.
7. „Wyślij wiadomość testową na mój numer” — `whatsapp_biz_send_message`; agent potwierdzi odbiorcę przed wysłaniem.
8. „Skonfiguruj webhook pod adresem [https://example.com/webhook](https://example.com/webhook)” — `whatsapp_biz_configure_webhooks`, a następnie subskrybuj za pomocą `whatsapp_biz_subscribe_webhook`.
Od tej pory przychodzące wiadomości klientów będą trafiać na wskazany adres — zwykle odbiera je tam system CRM, obsługi klienta lub bot. Obsługę pod tym adresem budujesz osobno; serwer zajmuje się tylko konfiguracją.
## Jakie są ograniczenia wersji beta?
Najważniejsze informacje
Serwer jest w wersji beta: zestaw narzędzi może się zmieniać, a dostęp jest udostępniany stopniowo, nie wszystkim jednocześnie. Wydanie przeznaczono do programowania i testowania; nie nadaje się do masowej wysyłki wiadomości w środowisku produkcyjnym. Dla każdego narzędzia obowiązują limity żądań na użytkownika, a po ponownym uruchomieniu klienta trzeba zalogować się ponownie.
Pamiętaj o czterech ograniczeniach serwera.
**Status beta.** Meta informuje, że interfejs i zestaw narzędzi mogą się zmieniać, a dostęp jest udostępniany stopniowo. Jeśli nie możesz jeszcze połączyć się z serwerem, być może nie został ci jeszcze udostępniony.
**Przeznaczenie.** Wydanie służy do programowania i testowania; nie jest przeznaczone do masowej wysyłki w środowisku produkcyjnym. Do produkcyjnej obsługi wiadomości potrzebna będzie pełna integracja z Cloud API — na przykład za pomocą tokena użytkownika systemowego, do którego link udostępnia narzędzie `whatsapp_biz_system_user_token`.
**Limity.** Dla każdego narzędzia obowiązują limity żądań na użytkownika. Po przekroczeniu limitu narzędzie zwraca błąd informujący o limicie — zaczekaj i spróbuj ponownie.
**Zasada 24-godzinnego okna.** Poza oknem rozmowy z klientem możesz wysyłać tylko zatwierdzone szablony.
## Co to oznacza dla firmy?
Najważniejsze informacje
Teraz możesz skonfigurować początkową integrację WhatsApp podczas jednej rozmowy z agentem: zna on kolejność działań i rozumie błędy platformy. Główne zastosowania to obsługa klienta, powiadomienia o zamówieniach i wizytach oraz przygotowywanie szablonów.
Typowy scenariusz dla małej firmy: klienci piszą przez WhatsApp, a ty chcesz szybko odpowiadać i wysyłać powiadomienia o statusie zamówienia. Wcześniej początkową konfigurację trzeba było przeprowadzać samodzielnie w kilku panelach Meta albo zlecić deweloperowi. Teraz możesz zrobić to podczas rozmowy z agentem. Nadal musisz osobno zbudować obsługę przychodzących wiadomości pod własnym adresem — to kolejne zadanie po skonfigurowaniu webhooka.
Serwer przyda się również wtedy, gdy integracja już działa. Szablony wiadomości wymagają regularnych aktualizacji: na przykład w związku z nową promocją lub nową treścią powiadomienia. Za pośrednictwem serwera agent tworzy lub edytuje szablon i pokazuje jego status zatwierdzenia, bez odsyłania cię do panelu.
Podobne podejście — agent łączy się z systemem zewnętrznym i obsługuje go na podstawie twojego opisu — przedstawiono wraz z dokumentacją w przewodniku Jak połączyć NotebookLM z Claude Code przez MCP.
## Co dalej?
Najważniejsze informacje
Sprawdź wymagania wstępne, połącz serwer jednym poleceniem, zaloguj się i bezpiecznie wyświetl listę firm. Następnie dodaj testowy numer telefonu i wyślij pierwszą wiadomość. Pamiętaj, że to wersja beta: do produkcyjnej obsługi wiadomości przygotuj pełną integrację z Cloud API.
Od ogłoszenia serwera minęły trzy dni. Możesz zacząć od jednego polecenia i zalogowania się przez Meta, a następnie poprosić agenta o listę swoich firm. Później, zależnie od potrzeb, skonfiguruj numery telefonów, szablony, webhooki i wiadomości testowe.
Inne sposoby łączenia agenta z systemami zewnętrznymi znajdziesz w zbiorze [Serwery MCP dla Claude Code](https://ailoot.ai/blog/pl/mcp-servers-claude-code/) — jest tam jeszcze siedem działających integracji do różnych zadań.
### Źródła
- [Meta for Developers: ogłoszenie WhatsApp Business Tools MCP (15.09.2026)](https://developers.facebook.com/blog/post/2026/09/15/whatsapp-business-messaging-mcp-ai-agent/)
- [Meta: dokumentacja WhatsApp Business Tools MCP](https://developers.facebook.com/documentation/mcp/whatsapp-business-tools-mcp)
- [Meta: przegląd serwerów MCP dla deweloperów](https://developers.facebook.com/documentation/mcp)
- [WhatsApp Business Platform: dokumentacja](https://developers.facebook.com/documentation/business-messaging/whatsapp)
Poznaj [Ailoot](https://ailoot.ai/).
## Pytania i odpowiedzi
### Jak najbezpieczniej sprawdzić pierwsze połączenie?
Po logowaniu OAuth obejrzyj listę narzędzi i odczytaj firmy, którymi możesz zarządzać. Sprawdza to dostęp przed dodawaniem telefonu, tworzeniem szablonów, konfiguracją webhooków lub wysyłaniem wiadomości testowej.
### Czy konfiguracja webhooka buduje też obsługę wiadomości?
Nie. Serwer MCP konfiguruje callback i subskrypcje, ale osobno trzeba zbudować CRM, wsparcie lub bota odbierającego i przetwarzającego wiadomości pod tym adresem.
## Ailoot · Firma i jej portfel projektów
Ailoot opiera się na zgromadzonym doświadczeniu operacyjnym, szerokiej bazie klientów, stabilnej usłudze i stałej kontroli KPI.
Firma i jej portfel projektów: miliony klientów; miesięczna sprzedaż liczona w miliardach.
Ailoot wykorzystuje to doświadczenie operacyjne, zapewniając dostęp przez API do funkcji AI w produktach klientów, agentach, aplikacjach i automatyzacjach.