WhatsApp Business Tools MCP: jak połączyć WhatsApp Business z agentem AI

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.

Czym jest WhatsApp Business Tools MCP?#

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. 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):

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?#

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?#

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?#

Jeśli nie masz jeszcze zainstalowanego Claude Code, zacznij od przewodnika Jak zainstalować Claude Code z oficjalnej strony.

1. Dodaj serwer

   W terminalu uruchom:

   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?#

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?#

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” — 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?#

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?#

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?#

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 — jest tam jeszcze siedem działających integracji do różnych zadań.

Poznaj Ailoot.