WhatsApp Business Tools MCP: jak připojit WhatsApp Business k AI agentovi

Dne 15. září 2026 vydala Meta oficiální MCP server WhatsApp Business Tools. Propojuje AI agenta – Claude Code, Codex, ChatGPT nebo Cursor – s platformou WhatsApp Business. Místo přecházení mezi Developer Console, Business Managerem a dokumentací API popíšete úkol agentovi a ten přidá číslo, vytvoří šablonu zprávy, nakonfiguruje webhooky a odešle testovací zprávu.

Server je stále v beta verzi: přístup se postupně zpřístupňuje a vydání je určeno pro vývoj a testování, nikoli pro zasílání zpráv ve velkém měřítku v produkčním prostředí. Níže najdete přípravu a postup připojení pro čtyři klienty. Příkazy a nastavení byly ověřeny podle oficiální dokumentace Meta dne 18. září 2026.

Informace o práci s Ailootem najdete v dokumentaci.

Co je WhatsApp Business Tools MCP?#

MCP (Model Context Protocol) je otevřený standard pro připojení externích systémů k AI agentům. Více se o něm dozvíte v článku MCP servery pro Claude Code: 7 hotových integrací. Ověřená připojení s instalačními příkazy najdete v katalogu MCP.

Před tímto vydáním vypadalo nastavení integrace s WhatsAppem takto: otevřít Developer Console, vytvořit aplikaci, propojit firmu, přidat telefonní číslo, ověřit ho kódem, vygenerovat token, nakonfigurovat webhook, prostudovat dokumentaci API – a teprve potom napsat první řádek kódu.

Meta popisuje myšlenku serveru takto (přeloženo z angličtiny):

Meta nyní nabízí dva MCP servery a lze si je snadno splést. Meta Social Technologies MCP je univerzální vývojářský nástroj: vyhledávání v dokumentaci, hledání koncových bodů Graph API a diagnostika chyb aplikací. WhatsApp Business Tools MCP slouží k práci s účty WhatsApp, telefonními čísly, šablonami, webhooky a testovacími zprávami. Doplňují se a v případě potřeby můžete připojit oba.

Co může AI agent po připojení WhatsApp Business Tools MCP dělat?#

Nástroje serveru jsou seskupeny pod prefixem whatsapp_biz_. Podle oficiální dokumentace:

• Přehled: whatsapp_biz_businesses, whatsapp_biz_accounts, whatsapp_biz_phone_numbers—které firmy, účty a telefonní čísla máte k dispozici.
• Nastavení telefonního čísla: whatsapp_biz_add_phone_number, whatsapp_biz_send_verification_code, whatsapp_biz_verify_phone_number, whatsapp_biz_register_phone_number.
• Šablony: whatsapp_biz_list_templates, whatsapp_biz_get_template, whatsapp_biz_create_template, whatsapp_biz_update_template, whatsapp_biz_delete_template.
• Zprávy: whatsapp_biz_send_message—volný text v rámci 24hodinového okna konverzace nebo schválená šablona mimo toto okno; agent s vámi před odesláním potvrdí příjemce.
• Webhooky: whatsapp_biz_configure_webhooks, whatsapp_biz_subscribe_webhook.
• Nastavení účtu: whatsapp_biz_configure_payments, whatsapp_biz_verify_business, whatsapp_biz_system_user_token—odkaz pro vytvoření tokenu systémového uživatele k přímému volání Cloud API.

Když zákazník napíše firmě jako první, otevře se okno zákaznické podpory: po dobu 24 hodin můžete odpovídat volným textem. Každá nová zpráva zákazníka toto okno prodlužuje. Po jeho uzavření můžete zákazníka kontaktovat pouze pomocí schválené šablony. Agent toto pravidlo zná, a pokud je příjemce mimo okno, navrhne místo běžného textu odeslat šablonu.

Server má vestavěné řízení přístupu. Přihlásíte se pomocí účtu Meta a vyberete konkrétní firmy; tokeny se nezahrnují do historie konverzace. Každé čtení probíhá ve vašem kontextu, volání se zaznamenávají a akce, které něco mění, vyžadují ověřenou osobu; samotný klíč aplikace serveru nestačí.

Co byste měli zkontrolovat před připojením?#

Server jedná vaším jménem a pracuje pouze s vašimi prostředky, proto před prvním voláním zkontrolujte následující:

1. Máte firmu Meta, ve které jste administrátorem (role MANAGE).
2. Máte aplikaci Meta se zapnutým scénářem WhatsApp Business Messaging (nebo produktem WhatsApp ve starších aplikacích) a jste správcem konkrétně této aplikace; oprávnění na úrovni firmy sama o sobě nestačí.
3. Firma přijala podmínky WhatsApp Business Cloud API – bez toho je registrace telefonního čísla a odesílání blokováno.

Podle Meta často vznikají problémy s podmínkami použití, platebními metodami a ověřením firmy, aniž by bylo jasné proč. Agent je předem zkontroluje a poskytne přímý odkaz, kde můžete přijmout podmínky, zadat platební metodu nebo zahájit ověření firmy.

Jak připojit server ke Claude Code?#

Pokud jste Claude Code ještě nenainstalovali, začněte návodem Jak nainstalovat Claude Code z oficiálních stránek.

1. Přidání serveru

   V terminálu spusťte:

   claude mcp add --transport http whatsapp_business_tools https://mcp.facebook.com/whatsapp_business_tools
   

   Server je vzdálený, takže ho nemusíte instalovat místně.

2. Přihlášení přes Meta

   V relaci Claude Code zadejte /mcp a vyberte whatsapp_business_tools. Otevře se okno prohlížeče, kde se přihlásíte ke svému účtu Meta. Pokud se prohlížeč neotevře, zkopírujte odkaz z klienta a otevřete ho ručně.

3. Udělení oprávnění

   Na obrazovce souhlasu vyberte firmy a aplikace s WhatsAppem, ke kterým povolujete přístup. Server požádá o tři oprávnění: business_management (vyhledání firem, ve kterých jste administrátorem), whatsapp_business_management (účty, telefonní čísla, šablony, webhooky) a whatsapp_business_messaging (odesílání zpráv z vašich čísel).

4. Kontrola připojení

   Restartujte Claude Code, znovu se přihlaste přes /mcp a zeptejte se agenta, které nástroje vidí na serveru whatsapp_business_tools. Pak bezpečně proveďte čtení: „Vypiš firmy, které můžu spravovat“ – agent zavolá whatsapp_biz_businesses. Pokud se nezobrazí žádné nástroje nebo se objeví chyba přihlášení, zkontrolujte adresu serveru a přihlaste se znovu.

Přihlášení OAuth je vázáno na spuštění klienta: po restartování Claude Code se musíte přihlásit znovu. Přístup můžete kdykoli odvolat v nastavení na facebook.com v části „Business Integrations“.

Jak připojit Codex, ChatGPT a Claude Desktop?#

Codex App. Otevřete nastavení (ozubené kolečko vlevo dole), přejděte do MCP Servers a vyberte Add servers. Zvolte Streamable HTTP a zadejte:

• Název: WhatsApp Business Tools
• URL: https://mcp.facebook.com/whatsapp_business_tools
• Ověřování: OAuth

Klikněte na Authenticate a přihlaste se v prohlížeči.

ChatGPT. Settings, Plugins, Browse plugins, ikona „+“ v pravém horním rohu. Zadejte název, stejnou URL a OAuth jako typ ověřování.

Claude Desktop. Settings, Connectors, Add custom connector. Název: WhatsApp Business Tools; URL: stejná adresa serveru.

Po přidání v kterémkoli klientovi postupujte stejně: restartujte, znovu se přihlaste, zobrazte seznam nástrojů a bezpečně načtěte seznam firem.

Co se děje při první relaci: od seznamu firem k testovací zprávě?#

Typická první relace s připojeným serverem:

1. „Vypiš firmy, které spravuji“ – agent zavolá whatsapp_biz_businesses a vy vyberete tu, kterou potřebujete.
2. „Ukaž mi účty WhatsApp a telefonní čísla této firmy“ – whatsapp_biz_accounts a whatsapp_biz_phone_numbers včetně jejich stavů.
3. „Přidej k účtu moje testovací telefonní číslo“ – whatsapp_biz_add_phone_number.
4. „Pošli ověřovací kód SMS zprávou“ – whatsapp_biz_send_verification_code. Kód vám přijde do telefonu.
5. „Ověř číslo kódem 123456“ – whatsapp_biz_verify_phone_number, potom ho zaregistrujte pomocí whatsapp_biz_register_phone_number.
6. „Vytvoř šablonu order_update v jazyce, který příjemci preferují, pro oznámení o objednávkách“ – whatsapp_biz_create_template; agent poskytne odkaz na stav jejího schválení.
7. „Pošli testovací zprávu na moje číslo“ – whatsapp_biz_send_message; agent před odesláním potvrdí příjemce.
8. „Nakonfiguruj webhook na adrese https://example.com/webhook“ – whatsapp_biz_configure_webhooks a odběr pomocí whatsapp_biz_subscribe_webhook.

Poté budou příchozí zprávy zákazníků doručovány na zadanou adresu – obvykle je tam načítá CRM, zákaznická podpora nebo bot. Zpracování na této adrese vytvoříte samostatně; server zajišťuje pouze konfiguraci.

Jaká jsou omezení beta verze?#

Je třeba počítat se čtyřmi omezeními serveru.

Stav beta verze. Meta uvádí, že rozhraní a sada nástrojů se mohou změnit a přístup se zavádí postupně. Pokud se k serveru zatím nemůžete připojit, možná vám ještě nebyl zpřístupněn.

Účel. Vydání je určeno pro vývoj a testování; není určeno pro hromadné odesílání v produkčním prostředí. Pro produkční zasílání zpráv budete potřebovat plnohodnotnou integraci s Cloud API – například pomocí tokenu systémového uživatele, jehož odkaz poskytuje nástroj whatsapp_biz_system_user_token.

Limity. Počet požadavků na každý nástroj je omezen pro jednotlivé uživatele. Pokud limit překročíte, nástroj vrátí chybu limitu – počkejte a zkuste to znovu.

Pravidlo 24hodinového okna. Mimo okno zákaznické konverzace můžete odesílat pouze schválené šablony.

Proč je to důležité pro firmy?#

Typický scénář pro malou firmu: zákazníci píšou přes WhatsApp a vy jim chcete rychle odpovídat a posílat oznámení o stavu objednávek. Dříve počáteční nastavení znamenalo samostatnou práci v několika panelech Meta nebo najmutí vývojáře. Nyní můžete tuto část dokončit v konverzaci s agentem. Zpracování příchozích zpráv na vlastní adrese stále vytváříte samostatně – to je další úkol po konfiguraci webhooku.

Server se hodí také v případě, že vaše integrace už běží. Šablony zpráv potřebují pravidelné aktualizace: novou akci, nový text oznámení. Prostřednictvím serveru agent vytvoří nebo upraví šablonu a zobrazí její stav schválení, aniž by vás posílal do ovládacího panelu.

Podobný přístup – agent se připojí k externímu systému a pracuje s ním podle vašeho popisu – ukazuje s dokumentací návod Jak připojit NotebookLM ke Claude Code přes MCP.

Co dál?#

Oznámení serveru je staré tři dny. Začít můžete jedním příkazem a přihlášením přes Meta, poté požádejte agenta o seznam svých firem. Dále podle potřeby: telefonní čísla, šablony, webhooky, testovací zprávy.

Další způsoby, jak připojit agenta k externím systémům, najdete ve sbírce MCP serverů pro Claude Code – dalších sedm funkčních integrací pro různé úkoly.

Poznejte Ailoot.