WhatsApp Business Tools MCP: kaip prijungti WhatsApp Business prie AI agento
MarkdownOficialus „Meta“ MCP serveris, skirtas „WhatsApp Business“: ką gali agentas, prisijungimo komanda „Claude Code“, nustatymas „Codex“ ir „ChatGPT“ bei beta versijos apribojimai.
Skaityti visą straipsnį
2026 m. rugsėjo 15 d. „Meta“ išleido oficialų „WhatsApp Business Tools MCP“ serverį. Jis prijungia AI agentą—„Claude Code“, „Codex“, „ChatGPT“ arba „Cursor“—prie „WhatsApp Business“ platformos. Užuot perėję iš „Developer Console“ į „Business Manager“ ir API dokumentaciją, aprašote užduotį agentui, o jis prideda numerį, sukuria pranešimo šabloną, sukonfigūruoja webhook’us ir išsiunčia bandomąjį pranešimą.
Serveris vis dar yra beta versijos: prieiga suteikiama palaipsniui, o leidimas skirtas kūrimui ir bandymams, ne didelio masto gamybiniam susirašinėjimui. Toliau aprašyti keturių klientų paruošimo ir prijungimo veiksmai. Komandos ir nustatymai patikrinti pagal oficialią „Meta“ dokumentaciją 2026 m. rugsėjo 18 d.
Informacijos apie darbą su „Ailoot“ rasite dokumentacijoje.
Kas yra „WhatsApp Business Tools MCP“?
Pagrindiniai punktai
Tai oficialus nuotolinis „Meta“ MCP serveris, suteikiantis AI agentui įrankius „WhatsApp Business“ platformai valdyti: paskyroms, telefono numeriams, pranešimų šablonams, webhook’ams ir bandomųjų pranešimų siuntimui. Prieiga suteikiama per OAuth: prisijungiate naudodami savo „Meta“ paskyrą ir pasirenkate įmones, su kuriomis serveriui leidžiate dirbti.
MCP (Model Context Protocol) yra atviras standartas, skirtas išorinėms sistemoms prijungti prie AI agentų. Daugiau apie jį skaitykite straipsnyje MCP serveriai „Claude Code“: 7 paruoštos integracijos. Patikrintus ryšius su diegimo komandomis rasite MCP kataloge.
Iki šio leidimo „WhatsApp“ integracijos nustatymas atrodė taip: atidaryti „Developer Console“, sukurti programėlę, susieti įmonę, pridėti telefono numerį, patvirtinti jį kodu, sugeneruoti prieigos raktą, sukonfigūruoti webhook’ą, peržiūrėti API dokumentaciją—ir tik tada parašyti pirmąją kodo eilutę.
„Meta“ serverio idėją apibūdina taip (išversta iš anglų kalbos):
Aprašote, ko jums reikia, o agentas pats išsiaiškina, kokios paskyros, telefono numeriai, šablonai ir API iškvietimai reikalingi.
Dabar „Meta“ turi du MCP serverius, kuriuos lengva supainioti. „Meta Social Technologies MCP“ yra universali kūrėjų priemonė: dokumentacijos paieška, „Graph API“ endpoint’ų paieška ir programėlių klaidų diagnostika. „WhatsApp Business Tools MCP“ skirtas darbui su „WhatsApp“ paskyromis, telefono numeriais, šablonais, webhook’ais ir bandomaisiais pranešimais. Jie papildo vienas kitą, todėl prireikus galite prijungti abu.
Ką tiksliai gali daryti agentas prisijungus?
Pagrindiniai punktai
Serveris palaiko keturias užduočių grupes. Telefono numerio nustatymas nuo pradžių: pridėjimas, patvirtinimo kodo siuntimas, numerio patvirtinimas ir registravimas. Pranešimų šablonai: jų kūrimas, redagavimas ir patvirtinimo būsenos tikrinimas. Webhook’ai: atgalinio iškvietimo URL nurodymas ir laukų prenumerata. Būtinųjų sąlygų patikra: agentas aptinka, kai sąlygos nepriimtos arba nenustatytas mokėjimas, ir pateikia tiesioginę nuorodą problemai išspręsti.
Serverio įrankiai grupuojami su prefiksu whatsapp_biz_. Pagal oficialią dokumentaciją:
- Apžvalga:
whatsapp_biz_businesses,whatsapp_biz_accounts,whatsapp_biz_phone_numbers—kokios įmonės, paskyros ir telefono numeriai jums prieinami. - Telefono numerio nustatymas:
whatsapp_biz_add_phone_number,whatsapp_biz_send_verification_code,whatsapp_biz_verify_phone_number,whatsapp_biz_register_phone_number. - Šablonai:
whatsapp_biz_list_templates,whatsapp_biz_get_template,whatsapp_biz_create_template,whatsapp_biz_update_template,whatsapp_biz_delete_template. - Pranešimai:
whatsapp_biz_send_message—laisvos formos tekstas per 24 valandų pokalbio langą arba patvirtintas šablonas už jo ribų; prieš siųsdamas agentas su jumis patvirtina gavėją. - Webhook’ai:
whatsapp_biz_configure_webhooks,whatsapp_biz_subscribe_webhook. - Paskyros nustatymas:
whatsapp_biz_configure_payments,whatsapp_biz_verify_business,whatsapp_biz_system_user_token—nuoroda, skirta sistemos naudotojo prieigos raktui sukurti tiesioginiams „Cloud API“ iškvietimams.
Kai klientas pirmas parašo įmonei, atidaromas klientų aptarnavimo langas: 24 valandas galite atsakyti laisvos formos tekstu. Kiekvienas naujas kliento pranešimas pratęsia šį langą. Jam užsidarius, su klientu galite susisiekti tik naudodami patvirtintą šabloną. Agentas žino šią taisyklę ir, jei gavėjas yra už lango ribų, pasiūlys siųsti šabloną, o ne įprastą tekstą.
Serveryje integruoti prieigos valdikliai. Prisijungiate naudodami „Meta“ paskyrą ir pasirenkate konkrečias įmones; prieigos raktai neįtraukiami į pokalbių istoriją. Kiekvienas skaitymo veiksmas atliekamas jūsų kontekste, iškvietimai registruojami, o pakeitimus atliekantiems veiksmams būtinas autentifikuotas asmuo; vien serverio programėlės rakto nepakanka.
Ką reikėtų patikrinti prieš jungiant?
Pagrindiniai punktai
Trys būtinos sąlygos: MANAGE vaidmuo „Meta“ versle, kurį norite valdyti; administratoriaus teisės programėlėje, kurioje įjungtas „WhatsApp“ scenarijus; ir sutikimas su „WhatsApp Business Cloud API“ sąlygomis. Jei ko nors trūksta, įrankis pateikia klaidą, paaiškinančią problemą, ir nuorodą į puslapį, kuriame ją galite išspręsti.
Serveris veikia jūsų vardu ir naudoja tik jūsų išteklius, todėl prieš pirmąjį iškvietimą patikrinkite, ar:
- Turite „Meta“ verslą, kuriame esate administratorius (MANAGE vaidmuo).
- Turite „Meta“ programėlę, kurioje įjungtas „WhatsApp Business Messaging“ scenarijus (arba „WhatsApp“ produktas senesnėse programėlėse), ir esate būtent tos programėlės administratorius; vien verslo lygmens leidimų nepakanka.
- Verslui priimtos „WhatsApp Business Cloud API“ sąlygos—be jų telefono numerio registravimas ir siuntimas yra blokuojami.
Pasak „Meta“, su naudojimo sąlygomis, mokėjimo būdais ir verslo patvirtinimu susijusių problemų dažnai kyla be aiškaus paaiškinimo. Agentas jas iš anksto patikrina ir pateikia tiesioginę nuorodą, kurioje galite priimti sąlygas, nurodyti mokėjimo būdą arba pradėti verslo patvirtinimą.
Kaip prijungti serverį prie „Claude Code“?
Pagrindiniai punktai
Paleiskite komandą claude mcp add --transport http whatsapp_business_tools https://mcp.facebook.com/whatsapp_business_tools, tada sesijoje įveskite /mcp, pasirinkite serverį ir prisijunkite per „Meta“. Paleidus klientą iš naujo, reikės prisijungti dar kartą.
Jei dar neįdiegėte „Claude Code“, pradėkite nuo vadovo Kaip įdiegti „Claude Code“ iš oficialios svetainės.
Pridėkite serverį
Terminale paleiskite:
claude mcp add --transport http whatsapp_business_tools https://mcp.facebook.com/whatsapp_business_toolsServeris yra nuotolinis, todėl jo nereikia įdiegti vietoje.
Prisijunkite per „Meta“
„Claude Code“ sesijoje įveskite
/mcpir pasirinkitewhatsapp_business_tools. Atsidarys naršyklės langas, kuriame galėsite prisijungti prie savo „Meta“ paskyros. Jei naršyklė neatsidaro, nukopijuokite nuorodą iš kliento ir atidarykite ją rankiniu būdu.Suteikite leidimus
Sutikimo ekrane pasirinkite įmones ir „WhatsApp“ programėles, kurioms leidžiate prieigą. Serveris paprašys trijų leidimų:
business_management(rasti įmones, kuriose esate administratorius),whatsapp_business_management(paskyros, telefono numeriai, šablonai, webhook’ai) irwhatsapp_business_messaging(siųsti pranešimus iš jūsų numerių).Patikrinkite ryšį
Paleiskite „Claude Code“ iš naujo, vėl prisijunkite per
/mcpir paklauskite agento, kokius įrankius jis mato serveryjewhatsapp_business_tools. Tada atlikite saugų skaitymo veiksmą: „Išvardyk įmones, kurias galiu valdyti“—agentas iškvieswhatsapp_biz_businesses. Jei įrankių nėra arba gaunate prisijungimo klaidą, patikrinkite serverio adresą ir prisijunkite iš naujo.
OAuth prisijungimas susietas su kliento paleidimu: paleidę „Claude Code“ iš naujo, turite prisijungti dar kartą. Prieigą galite bet kada atšaukti facebook.com nustatymuose, skiltyje „Business Integrations“.
Kaip prijungti „Codex“, „ChatGPT“ ir „Claude Desktop“?
Pagrindiniai punktai
Visi trys naudoja tą patį serverio adresą ir OAuth prisijungimą; skiriasi tik vieta nustatymuose. „Codex App“: „Settings“, „MCP Servers“, pridėkite „Streamable HTTP“ serverį. „ChatGPT“: „Settings“, „Plugins“, pridėkite pagal URL. „Claude Desktop“: „Settings“, „Connectors“, pasirinktinė jungtis.
„Codex App“. Atidarykite nustatymus (krumpliaratį apačioje kairėje), eikite į „MCP Servers“ ir pasirinkite „Add servers“. Pasirinkite „Streamable HTTP“ ir įveskite:
- Pavadinimas:
WhatsApp Business Tools - URL:
https://mcp.facebook.com/whatsapp_business_tools - Autentifikavimas: OAuth
Spustelėkite „Authenticate“ ir prisijunkite naršyklėje.
„ChatGPT“. „Settings“, „Plugins“, „Browse plugins“, piktograma „+“ viršutiniame dešiniajame kampe. Įveskite pavadinimą, tą patį URL ir pasirinkite OAuth kaip autentifikavimo tipą.
„Claude Desktop“. „Settings“, „Connectors“, „Add custom connector“. Pavadinimas: WhatsApp Business Tools; URL: tas pats serverio adresas.
Pridėję jį bet kuriame kliente, atlikite tą pačią patikrą: paleiskite klientą iš naujo, prisijunkite dar kartą, peržiūrėkite įrankių sąrašą ir saugiai perskaitykite įmonių sąrašą.
Kas vyksta per pirmąją sesiją: nuo įmonių sąrašo iki bandomojo pranešimo?
Pagrindiniai punktai
Veiksmų seka: parodyti įmones, pasirinkti vieną, peržiūrėti jos paskyras ir telefono numerius, pridėti telefono numerį, SMS žinute arba skambučiu išsiųsti patvirtinimo kodą, patvirtinti numerį kodu, jį užregistruoti, sukurti šabloną, išsiųsti bandomąjį pranešimą ir sukonfigūruoti webhook’ą. SMS kodą agentui pateikiate patys.
Įprasta pirmoji sesija su prijungtu serveriu:
- „Išvardyk įmones, kurias valdau“—agentas iškviečia
whatsapp_biz_businesses, o jūs pasirenkate reikiamą įmonę. - „Parodyk šios įmonės „WhatsApp“ paskyras ir telefono numerius“—
whatsapp_biz_accountsirwhatsapp_biz_phone_numberskartu su jų būsenomis. - „Pridėk mano bandomąjį telefono numerį prie paskyros“—
whatsapp_biz_add_phone_number. - „Išsiųsk patvirtinimo kodą SMS žinute“—
whatsapp_biz_send_verification_code. Kodas atkeliauja į jūsų telefoną. - „Patvirtink numerį kodu 123456“—
whatsapp_biz_verify_phone_number, tada užregistruokite jį naudodamiwhatsapp_biz_register_phone_number. - „Sukurk
order_updatešabloną gavėjų pageidaujama kalba, skirtą užsakymų pranešimams“—whatsapp_biz_create_template; agentas pateiks nuorodą į jo patvirtinimo būseną. - „Išsiųsk bandomąjį pranešimą į mano numerį“—
whatsapp_biz_send_message; prieš siųsdamas agentas patvirtins gavėją. - „Sukonfigūruok webhook’ą adresu https://example.com/webhook“—
whatsapp_biz_configure_webhooksir prenumerata naudojantwhatsapp_biz_subscribe_webhook.
Tada įeinantys klientų pranešimai pasieks nurodytą adresą—paprastai juos ten gauna CRM, klientų aptarnavimo tarnyba arba botas. Pranešimų apdorojimą tuo adresu kuriate atskirai; serveris rūpinasi tik konfigūracija.
Kokie beta versijos apribojimai?
Pagrindiniai punktai
Serveris yra beta versijos: įrankių rinkinys gali keistis, o prieiga suteikiama palaipsniui, ne visiems iš karto. Leidimas skirtas kūrimui ir bandymams; jis netinka didelio masto gamybiniam susirašinėjimui. Kiekvienam įrankiui taikomi vienam naudotojui skirti užklausų limitai, o paleidus klientą iš naujo reikia prisijungti dar kartą.
Reikia turėti omenyje keturis serverio apribojimus.
Beta būsena. „Meta“ teigia, kad sąsaja ir įrankių rinkinys gali keistis, o prieiga suteikiama palaipsniui. Jei dar negalite prisijungti prie serverio, galbūt jis jums dar nepasiekiamas.
Paskirtis. Leidimas skirtas kūrimui ir bandymams; jis neskirtas masiniam siuntimui gamybinėje aplinkoje. Gamybiniam susirašinėjimui reikės visos integracijos su „Cloud API“—pavyzdžiui, naudojant sistemos naudotojo prieigos raktą, kurio sukūrimo nuorodą pateikia įrankis whatsapp_biz_system_user_token.
Limitai. Kiekvieno įrankio užklausų skaičius ribojamas vienam naudotojui. Viršijus limitą, įrankis grąžina limito klaidą—palaukite ir bandykite dar kartą.
24 valandų lango taisyklė. Už klientų pokalbio lango ribų galima siųsti tik patvirtintus šablonus.
Kodėl tai svarbu verslui?
Pagrindiniai punktai
Dabar pradinę „WhatsApp“ integracijos sąranką galite atlikti per vieną pokalbį su agentu: jis žino veiksmų seką ir supranta platformos klaidas. Pagrindiniai panaudojimo atvejai—klientų aptarnavimas, užsakymų ir susitikimų pranešimai bei šablonų paruošimas.
Tipinis mažos įmonės scenarijus: klientai rašo per „WhatsApp“, o jūs norite greitai atsakyti ir siųsti užsakymų būsenos pranešimus. Anksčiau pradinę sąranką reikėdavo atlikti savarankiškai keliuose „Meta“ valdymo skydeliuose arba samdyti kūrėją. Dabar šią dalį galite atlikti pokalbyje su agentu. Įeinančių pranešimų tvarkymą savo adresu vis tiek nustatote atskirai—tai kitas darbas po webhook’o konfigūravimo.
Serveris taip pat naudingas, jei jūsų integracija jau veikia. Pranešimų šablonus reikia reguliariai atnaujinti: nauja akcija, naujas pranešimo tekstas. Per serverį agentas sukuria arba redaguoja šabloną ir parodo jo patvirtinimo būseną, nenukreipdamas jūsų į valdymo skydelį.
Panašus metodas—agentas prisijungia prie išorinės sistemos ir dirba su ja pagal jūsų aprašymą—su dokumentacija pateikiamas vadove Kaip prijungti „NotebookLM“ prie „Claude Code“ per MCP.
Kas toliau?
Pagrindiniai punktai
Patikrinkite būtinas sąlygas, prijunkite serverį viena komanda, prisijunkite ir saugiai peržiūrėkite įmonių sąrašą. Tada pridėkite bandomąjį telefono numerį ir išsiųskite pirmąjį pranešimą. Nepamirškite, kad serveris yra beta versijos: gamybiniam susirašinėjimui paruoškite visą „Cloud API“ integraciją.
Nuo serverio paskelbimo praėjo trys dienos. Galite pradėti viena komanda ir prisijungti per „Meta“, tada paprašyti agento pateikti jūsų įmonių sąrašą. Toliau—atsižvelgiant į poreikius: telefono numeriai, šablonai, webhook’ai, bandomieji pranešimai.
Kitus būdus prijungti agentą prie išorinių sistemų rasite rinkinyje MCP serveriai „Claude Code“—jame yra dar septynios veikiančios integracijos įvairioms užduotims.
Šaltiniai
Susipažinkite su Ailoot.
Išsamiau
Klausimai ir atsakymai
Kokia saugiausia pirmoji ryšio patikra?
Po OAuth prisijungimo peržiūrėkite įrankių sąrašą ir perskaitykite įmones, kurias galite valdyti. Taip prieiga patikrinama prieš pridedant telefono numerį, kuriant šablonus, konfigūruojant webhook ar siunčiant bandomąją žinutę.
Ar webhook konfigūravimas kartu sukuria žinučių apdorojimą?
Ne. MCP serveris sukonfigūruoja atgalinio iškvietimo adresą ir prenumeratas, tačiau CRM, pagalbos paslaugą ar botą, kuris tuo adresu priima ir apdoroja gaunamas žinutes, turite sukurti atskirai.