# WhatsApp Business Tools MCP: jak připojit WhatsApp Business k AI agentovi
> Oficiální MCP server společnosti Meta pro WhatsApp Business: co agent umí, příkaz pro připojení v Claude Code, nastavení v Codexu a ChatGPT a omezení beta verze.
Source: https://ailoot.ai/blog/cs/whatsapp-business-mcp/
Canonical: https://ailoot.ai/blog/cs/whatsapp-business-mcp/
Language: cs
Publisher: Ailoot (https://ailoot.ai/)
Translation: guide-234
Revision: sha256-dff790aea3885d73ba7ba016f0575b89edcdc845ee6bf62e812c265253084551
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](https://ailoot.ai/docs/).
## Co je WhatsApp Business Tools MCP?
Hlavní poznatek
Jde o oficiální vzdálený MCP server společnosti Meta, který poskytuje AI agentovi nástroje pro správu platformy WhatsApp Business: účtů, telefonních čísel, šablon zpráv, webhooků a testovacího odesílání. Přístup využívá OAuth: přihlásíte se ke svému účtu Meta a vyberete firmy, se kterými serveru povolíte pracovat.
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í](https://ailoot.ai/blog/cs/mcp-servers-claude-code/). 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):
Popíšete, co potřebujete, a agent si sám zjistí účty, telefonní čísla, šablony a volání API.
— Meta for Developers, https://developers.facebook.com/blog/post/2026/09/15/whatsapp-business-messaging-mcp-ai-agent/
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?
Hlavní poznatek
Server podporuje čtyři skupiny úkolů. Připojení nového telefonního čísla od začátku: přidat ho, odeslat ověřovací kód, ověřit ho a zaregistrovat. Šablony zpráv: vytvořit je, upravit a zkontrolovat stav schválení. Webhooky: zadat URL callbacku a přihlásit se k odběru polí. Kontrola předpokladů: agent zjistí, když nebyly přijaty podmínky nebo není nastavená platba, a poskytne přímý odkaz k nápravě.
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?
Hlavní poznatek
Tři předpoklady: role MANAGE ve firmě Meta, kterou chcete spravovat; administrátorská práva k aplikaci se zapnutým scénářem WhatsApp; a přijetí podmínek WhatsApp Business Cloud API. Pokud něco chybí, nástroj vrátí chybu s vysvětlením problému a odkazem na stránku, kde ho můžete napravit.
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?
Hlavní poznatek
Spusťte příkaz `claude mcp add --transport http whatsapp_business_tools https://mcp.facebook.com/whatsapp_business_tools`, potom v relaci zadejte `/mcp`, vyberte server a přihlaste se přes Meta. Po restartování klienta se musíte přihlásit znovu.
Pokud jste Claude Code ještě nenainstalovali, začněte návodem [Jak nainstalovat Claude Code z oficiálních stránek](https://ailoot.ai/blog/cs/install-claude-code/).
1. ### Přidání serveru
V terminálu spusťte:
```bash
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?
Hlavní poznatek
Všechny tři používají stejnou adresu serveru a přihlášení OAuth; liší se pouze umístění v nastavení. Codex App: Settings, MCP Servers, přidat server Streamable HTTP. ChatGPT: Settings, Plugins, přidat podle URL. Claude Desktop: Settings, Connectors, vlastní konektor.
**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ě?
Hlavní poznatek
Postup je následující: vypsat firmy, vybrat jednu, zobrazit její účty a telefonní čísla, přidat telefonní číslo, odeslat ověřovací kód SMS zprávou nebo hovorem, ověřit číslo kódem, zaregistrovat ho, vytvořit šablonu, odeslat testovací zprávu a nakonfigurovat webhook. SMS kód poskytnete agentovi sami.
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](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?
Hlavní poznatek
Server je v beta verzi: sada nástrojů se může změnit a přístup se zavádí postupně, nikoli všem najednou. Vydání je určeno pro vývoj a testování; není vhodné pro zasílání zpráv ve velkém měřítku v produkčním prostředí. Pro každého uživatele platí limity požadavků pro jednotlivé nástroje a po restartování klienta se musíte znovu přihlásit.
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?
Hlavní poznatek
Počáteční nastavení integrace WhatsAppu nyní můžete dokončit v jedné konverzaci s agentem: zná pořadí kroků a rozumí chybám platformy. Hlavní případy použití jsou zákaznická podpora, oznámení o objednávkách a schůzkách a příprava šablon.
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?
Hlavní poznatek
Zkontrolujte předpoklady, připojte server jedním příkazem, přihlaste se a bezpečně načtěte seznam firem. Pak přidejte testovací telefonní číslo a odešlete první zprávu. Nezapomeňte, že jde o beta verzi: pro produkční zasílání zpráv připravte plnohodnotnou integraci Cloud API.
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](https://ailoot.ai/blog/cs/mcp-servers-claude-code/) – dalších sedm funkčních integrací pro různé úkoly.
### Zdroje
- [Meta for Developers: Představujeme WhatsApp Business Tools MCP (15.09.2026)](https://developers.facebook.com/blog/post/2026/09/15/whatsapp-business-messaging-mcp-ai-agent/)
- [Meta: Dokumentace WhatsApp Business Tools MCP](https://developers.facebook.com/documentation/mcp/whatsapp-business-tools-mcp)
- [Meta: Přehled MCP serverů pro vývojáře](https://developers.facebook.com/documentation/mcp)
- [Platforma WhatsApp Business: Dokumentace](https://developers.facebook.com/documentation/business-messaging/whatsapp)
Poznejte [Ailoot](https://ailoot.ai/).
## Časté otázky
### Jaká je nejbezpečnější první kontrola připojení?
Po přihlášení přes OAuth prohlédněte seznam nástrojů a načtěte firmy, které můžete spravovat. Ověříte přístup před přidáním telefonního čísla, tvorbou šablon, nastavením webhooků či odesláním testovací zprávy.
### Vybuduje nastavení webhooku také zpracování zpráv?
Ne. Server MCP nastaví adresu callbacku a odběry, ale CRM, podporu nebo bota přijímajícího a zpracovávajícího zprávy na této adrese musíte vytvořit samostatně.
## Ailoot · Společnost a její portfolio projektů
Ailoot staví na dlouhodobých provozních zkušenostech, široké klientské základně, stabilních službách a průběžném sledování KPI.
Společnost a její portfolio projektů: miliony zákazníků; měsíční tržby v miliardách.
Ailoot využívá tyto provozní zkušenosti k poskytování přístupu přes API k funkcím AI v produktech zákazníků, agentech, aplikacích a automatizacích.