WhatsApp Business Tools MCP: WhatsApp Business-ті AI агентіне қалай қосуға болады

2026 жылғы 15 қыркүйекте Meta ресми WhatsApp Business Tools MCP серверін шығарды. Ол AI агентін — Claude Code, Codex, ChatGPT немесе Cursor-ды — WhatsApp Business Platform платформасына қосады. Developer Console, Business Manager және API құжаттамасының арасында ауысудың орнына, тапсырманы агентке сипаттайсыз, ал ол нөмір қосады, хабарлама үлгісін жасайды, вебхуктарды баптайды және сынақ хабарламасын жібереді.

Сервер әлі бета нұсқасында: қолжетімділік біртіндеп ашылып жатыр, ал шығарылым жаппай өндірістік хабар алмасуға емес, әзірлеу мен сынаққа арналған. Төменде төрт клиентке арналған дайындық және қосылу қадамдары берілген. Командалар мен баптаулар Meta-ның ресми құжаттамасына сүйеніп, 2026 жылғы 18 қыркүйекте тексерілді.

Ailoot-пен жұмыс істеу туралы ақпарат құжаттамада берілген.

WhatsApp Business Tools MCP дегеніміз не?#

MCP (Model Context Protocol) — сыртқы жүйелерді AI агенттеріне қосуға арналған ашық стандарт. Ол туралы толығырақ Claude Code-қа арналған MCP серверлері: дайын 7 интеграция мақаласынан оқыңыз. Орнату командалары бар тексерілген қосылымдар MCP каталогында берілген.

Бұл шығарылымға дейін WhatsApp интеграциясын баптау былай жүретін: Developer Console ашу, қолданба жасау, бизнеске байланыстыру, телефон нөмірін қосу, оны кодпен растау, токен жасау, вебхукты баптау, API құжаттамасын тексеру — содан кейін ғана кодтың бірінші жолын жазу.

Meta сервердің идеясын былай сипаттайды (ағылшын тілінен аударылған):

Қазір Meta-да екі MCP сервері бар, сондықтан оларды шатастыру оңай. Meta Social Technologies MCP — құжаттамадан іздеу, Graph API соңғы нүктелерін табу және қолданба қателерін диагностикалау сияқты жалпы мақсаттағы әзірлеуші құралы. WhatsApp Business Tools MCP WhatsApp аккаунттарымен, телефон нөмірлерімен, үлгілермен, вебхуктармен және сынақ хабарламаларымен жұмыс істеуге арналған. Олар бірін-бірі толықтырады, қажет болса екеуін де қосуға болады.

Қосылғаннан кейін агент нақты не істей алады?#

Сервер құралдары whatsapp_biz_ префиксімен топтастырылған. Ресми құжаттамаға сәйкес:

• Шолу: whatsapp_biz_businesses, whatsapp_biz_accounts, whatsapp_biz_phone_numbers — сізге қолжетімді бизнестер, аккаунттар және телефон нөмірлері.
• Телефон нөмірін баптау: whatsapp_biz_add_phone_number, whatsapp_biz_send_verification_code, whatsapp_biz_verify_phone_number, whatsapp_biz_register_phone_number.
• Үлгілер: whatsapp_biz_list_templates, whatsapp_biz_get_template, whatsapp_biz_create_template, whatsapp_biz_update_template, whatsapp_biz_delete_template.
• Хабарламалар: whatsapp_biz_send_message — 24 сағаттық әңгімелесу терезесі ішінде еркін мәтін немесе одан тыс уақытта мақұлданған үлгі; агент жібермес бұрын алушыны сізбен бірге растайды.
• Вебхуктар: whatsapp_biz_configure_webhooks, whatsapp_biz_subscribe_webhook.
• Аккаунтты баптау: whatsapp_biz_configure_payments, whatsapp_biz_verify_business, whatsapp_biz_system_user_token — тікелей Cloud API шақыруларына арналған жүйелік пайдаланушы токенін жасау сілтемесі.

Клиент бизнеске бірінші болып хабарлама жібергенде, клиентке қызмет көрсету терезесі ашылады: 24 сағат бойы еркін мәтінмен жауап бере аласыз. Клиенттің әрбір жаңа хабарламасы терезе мерзімін ұзартады. Терезе жабылған соң, клиентке тек мақұлданған үлгімен хабарласа аласыз. Агент бұл ережені біледі және алушы терезеден тыс болса, кәдімгі мәтіннің орнына үлгі жіберуді ұсынады.

Серверде қолжетімділікті басқару мүмкіндіктері бар. Meta аккаунтыңыз арқылы кіріп, нақты бизнестерді таңдайсыз; токендер әңгіме тарихына қосылмайды. Әр оқу әрекеті сіздің контекстіңізде орындалады, шақырулар журналға жазылады, ал өзгеріс енгізетін әрекеттер үшін жүйеге кірген адам қажет; сервер қолданбасының кілті жалғыз өзі жеткіліксіз.

Қосылмас бұрын нені тексеру керек?#

Сервер сіздің атыңыздан әрекет етеді және тек өз ресурстарыңызбен жұмыс істейді, сондықтан бірінші шақыру алдында мыналарды тексеріңіз:

1. Әкімші (MANAGE рөлі) болып табылатын Meta бизнесіңіз бар.
2. WhatsApp Business Messaging сценарийі қосылған Meta қолданбаңыз (немесе ескі қолданбаларда WhatsApp өнімі) бар және дәл сол қолданбада әкімшісіз; тек бизнес деңгейіндегі рұқсаттар жеткіліксіз.
3. Бизнес үшін WhatsApp Business Cloud API шарттары қабылданған — бұларсыз телефон нөмірін тіркеу және хабарлама жіберу бұғатталады.

Meta мәліметінше, пайдалану шарттарына, төлем әдістеріне және бизнесті растауға қатысты мәселелер көбіне анық түсіндірмесіз туындайды. Агент оларды алдын ала тексеріп, шарттарды қабылдауға, төлем әдісін көрсетуге немесе бизнесті растауды бастауға болатын тікелей сілтеме береді.

Серверді Claude Code-қа қалай қосуға болады?#

Егер Claude Code әлі орнатылмаған болса, Claude Code-ты ресми сайттан қалай орнатуға болады нұсқаулығынан бастаңыз.

1. Серверді қосыңыз

   Терминалда мына команданы орындаңыз:

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

   Сервер қашықта орналасқан, сондықтан оны жергілікті түрде орнатудың қажеті жоқ.

2. Meta арқылы кіріңіз

   Claude Code сессиясында /mcp деп теріп, whatsapp_business_tools таңдаңыз. Meta аккаунтыңызға кіру үшін браузер терезесі ашылады. Браузер ашылмаса, клиенттен сілтемені көшіріп алып, қолмен ашыңыз.

3. Рұқсат беріңіз

   Келісім экранында қол жеткізуге рұқсат беретін WhatsApp-ы бар бизнестер мен қолданбаларды таңдаңыз. Сервер үш рұқсат сұрайды: business_management (әкімшісі болып табылатын бизнестерді табу), whatsapp_business_management (аккаунттар, телефон нөмірлері, үлгілер, вебхуктар) және whatsapp_business_messaging (нөмірлеріңізден хабарлама жіберу).

4. Қосылымды тексеріңіз

   Claude Code-ты қайта іске қосып, /mcp арқылы қайта кіріңіз де, агенттен whatsapp_business_tools серверінде қандай құралдарды көре алатынын сұраңыз. Содан кейін қауіпсіз оқу әрекетін орындаңыз: “Мен басқара алатын бизнестерді тізімде”—агент whatsapp_biz_businesses құралын шақырады. Құралдар болмаса немесе жүйеге кіру қатесін алсаңыз, сервер мекенжайын тексеріп, қайта кіріңіз.

OAuth арқылы кіру клиенттің іске қосылуына байланысты: Claude Code қайта іске қосылғаннан кейін қайта кіру қажет. Қолжетімділікті facebook.com сайтындағы баптаулардан, “Business Integrations” бөлімінде кез келген уақытта қайтарып алуға болады.

Codex, ChatGPT және Claude Desktop-ты қалай қосуға болады?#

Codex App. Баптауларды ашыңыз (төменгі сол жақтағы тісті дөңгелек), MCP Servers бөліміне өтіп, Add servers таңдаңыз. Streamable HTTP таңдап, мыналарды енгізіңіз:

• Name: WhatsApp Business Tools
• URL: https://mcp.facebook.com/whatsapp_business_tools
• Authentication: OAuth

Authenticate түймесін басып, браузерде жүйеге кіріңіз.

ChatGPT. Settings, Plugins, Browse plugins бөліміне өтіп, жоғарғы оң жақтағы “+” белгішесін басыңыз. Атауын, сол URL мекенжайын және аутентификация түрі ретінде OAuth енгізіңіз.

Claude Desktop. Settings, Connectors, Add custom connector тармағын таңдаңыз. Атауы: WhatsApp Business Tools; URL: сол сервер мекенжайы.

Кез келген клиентке қосқаннан кейін бірдей тексеру ретін орындаңыз: қайта іске қосу, қайта кіру, құралдар тізімін көру және бизнестер тізімін қауіпсіз оқу.

Алғашқы сессияда не болады: бизнес тізімінен сынақ хабарламасына дейін?#

Қосылған сервермен алғашқы сессия әдетте былай өтеді:

1. “Мен басқаратын бизнестерді тізімде”—агент whatsapp_biz_businesses құралын шақырады, ал сіз керегін таңдайсыз.
2. “Осы бизнестің WhatsApp аккаунттары мен телефон нөмірлерін көрсет”—whatsapp_biz_accounts және whatsapp_biz_phone_numbers, олардың күйлерімен бірге.
3. “Сынақ телефон нөмірімді аккаунтқа қос”—whatsapp_biz_add_phone_number.
4. “SMS арқылы растау кодын жібер”—whatsapp_biz_send_verification_code. Код телефоныңызға келеді.
5. “Нөмірді 123456 кодымен раста”—whatsapp_biz_verify_phone_number, содан кейін оны whatsapp_biz_register_phone_number арқылы тіркеу.
6. “Тапсырыс хабарландыруларына алушылар қалайтын тілде order_update үлгісін жаса”—whatsapp_biz_create_template; агент мақұлдау күйіне апаратын сілтеме береді.
7. “Нөміріме сынақ хабарламасын жібер”—whatsapp_biz_send_message; агент жібермес бұрын алушыны растайды.
8. “https://example.com/webhook мекенжайында вебхукті бапта”—whatsapp_biz_configure_webhooks және whatsapp_biz_subscribe_webhook арқылы жазылу.

Осыдан кейін клиенттердің кіріс хабарламалары көрсетілген мекенжайға келеді — әдетте CRM, клиенттерді қолдау қызметі немесе бот оларды сол жерден алады. Хабарламаларды өңдеуді сол мекенжайда бөлек жасайсыз; сервер тек баптауды орындайды.

Бета нұсқасының қандай шектеулері бар?#

Сервердің төрт шектеуін ескеріңіз.

Бета күйі. Meta интерфейс пен құралдар жиынтығы өзгеруі мүмкін екенін және қолжетімділік біртіндеп ашылып жатқанын айтады. Серверге әлі қосыла алмасаңыз, ол сізге әлі қолжетімді болмауы мүмкін.

Мақсаты. Шығарылым әзірлеу мен сынаққа арналған; өндірісте жаппай хабарлама жіберуге арналмаған. Өндірістік хабар алмасу үшін Cloud API-мен толық интеграция қажет болады — мысалы, жүйелік пайдаланушы токенін пайдалану; оған сілтемені whatsapp_biz_system_user_token құралы береді.

Лимиттер. Әр құрал бойынша бір пайдаланушының сұраулары шектелген. Лимиттен ассаңыз, құрал лимит қатесін қайтарады — күтіп, қайта көріңіз.

24 сағаттық терезе ережесі. Клиентпен әңгімелесу терезесінен тыс уақытта тек мақұлданған үлгілерді жібере аласыз.

Бұл бизнес үшін неліктен маңызды?#

Шағын бизнеске тән жағдай: клиенттер WhatsApp арқылы жазады, ал сіз оларға жылдам жауап беріп, тапсырыс күйі туралы хабарландыру жібергіңіз келеді. Бұрын бастапқы баптауды бірнеше Meta басқару тақтасында өзіңіз орындауға немесе әзірлеуші жалдауға тура келетін. Енді бұл бөлікті агентпен әңгімелесу барысында аяқтай аласыз. Кіріс хабарламаларды өңдеуді өз мекенжайыңызда бәрібір бөлек жасайсыз — вебхукті баптағаннан кейінгі келесі тапсырма осы.

Интеграцияңыз әлдеқашан жұмыс істеп тұрса да, сервер пайдалы. Хабарлама үлгілерін үнемі жаңартып отыру керек: жаңа акция, хабарландырудың жаңа мәтіні. Сервер арқылы агент үлгіні жасайды немесе өңдейді және басқару тақтасына жібермей-ақ оның мақұлдау күйін көрсетеді.

Агенттің сыртқы жүйеге қосылып, оны сіздің сипаттамаңыз бойынша пайдалануы осыған ұқсас тәсілді NotebookLM-ді Claude Code-қа MCP арқылы қалай қосуға болады нұсқаулығында құжаттамамен бірге көрсетеді.

Әрі қарай не істеу керек?#

Сервердің таныстырылғанына үш күн болды. Бір командамен бастап, Meta арқылы жүйеге кіріп, агенттен бизнестеріңіздің тізімін сұрай аласыз. Одан кейін қажеттілігіңізге қарай: телефон нөмірлері, үлгілер, вебхуктар, сынақ хабарламалары.

Агентті сыртқы жүйелерге қосудың басқа жолдары Claude Code-қа арналған MCP серверлері жинағында берілген — онда әртүрлі тапсырмаларға арналған тағы жеті жұмыс істейтін интеграция бар.

Ailoot туралы біліңіз.