WhatsApp Business Tools MCP: ako pripojiť WhatsApp Business k AI agentovi

15. septembra 2026 spoločnosť Meta vydala oficiálny server WhatsApp Business Tools MCP. Prepája AI agenta—Claude Code, Codex, ChatGPT alebo Cursor—s platformou WhatsApp Business. Namiesto prepínania medzi Developer Console, Business Manager a dokumentáciou API opíšete agentovi úlohu a on pridá číslo, vytvorí šablónu správy, nakonfiguruje webhooky a odošle testovaciu správu.

Server je stále v beta verzii: prístup sa sprístupňuje postupne a vydanie je určené na vývoj a testovanie, nie na rozsiahle produkčné posielanie správ. Nižšie nájdete prípravy a kroky pripojenia pre štyroch klientov. Príkazy a nastavenia boli overené podľa oficiálnej dokumentácie spoločnosti Meta 18. septembra 2026.

Informácie o práci s Ailoot sú dostupné v dokumentácii.

Čo je WhatsApp Business Tools MCP?#

MCP (Model Context Protocol) je otvorený štandard na pripájanie externých systémov k AI agentom. Viac sa o ňom dozviete v článku Servery MCP pre Claude Code: 7 hotových integrácií. Overené pripojenia s inštalačnými príkazmi nájdete v katalógu MCP.

Pred týmto vydaním vyzeralo nastavenie integrácie WhatsApp takto: otvoriť Developer Console, vytvoriť aplikáciu, prepojiť firmu, pridať telefónne číslo, overiť ho kódom, vygenerovať token, nakonfigurovať webhook, skontrolovať dokumentáciu API—a až potom napísať prvý riadok kódu.

Spoločnosť Meta opisuje myšlienku servera takto (preklad z angličtiny):

Meta má teraz dva servery MCP a ľahko si ich možno pomýliť. Meta Social Technologies MCP je univerzálny vývojársky nástroj: vyhľadávanie v dokumentácii, zisťovanie endpointov Graph API a diagnostika chýb aplikácie. WhatsApp Business Tools MCP slúži na prácu s účtami WhatsApp, telefónnymi číslami, šablónami, webhookmi a testovacími správami. Dopĺňajú sa a v prípade potreby môžete pripojiť oba.

Čo presne dokáže agent po pripojení?#

Nástroje servera sú zoskupené pod prefixom whatsapp_biz_. Podľa oficiálnej dokumentácie:

• Prehľad: whatsapp_biz_businesses, whatsapp_biz_accounts, whatsapp_biz_phone_numbers—ktoré firmy, účty a telefónne čísla máte k dispozícii.
• Nastavenie telefónneho čísla: whatsapp_biz_add_phone_number, whatsapp_biz_send_verification_code, whatsapp_biz_verify_phone_number, whatsapp_biz_register_phone_number.
• Šablóny: whatsapp_biz_list_templates, whatsapp_biz_get_template, whatsapp_biz_create_template, whatsapp_biz_update_template, whatsapp_biz_delete_template.
• Správy: whatsapp_biz_send_message—voľný text počas 24-hodinového okna konverzácie alebo schválená šablóna mimo neho; agent pred odoslaním s vami potvrdí príjemcu.
• Webhooky: whatsapp_biz_configure_webhooks, whatsapp_biz_subscribe_webhook.
• Nastavenie účtu: whatsapp_biz_configure_payments, whatsapp_biz_verify_business, whatsapp_biz_system_user_token—odkaz na vytvorenie tokenu systémového používateľa pre priame volania Cloud API.

Keď zákazník pošle firme správu ako prvý, otvorí sa okno zákazníckeho servisu: 24 hodín môžete odpovedať voľným textom. Každá nová správa zákazníka okno predĺži. Po jeho zatvorení môžete zákazníka kontaktovať iba schválenou šablónou. Agent toto pravidlo pozná a ak sa príjemca nachádza mimo okna, navrhne namiesto bežného textu odoslanie šablóny.

Server má zabudované riadenie prístupu. Prihlásite sa prostredníctvom svojho účtu Meta a vyberiete konkrétne firmy; tokeny sa nezahŕňajú do histórie konverzácie. Každé čítanie sa vykonáva vo vašom kontexte, volania sa zaznamenávajú a akcie, ktoré vykonávajú zmeny, vyžadujú overenú osobu; samotný kľúč aplikácie servera nestačí.

Čo treba skontrolovať pred pripojením?#

Server koná vo vašom mene a pracuje iba s vašimi zdrojmi, preto pred prvým volaním skontrolujte nasledujúce:

1. Máte firmu Meta, v ktorej ste správcom (rola MANAGE).
2. Máte aplikáciu Meta so zapnutým scenárom WhatsApp Business Messaging (alebo produktom WhatsApp v starších aplikáciách) a ste správcom práve tejto aplikácie; samotné oprávnenia na úrovni firmy nestačia.
3. Firma prijala podmienky WhatsApp Business Cloud API—bez toho je registrácia telefónneho čísla a odosielanie zablokované.

Podľa spoločnosti Meta sa problémy s podmienkami používania, spôsobmi platby a overením firmy často objavujú bez jasného vysvetlenia. Agent ich vopred skontroluje a poskytne priamy odkaz, na ktorom môžete prijať podmienky, zadať spôsob platby alebo začať overovanie firmy.

Ako pripojiť server ku Claude Code?#

Ak ste si Claude Code ešte nenainštalovali, začnite sprievodcom Ako nainštalovať Claude Code z oficiálnej webovej stránky.

1. Pridajte server

   V termináli spustite:

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

   Server je vzdialený, takže ho nemusíte inštalovať lokálne.

2. Prihláste sa cez Meta

   V relácii Claude Code zadajte /mcp a vyberte whatsapp_business_tools. Otvorí sa okno prehliadača na prihlásenie do vášho účtu Meta. Ak sa prehliadač neotvorí, skopírujte odkaz z klienta a otvorte ho manuálne.

3. Udeľte oprávnenia

   Na obrazovke súhlasu vyberte firmy a aplikácie s WhatsApp, ku ktorým povoľujete prístup. Server si vyžiada tri oprávnenia: business_management (vyhľadávanie firiem, v ktorých ste správcom), whatsapp_business_management (účty, telefónne čísla, šablóny, webhooky) a whatsapp_business_messaging (odosielanie správ z vašich čísel).

4. Skontrolujte pripojenie

   Reštartujte Claude Code, znova sa prihláste cez /mcp a opýtajte sa agenta, ktoré nástroje vidí na serveri whatsapp_business_tools. Potom vykonajte bezpečné čítanie: „Vypíš firmy, ktoré môžem spravovať“—agent zavolá whatsapp_biz_businesses. Ak sa nezobrazia žiadne nástroje alebo sa vyskytne chyba prihlásenia, skontrolujte adresu servera a prihláste sa znova.

Prihlásenie OAuth je naviazané na spustenie klienta: po reštartovaní Claude Code sa musíte znova prihlásiť. Prístup môžete kedykoľvek odvolať v nastaveniach na facebook.com v časti „Business Integrations“.

Ako pripojiť Codex, ChatGPT a Claude Desktop?#

Codex App. Otvorte nastavenia (ozubené koliesko vľavo dole), prejdite na MCP Servers a vyberte Add servers. Zvoľte Streamable HTTP a zadajte:

• Názov: WhatsApp Business Tools
• URL: https://mcp.facebook.com/whatsapp_business_tools
• Overenie: OAuth

Kliknite na Authenticate a v prehliadači sa prihláste.

ChatGPT. Settings, Plugins, Browse plugins, ikona „+“ v pravom hornom rohu. Zadajte názov, rovnakú URL a ako typ overenia vyberte OAuth.

Claude Desktop. Settings, Connectors, Add custom connector. Názov: WhatsApp Business Tools; URL: rovnaká adresa servera.

Po pridaní v ktoromkoľvek klientovi postupujte podľa rovnakej kontroly: reštartujte ho, znova sa prihláste, zobrazte zoznam nástrojov a bezpečne načítajte zoznam firiem.

Čo sa stane počas prvej relácie: od zoznamu firiem po testovaciu správu?#

Typická prvá relácia s pripojeným serverom:

1. „Vypíš firmy, ktoré spravujem“—agent zavolá whatsapp_biz_businesses a vy vyberiete tú, ktorú potrebujete.
2. „Ukáž mi účty WhatsApp a telefónne čísla tejto firmy“—whatsapp_biz_accounts a whatsapp_biz_phone_numbers, aj s ich stavmi.
3. „Pridaj moje testovacie telefónne číslo do účtu“—whatsapp_biz_add_phone_number.
4. „Pošli overovací kód cez SMS“—whatsapp_biz_send_verification_code. Kód príde do vášho telefónu.
5. „Over číslo pomocou kódu 123456“—whatsapp_biz_verify_phone_number, potom ho zaregistrujte pomocou whatsapp_biz_register_phone_number.
6. „Vytvor šablónu order_update v jazyku, ktorý príjemcovia uprednostňujú pri upozorneniach na objednávky“—whatsapp_biz_create_template; agent poskytne odkaz na stav jej schválenia.
7. „Pošli testovaciu správu na moje číslo“—whatsapp_biz_send_message; agent pred odoslaním potvrdí príjemcu.
8. „Nakonfiguruj webhook na adrese https://example.com/webhook“—whatsapp_biz_configure_webhooks a prihlásenie na odber pomocou whatsapp_biz_subscribe_webhook.

Potom budú prichádzajúce správy zákazníkov doručené na určenú adresu—zvyčajne ich tam načíta CRM, služba zákazníckej podpory alebo bot. Spracovanie na tejto adrese vytvárate osobitne; server rieši iba konfiguráciu.

Aké sú obmedzenia beta verzie?#

Treba mať na pamäti štyri obmedzenia servera.

Stav beta. Meta uvádza, že rozhranie a súbor nástrojov sa môžu zmeniť a prístup sa sprístupňuje postupne. Ak sa k serveru zatiaľ nemôžete pripojiť, možno vám ešte nebol sprístupnený.

Účel. Vydanie je určené na vývoj a testovanie; nie je určené na hromadné odosielanie v produkcii. Na produkčné posielanie správ budete potrebovať úplnú integráciu s Cloud API—napríklad pomocou tokenu systémového používateľa, ktorého odkaz na vytvorenie poskytuje nástroj whatsapp_biz_system_user_token.

Limity. Počet požiadaviek na každý nástroj je obmedzený pre každého používateľa. Ak limit prekročíte, nástroj vráti chybu limitu—počkajte a skúste to znova.

Pravidlo 24-hodinového okna. Mimo okna konverzácie so zákazníkom môžete posielať iba schválené šablóny.

Prečo je to dôležité pre firmu?#

Typický scenár pre malú firmu: zákazníci píšu cez WhatsApp a vy im chcete rýchlo odpovedať a posielať upozornenia na stav objednávky. Predtým úvodné nastavenie znamenalo samostatnú prácu vo viacerých ovládacích paneloch Meta alebo najatie vývojára. Teraz môžete túto časť dokončiť v konverzácii s agentom. Spracovanie prichádzajúcich správ na vlastnej adrese stále nastavujete osobitne—je to ďalšia úloha po konfigurácii webhooku.

Server je užitočný aj vtedy, keď vaša integrácia už funguje. Šablóny správ treba pravidelne aktualizovať: nová akcia, nový text upozornenia. Prostredníctvom servera agent vytvorí alebo upraví šablónu a zobrazí jej stav schválenia bez toho, aby vás posielal na ovládací panel.

Podobný prístup—agent sa pripojí k externému systému a pracuje s ním na základe vášho opisu—je spolu s dokumentáciou predstavený v sprievodcovi Ako pripojiť NotebookLM ku Claude Code cez MCP.

Čo ďalej?#

Od oznámenia servera uplynuli tri dni. Môžete začať jediným príkazom a prihlásiť sa cez Meta, potom požiadať agenta o zoznam svojich firiem. Ďalej podľa vašich potrieb: telefónne čísla, šablóny, webhooky, testovacie správy.

Ďalšie spôsoby pripojenia agenta k externým systémom nájdete v zbierke Servery MCP pre Claude Code—obsahuje ešte sedem funkčných integrácií na rôzne úlohy.

Spoznajte Ailoot.